Skip to main content

Keyboard Shortcuts

Leader key: ctrl+x

ShortcutAction
Tab / shift+TabSwitch agents
ctrl+pCommand palette
ctrl+x mSwitch model
ctrl+x aAgent list
ctrl+x nNew session
ctrl+x u / ctrl+x rUndo / Redo
ctrl+x hHelp
ctrl+x eOpen editor
ctrl+x qExit
ctrl+x cCompact session
escapeInterrupt execution
shift+returnNew line in input

Session navigation

  • <leader> down — enter child session
  • left / right — cycle children
  • up — return to parent

Pinned sessions & quick switch

Pin the sessions you keep coming back to and jump to them with a single chord. Open the session list with <leader> l, then:

ShortcutAction
<leader> lOpen the session list
ctrl+fPin or unpin the highlighted session
<leader> 19Jump straight to pinned slot 1 through 9

Pinned top-level sessions are grouped under a Pinned category at the top of the session list, and the first nine are assigned quick-switch slots 19 — the slot number shows in the list gutter. Pressing <leader> 1<leader> 9 navigates directly to the session in that slot from anywhere in the TUI, without opening the list first.

note

Pins persist across restarts and only apply to top-level sessions (not child sessions). When a pinned session is deleted it is removed from your pins automatically.

Diff viewer

The TUI ships a full-screen diff viewer that is enabled by default. Open it from the command palette or the /diff command:

/diff

It opens on your working tree changes by default. Use d to switch the source to the last assistant turn, and back.

Diff viewer shortcuts

ShortcutAction
escape / qClose the diff viewer
tabSwitch focus between file tree and patches
j / downMove down
k / upMove up
pagedown / ctrl+fPage down
pageup / ctrl+bPage up
n / pJump to next / previous file
enter / spaceToggle the highlighted item
rightExpand the highlighted folder
leftCollapse the highlighted folder
EExpand all folders
bToggle the file-tree sidebar
sToggle single-patch view
dSwitch source (working tree / last turn)
vToggle split / unified layout
mToggle reviewed state for the selected file
?Show the full diff shortcut list

File tree

  • Focus-first-file. Switching focus into the file tree (tab) automatically highlights the first changed file, so you can start navigating immediately.
  • Directory collapse. Single-child directory chains are folded into one row (for example src/cli/cmd) to keep the tree compact. Expand or collapse a folder with right / left, or open everything at once with E.
  • Reviewed tracking. Mark a file as reviewed with m to keep track of what you have already looked at.

Accelerated scrolling

The patch pane uses accelerated scrolling. By default it scrolls a fixed three lines per step; you can tune this in your TUI config:

{
"scroll_speed": 5,
"scroll_acceleration": { "enabled": true }
}
  • scroll_acceleration.enabled turns on macOS-style momentum scrolling (the faster you scroll, the further each step travels). When enabled, it takes precedence over scroll_speed.
  • scroll_speed sets a fixed number of lines per scroll step (minimum 0.001). Omitting both leaves the default speed of 3.

See Configuration for where these settings live.