Keybindings
Design Philosophy #
When the terminal panel is focused,
all keys are forwarded to the PTY
except those with a
Ctrl
modifier (intercepted as global commands) and
Shift+arrow/page
keys (for scrollback).
Why Ctrl, not Alt?
Coding-agent CLIs and shell programs heavily use Alt-key combinations. Ctrl has
established precedent for meta actions in terminal multiplexers (tmux uses
Ctrl+B
, screen uses
Ctrl+A
).
Global Keys #
| Key | Action | Mnemonic |
|---|---|---|
Ctrl+Q |
Quit (detach sessions) | Q uit |
Ctrl+N |
New session (opens repo picker) | N ew |
Ctrl+C |
Copy selection, or send SIGINT if none | C opy |
Ctrl+V |
Paste from clipboard | Paste |
Ctrl+P |
Automations (scheduled agent runs) | P rogram |
Ctrl+W
/
F5
|
Toggle tasks panel (todo list) | Work items |
Ctrl+A |
Global search (sessions / tasks / automations / files) | search A ll |
Ctrl+T |
Toggle shell pane | T erminal |
Ctrl+H |
Focus previous pane (cycle backward) | Vim: h = left |
Ctrl+J |
Select next session | Vim: j = down |
Ctrl+K |
Select previous session | Vim: k = up |
Ctrl+L |
Focus next pane (cycle forward) | Vim: l = right |
Ctrl+D |
Delete session | Vim: d = delete |
Ctrl+O |
Open active session's repos/worktrees in editor | O pen |
Ctrl+R |
Restart active session | R estart |
Ctrl+F |
Fork active session | F ork |
Ctrl+S |
Sync worktrees with origin/main | S ync |
Ctrl+Z |
Undo session delete | Z = undo |
Ctrl+U |
Restore deleted sessions | U ndelete |
Ctrl+Y
/
F4
|
Pick TUI theme | Color Y oke |
F1 |
Toggle keybindings help | Universal |
F2 |
Toggle info panel | Next to F1 |
F3 |
Toggle file viewer | Next to F2 |
List Navigation #
When the session list is focused:
| Key | Action |
|---|---|
j
/
Down
|
Next item |
k
/
Up
|
Previous item |
Enter |
Select / focus |
Search #
Press
Ctrl+A
to open the global search strip, which searches
every scope at once
— sessions (name, agent, branch, and live terminal-buffer content), tasks,
automations, and the active session's file tree. It replaces the old per-pane
/
filters.
- Type to filter; matches highlight live in the panels themselves.
-
Up/Down(orCtrl+P/Ctrl+N) move the selection,Enterjumps to the result and focuses its pane, andEscrestores the prior state.
The file viewer keeps its own in-file
/
text search, which is unrelated to global search.
Terminal Scrollback & Selection #
| Key | Action |
|---|---|
Shift+Up
/
Shift+Down
|
Scroll 1 line |
Shift+PageUp
/
Shift+PageDown
|
Scroll half page |
| Mouse wheel | Scroll 3 lines |
| Mouse drag | Select text |
| Any other key | Snap to bottom + forward to PTY |
When scrolled up, the block title shows a
[N↑]
indicator and the PTY cursor is hidden.
Modal Keybindings #
Branch selector (Worktree mode)
| Key | Action |
|---|---|
j
/
Down
|
Next branch |
k
/
Up
|
Previous branch |
Enter |
Select base branch, open name prompt |
Esc |
Cancel |
New branch name prompt
| Key | Action |
|---|---|
Enter |
Confirm name, create branch and worktree |
Esc |
Cancel |
Automations #
A dedicated Automations pane sits beneath the session list (always present). It joins
the
Ctrl+H
/
Ctrl+L
focus cycle;
Ctrl+P
opens the same list as a modal at any width.
Automations pane / list (focused)
| Key | Action |
|---|---|
Ctrl+N
/
n
|
New automation (opens the editor) |
j
/
k
|
Select previous / next automation |
Space |
Toggle enabled / disabled |
r |
Run now |
e
/
Enter
|
Edit |
d |
Delete |
Automation editor
| Key | Action |
|---|---|
Tab
/
↑
↓
|
Move between fields |
←
→
/
Space
|
Adjust the focused selector / stepper (trigger, time, action) |
Ctrl+E |
Toggle enabled |
Enter |
Save |
Esc |
Cancel |
Agent Picker #
The
Ctrl+N
new-session flow ends with an agent picker. The agent picker is skipped when only one
agent is defined in
agents.toml
.
| Key | Action |
|---|---|
j
/
Down
|
Next agent |
k
/
Up
|
Previous agent |
Enter |
Confirm selection |
Esc |
Cancel session creation |