atriumatrium

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+[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

Workspaces

ChordAction
Cmd+1Cmd+9Switch to top-level workspace by index (worktrees excluded)
Cmd+Shift+NNew workspace dialog

View and UI

ChordAction
Cmd+BToggle main sidebar
Cmd+Shift+AToggle activity sidebar
Cmd+Shift+YToggle toolbar
` Cmd+Shift+ ``Toggle zen mode
Cmd+=Zoom in (UI scale)
Cmd+Shift+=Zoom in (alternate)
Cmd+-Zoom out
Cmd+0Reset zoom
The title bar has a toggleable Performance HUD (open it from Settings → Diagnostics → Performance HUD) showing 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+LToggle the Library popover
Cmd+Shift+TOpen command palette (Omni menu)
Cmd+LToggle launcher (on focused pane)
The Notepad pane doesn't have a top-level focus shortcut — open it via the toolbar tile, the launcher (Cmd+T N), or atrium note new --open. Once open, the 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.

Omni menu (command palette)

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.

  • 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
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)

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, V, M for Gemini). 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, Gemini → M.

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.