A fast, GPU-accelerated CPU pipeline trace visualizer.
Built with GPUI (Zed's rendering framework).
- Konata & µScope formats — Native support for both Konata text traces and µScope binary traces
- GPU-rendered pipeline view — Smooth panning, zooming, and scrolling at 60fps for traces with thousands of instructions
- Tabbed interface — Open multiple traces side-by-side, each with independent viewport state
- Multicursor — Place multiple cursors to measure cycle deltas between pipeline events
- Stage annotations — Hover over instructions to see annotations as tooltips
- macOS native —
.appbundle with dock icon drop support, signed and notarized
cargo run # Start with empty window
cargo run -- path/to/trace.log # Open a trace file directly
Or drag and drop trace files onto the window.
| Key | Action |
|---|---|
| Scroll / Trackpad | Pan |
| Ctrl + Scroll | Zoom in / out |
| Cmd + = / Cmd + - | Zoom in / out |
| Cmd + 0 | Zoom to fit |
| j / k | Select next / previous instruction |
| Cmd + F | Search instructions |
| Cmd + L | Go to cycle |
| Cmd + O | Open trace file |
| Cmd + R | Reload current trace |
| Cmd + G | Generate random trace |
| Cmd + W | Close tab |
| Cmd + M | Add cursor |
| Ctrl + Tab | Next tab |
| ? | Toggle help overlay |
- Konata/Kanata (
.log,.konata,.kanata) — The Kanata log format used by CPU simulators. Compatible with Konata. - µScope (
.uscope) — Binary format from µScope with CPU protocol semantics, checkpointed random access, and LZ4 compression.
See the full User Guide for detailed documentation on all features, including performance counters, minimap, timeline overlay, and configuration.
Build the documentation locally:
mdbook serve docs/
Requires Rust (macOS or Linux). See Building from Source for details.
git clone --recurse-submodules https://github.com/zarubaf/reflex.git
cd reflex
cargo build --release