atrium — Docs
docs/reference/shortcuts.md

Keyboard shortcuts

Every default keybinding, grouped by scope.

All shortcuts are customizable via Settings → Keyboard or config.keybindings in ~/.atrium/config.json. See Keybindings for the format.

Keys are shown in macOS form (Cmd = Command).

Mosaic and panes

ChordAction
Cmd+DSplit focused pane right (horizontal)
Cmd+Shift+DSplit focused pane down (vertical)
Cmd+Ctrl+TNew subtab on the focused pane
Cmd+[Focus previous pane in room
Cmd+]Focus next pane in room
Cmd+WClose focused pane
Cmd+FFind in active pane
Cmd+UpScroll to top of focused pane
Cmd+DownScroll to bottom of focused pane
Resize handles between panes have inline snap and restore buttons on hover — snap collapses a pane to the edge of its split, restore pops it back to its previous size. Useful for quickly hiding a reference pane without closing it.

Rooms (tabs)

ChordAction
Cmd+TNew room
Cmd+Shift+WClose current room
Cmd+Shift+[Previous room
Cmd+Shift+]Next room
Cmd+Shift+PPin / unpin current room

Projects and workspaces

ChordAction
Cmd+1Cmd+9Switch to a project by index (worktrees excluded)
Cmd+Ctrl+NNew Project dialog
There is no default chord for creating a workspace — use the + on the workspace rail at the bottom of the Home sidebar. / over the sidebar page between workspaces.

View and UI

