Files
Codeman/docs/wiki/Keyboard-Shortcuts.md
T
Codeman maintainer bd286bf502 docs(wiki): catch the manual up to 1.29.0 and add the three run modes it never had
The wiki was written for seven run modes and never received Grok Build, DeepSeek
Harness or OMP. They now appear everywhere the others do: the modes table and
per-CLI notes, install commands, environment prefixes, the Quick Start table, the
requirements rows, the vocabulary, and every "seven modes" count.

The 1.27 to 1.29.0 changes land on the pages that own them: attaching a case to an
existing container, multi-case adoption and the copy-a-case picker (Docker Cases);
file reads over ssh in remote cases and what stays unavailable (Remote SSH Sessions,
Working With Files, Security); single-page app routing, frame recovery, localhost
links as tabs and the egress guard (Web Tabs); DeepSeek as the one non-Claude mode
with real stop/blocked signals and Approvals items, Codex's own work detection,
last-response, the model-endpoint routes and refreshed counts (HTTP API, Driving
From An Agent, Hooks, Notifications, Keeping Agents Running, Core Concepts);
Shift+drag, right-click copy, Auto Copy, the Ctrl+Z guard, font weight, the vertical
rail and its activity sort (Keyboard Shortcuts, Input And Voice, The Dashboard,
Settings Reference); the 600px phone cutoff, Codex shift arrows and iPhone Duo
(Mobile Guide); the Docker Compose route and its update rule (Installation, Running
As A Service); four new symptom entries and a "which CLIs" question (Troubleshooting,
FAQ).

Custom model endpoints are deliberately left to #430, which adds that page and edits
Agent CLIs, Settings Reference and the sidebar; these edits stay out of the regions
#430, #428 and #376 touch, and all three still merge cleanly on top.

Both READMEs: the web-tab menu entry is labelled "Add URL" in the UI, not
"Add dashboard".

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 19:05:59 +02:00

4.2 KiB

Keyboard Shortcuts

Every binding, and how to change them. Ctrl also accepts Cmd on macOS.

Press Ctrl+? in the app for the same list in a floating overlay.

Sessions and tabs

Shortcut Action
Ctrl+K (also Cmd+K, Alt+K) Find an open session or start a new one.
Ctrl+W Kill the active session.
Ctrl+Tab Next session.
Alt+[ / Alt+] Previous / next tab.
Alt+1 to Alt+9 Switch to tab N. Physical keys, so macOS Option layouts work.
Ctrl+Shift+{ / Ctrl+Shift+} Move the active tab left / right.
Alt+B Collapse / expand the session sidebar, when that layout is on.

Terminal

Shortcut Action
Enter Send.
Shift+Enter Insert a newline without sending.
Ctrl+Enter Same.
Ctrl+C Copy the selection, or interrupt when nothing is selected.
Ctrl+Shift+C Copy the selection. Never interrupts.
Ctrl+V Paste. An image on the clipboard uploads and pastes its file path instead.
Ctrl+L Clear the terminal.
Ctrl+Shift+R Restore terminal size.
Ctrl + / Ctrl - Font size.
Shift+Wheel Scroll the local buffer, even where the wheel is forwarded to the CLI.
Shift+drag Start a selection in a pane whose mouse events go to the CLI.
Right-click Copy the selection. With nothing selected the native menu is left alone.
Ctrl+Z Swallowed in agent sessions so a running CLI cannot be suspended. Normal job control in a shell.

Everything else

Shortcut Action
Ctrl+Shift+V Toggle voice input.
Ctrl+? Shortcut reference overlay.
Escape Close panels and modals.

Rebinding

App Settings → Shortcuts. Bindings live in a registry with per-user overrides, so a rebind is stored as an override on top of the default rather than replacing the table.

Two things are deliberately not rebindable:

  • Ctrl+C smart copy. The generic dispatch loop calls preventDefault() on every shortcut it handles, and doing that to Ctrl+C would swallow the interrupt when nothing is selected. It is handled separately for that reason.
  • Escape, which closes whatever is open.

Why some chords behave oddly

The terminal sees keystrokes before the app does. Any chord the app claims has to also be swallowed at the terminal layer, or xterm writes the control byte into the session as well as triggering the action. If you rebind something to a chord the terminal cares about (Ctrl+D, say), expect the CLI to see it too.

Alt+1 through Alt+9 are matched on physical key position rather than the character produced, so macOS Option layouts that produce ¡™£ still switch tabs.

On phones

There is no physical keyboard, so the equivalents live in the keyboard accessory bar: Esc, Ctrl as a one-shot modifier, Tab, arrows, and quick actions. See Mobile Guide.