Navigating the workspace
Nuclei is fully keyboard-drivable. Everything the left rail and the panels can do is reachable from the command palette, and the views you visit most have direct shortcuts. Nothing here is mode-specific unless noted — the palette simply offers the commands that apply to the workspace mode you’re in.
Command palette
Section titled “Command palette”Press ⌘⇧P (Ctrl+Shift+P on Windows/Linux) to open the palette, then type to fuzzy-match. The palette is generated from the panel registry, so it can never drift from the rail: every view a mode offers has a Go to … command, and every visualization/bottom panel has a Toggle … command. A parity test enforces this.
What you’ll find:
- Go to
<view>— open any rail view (Explorer, Experiments, Hardware, QEC Workbench, Resource Estimator, …). The first nine top-rail views also carry their ⌘1…⌘9 binding. - Switch workspace mode (Learn/Research) — ⌘⇧M. Routes through the in-flight-work guard: a running sweep or campaign asks before switching; jobs never cancel.
- Toggle
<panel>— show or hide a visualization/bottom panel (Circuit, Bloch, Histogram, Timeline, Code Lattice, Detector Graph, Terminal). - Run experiment:
<name>— start any discovered experiment by name (Research mode). - Open run folder — reveal the selected run’s directory in your OS file manager (Research mode, when a run is selected).
- Replay the Research mode tour — re-run the orientation tour any time.
Keyboard shortcuts
Section titled “Keyboard shortcuts”⌘ is Command on macOS and Control on Windows/Linux. Existing bindings always
win a collision — the navigation bindings below were added only on keys that
were free.
| Binding | Action |
|---|---|
| ⌘⇧P | Open the command palette |
| ⌘1…⌘9 | Jump to the Nth top-rail view (mode-aware) |
| ⌘⇧M | Switch workspace mode (Learn/Research). Only active when the Learning workspace is enabled in Settings; off by default |
| ⌘⇧L | Cycle UI mode (Beginner/Intermediate/Advanced) |
| ⌘⇧T | Toggle theme |
| ⌘` | Toggle the bottom panel (focuses Terminal) |
| ⌘D | Toggle the Dirac panel |
| ⌘L | Focus the Dirac input |
| ⌘I | Inline compose (Cmd+K-style) |
| ⌘↵ | Run on the simulator |
| ⌘⇧↵ | Run the analyses in the Trainability Lab (while it is open) |
| ⌘⇧R | Open the hardware Launch modal |
| ⌘O / ⌘S / ⌘⇧S / ⌘N | Open / Save / Save As / New file |
| ⌘/ | Keyboard shortcuts reference |
The left rail
Section titled “The left rail”The rail’s contents are mode-specific and computed once from the panel registry — there are no per-view feature-flag conditionals scattered through the UI. Learn mode shows Learning, Challenges, and Community; Research mode shows Experiments, the Discovery Engine, the Trainability Lab, the QEC Workbench, Hardware, the Resource Estimator, the Transpiler Explorer, and Plugins. Files, Launch, and Settings appear in both. Search and Circuit are developer-view tools, gated behind Settings → Advanced.
In the standard Research rail, Explorer is ⌘1, Experiments is ⌘2, the Discovery Engine is ⌘3, the Trainability Lab is ⌘4, and QEC Workbench is ⌘5. The registry order remains the source of truth; the rail tooltip and command palette show the active mapping.
Selecting a rail view while a full-view surface (Learn Mode, Challenge Mode) is open leaves that surface first, so a keyboard jump always lands somewhere visible.