ChordAction
Cmd+BExpand / collapse the Home (left) sidebar
Cmd+Shift+AExpand / collapse the right sidebar
Ctrl+BCollapse / expand the rooms sidebar
Ctrl+TFlip this project between rooms sidebar and horizontal tab bar
Cmd+Shift+1Toggle all sidebars, including the room bar
Cmd+Shift+2Toggle just the two side sidebars
` Cmd+Shift+ ``Toggle zen mode
Cmd+=Zoom in (UI scale)
Cmd+Shift+=Zoom in (alternate)
Cmd+-Zoom out
Cmd+0Reset zoom
Either sidebar can show Home, Activity, File Tree, Timeline, or Skills & Agents. The right header is the mode switcher; the left View options menu has Change view. Picking a view that's open on the other side swaps them. See Panes overview → Pane navigator.

Ctrl+B and Ctrl+T shadow readline bindings (backward-char, transpose-chars) and the tmux prefix over a focused terminal, since atrium's keybinding layer handles app combos even in terminals. Rebind them if you need those keys to reach the shell.

A toggleable Performance HUD (Settings → Diagnostics → Performance HUD) shows FPS, frame lag, IPC throughput, and live pane count — useful when reporting slowdowns or sizing up the cost of a heavy view.

Tool panes

These shortcuts focus an existing pane of that type if one is already open in the active workspace. Cmd+T followed by the tool's hotkey letter (see the launcher) opens a fresh one in a new room.

ChordAction
Cmd+Shift+GFocus or open source control
Cmd+Shift+FFocus or open search
Cmd+Shift+BFocus or open browser
Cmd+Shift+KFocus or open tasks list
Cmd+Shift+JFocus or open task detail
Cmd+Shift+NOpen the Notepad
Cmd+Ctrl+FOpen the Notepad with its sidebar showing
Cmd+Shift+LToggle the Library popover
Cmd+KOpen command palette (Omni menu)
Cmd+Shift+TOpen command palette (Omni menu, alternate)
Cmd+LToggle launcher (on focused pane)
Once the notepad is open, its sidebar has its own keyboard surface: / step rows, / collapse / expand groups, Enter opens the focused note in the active pane, Cmd+Enter opens it as a split.

QA Capture

ChordAction
Cmd+Shift+RStart a capture
Alt+PPause / resume the active capture
Alt+FDrop a chapter flag

Omni menu (command palette)

Cmd+K or Cmd+Shift+T opens the Omni menu — a single search surface across workspaces, rooms, panes, tasks, files, and commands. Arrow keys move the selection, Enter activates the match. The toolbar also carries a "Find anything…" search field (in place of the old menu button) that opens the same command palette.

  • Type a single-character prefix to jump straight to a category: ~ workspaces, @ rooms, $ panes, # tasks, / files, > commands. / cycle category tabs.
  • The top of the menu remembers your most-used commands when the query is empty.
  • A Create task quick action creates a card in the active workspace from whatever you type, so you can jot something down without leaving the keyboard.
  • Rooms show a miniature of their mosaic layout; panes show their pane-header icon; workspaces show a folder icon.
  • Cmd+Enter or Cmd+click on a file, task, or create-task row opens it as a split next to the focused pane instead of routing to a new room. Plain Enter / click keeps the new-room behavior. Workspace, room, pane, and command rows ignore the modifier (it doesn't apply to them).
Clicking a file in the sidebar file tree or a tool tile in the toolbar follows the same focus-existing rule, with symlink-aware same-file detection. Cmd+click on a file or tool opens a fresh pane regardless.

Pane popout

The popout feature detaches a pane from the mosaic into a draggable, resizable floating overlay layered above the mosaic. The pop-out button lives in every non-browser pane header; once popped out, the same header (icons, focus ring, split, search, close) follows the pane into the floating window. Expose mode shows all popped-out panes side by side so you can drag them around, and any popped pane can be docked back into the mosaic.

ChordAction
Cmd+Shift+OPop the focused pane out, or dock it back if popped
Cmd+Shift+IHide the focused popped-out pane (keeps state)
Cmd+Shift+EToggle Expose mode for all popped panes
Cmd+Shift+\\Toggle every popped pane at once
Popout state — position, size, and which panes are out — persists across restarts. Maximized panes also persist their maximized state.

Dictation

ChordAction
Cmd+Shift+MToggle dictation (hands-free mode)
Hold right OptionPush-to-talk — release to insert
The push-to-talk key is rebindable in Settings → Voice Dictation, and accepts a bare modifier or a full combo. See Voice dictation.

While dictating into any atrium text input or terminal:

  • Saying "Full stop." immediately submits (equivalent to pressing Enter).
  • Saying "Send" or "Enter" alone (no surrounding text) also submits.

Terminal panes

ChordAction
Cmd+FFind in scrollback
Cmd+CCopy selection, or SIGINT if nothing is selected
Cmd+ASelect all scrollback
Shift+EnterSend newline (for agents that treat Enter as submit)
Cmd+BackspaceKill to start of line (^U)
Cmd+LeftBeginning of line (^A)
Cmd+RightEnd of line (^E)
Ctrl+BackspaceDelete previous word (^W)
The four line-editing chords emit readline control bytes so terminals behave like Terminal.app and iTerm2. They are ignored in real form fields, so Monaco and the composer keep their native cursor behavior.

Option+click a URL in a terminal to open it in your system browser; URLs and file paths are linkified even when they wrap across lines.

Editor panes (Monaco defaults)

atrium does not override Monaco's defaults. Common shortcuts:

ChordAction
Cmd+SSave
Cmd+F / Cmd+HFind / Find and replace
Cmd+GGo to line
F12Go to definition
Shift+F12Find references
F2Rename symbol
Cmd+/Toggle line comment

Browser panes

ChordAction
Cmd+RReload
Cmd+[ / Cmd+]Back / Forward (also Cmd+Left / Cmd+Right)
Cmd+LFocus URL bar
Cmd+= / Cmd+- / Cmd+0Zoom in / out / reset (per-site)
Cmd+FFind in page
Right-click → InspectOpen Chrome DevTools

Launcher chain gestures

Double-shift hold — tap Shift once to arm, hold Shift again to activate. The launcher overlays a hotkey letter on every tile; with shift held, tap a letter to launch that adapter or pane-dock tile instantly.

Cmd-hold chain — hold Cmd, press a pane-creation shortcut, keep Cmd held, tap a launcher letter. The chain is routed through atrium's shortcut layer so it works even for keys with macOS menu roles (C for Claude Code, X for Codex). System edit shortcuts (Cmd+C, Cmd+V, Cmd+A) pass through the gesture untouched, so copy / paste / select-all in a focused text input still works while Cmd is held to activate launcher letters.

SequenceResult
Cmd+T GNew room → focus Git panel
Cmd+T NNew room → open Notepad
Cmd+T CNew room → launch Claude Code
Cmd+D CSplit right → launch Claude Code
Cmd+Shift+D XSplit down → launch Codex
Cmd+T WCloses the just-created pane (while Cmd is still held)
Pane-dock letters reserved by the launcher are T (Terminal), B (Browser), F (Search), G (Git), K (Tasks list), J (Task detail), N (Notepad). Adapters whose natural initial collides with a reserved letter get an override — Codex → X.

Text input passthrough

Keybindings of type send-text are delivered as raw PTY stdin when a terminal or xterm helper has focus. They skip atrium's keybinding processing — so Shift+Enter bound to "\n" reaches the shell rather than triggering an atrium action.