Files
Codeman/docs/wiki/Keyboard-Shortcuts.md
T
Codeman maintainer f3cb7696f0 docs: publish docs/wiki as the user manual, with a sync workflow
30 pages covering install, concepts, the dashboard, the agent CLIs, unattended
runs, remote and Docker cases, security and the HTTP API, plus a sidebar and a
footer. The wiki repo has no CI and no review, so docs/wiki is the source of
truth and .github/workflows/wiki-sync.yml mirrors it on every push to master.

The workflow refuses to mirror when docs/wiki is missing or holds no pages,
because it deletes before it copies and would otherwise publish the deletion of
every page. The footer carries a {{VERSION}} placeholder stamped at publish
time rather than a hand-written version, which went stale on every release.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-18 16:20:43 +02:00

3.8 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+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.

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.