Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Global Keybindings

These keybindings are available in command mode (red border). They are suppressed during prompt mode, terminal mode, edit mode, and active filter inputs. See Vim-Style Modes for details on when globals are active.


Mode Switching

KeyAction
pEnter prompt mode
T (Shift+T)Toggle terminal
EscReturn to command mode

Scrolling (Per-Pane)

KeyAction
jScroll down one line
kScroll up one line
J (Shift+J)Page scroll down
K (Shift+K)Page scroll up

These are defined per-pane (FileTree, Viewer, Session, Terminal) rather than as global bindings, but they behave consistently across all scrollable panes. The scroll targets whichever pane currently has focus.


Pane Focus

KeyAction
TabCycle pane focus forward
Shift+TabCycle pane focus backward

Focus cycles through the four panes: FileTree, Viewer, Session, and Input.


Panels & Overlays

KeyAction
G (Shift+G)Open git actions panel
H (Shift+H)Open health panel
M (Shift+M)Browse main branch
P (Shift+P)Open projects panel
?Open help overlay

Panels are modal overlays that take focus when opened. Each panel defines its own keybindings for navigation within the panel (see panel-specific chapters). Press Esc to close a panel and return to command mode.


Worktree Tabs

KeyAction
[Switch to previous worktree tab
]Switch to next worktree tab

These keys cycle through the worktree tab row at the top of the interface. The active worktree determines which branch, session, and terminal are shown.


Run Commands

KeyAction
rExecute a run command
R (Shift+R)Add a new run command

Run commands are predefined shell commands (build, test, lint, etc.) that execute in the active worktree. See Run Commands for configuration details.


Clipboard & Agent Control

KeyAction
Cmd+C / Ctrl+CCopy selection (platform-dependent)
Ctrl+C / Alt+CCancel running agent (platform-dependent)
Ctrl+MCycle model (Claude Opus, Sonnet, Haiku, Codex models)
Ctrl+QQuit the application

The copy and cancel keys differ between macOS and other platforms. See Platform Differences for the full mapping.


Quick Reference

The complete table in one place:

KeyAction
pEnter prompt mode
TToggle terminal
EscReturn to command mode (per-pane)
Tab / Shift+TabCycle pane focus
GGitView panel
HHealth panel
MBrowse main branch
PProjects panel
rRun command
RAdd run command
[ / ]Switch worktree tab
?Help overlay
Cmd+C / Ctrl+CCopy selection
Ctrl+C / Alt+CCancel agent
Ctrl+MCycle model
Ctrl+QQuit