Skip to content

Keybindings

These keys are hardcoded and cannot be remapped.

KeyAction
j / k or ↑ / ↓Navigate list
EnterFocus selected pane/worktree in tmux

Action keys can be remapped via the [keybindings] section in your config file. Defaults shown below.

KeyActionConfig key
rRefresh all datarefresh
oOpen MR in browseropen_browser
bCopy selected branch name to clipboardcopy_branch
fFuzzy filter to switch projectfilter_projects
cCreate new worktreecreate_worktree
wCreate worktree and inject a prompt (requires default_worktree_with_prompt)open_worktree_with_prompt
dDelete selected worktreedelete_worktree
mOpen MR Overview popup (all your open MRs across all forges)mr_overview
MMerge selected worktree into default branchmerge_worktree
aOpen agent actions panelagent_actions
AOpen Agent Activity popup — review status cards and jump to the relevant tmux paneactivity_feed
KeyAction
j / k or ↑ / ↓Move between activity cards
dMark the selected activity as handled; press again to permanently delete it
cMark every activity as handled
EnterFocus the selected agent pane, or recreate it and resume Codex if it is gone
EscClose the popup
KeyAction
q / EscQuit client (daemon keeps running)
prefix+aToggle dashboard popup (requires tmux config)

Add a [keybindings] section to your config file to remap action keys. Only single characters are supported — no modifier keys or multi-key sequences. The agent_actions popup only shows when a worktree has an active coding agent session.

[keybindings]
refresh = "R"
open_browser = "O"
copy_branch = "y"
filter_projects = "p"
create_worktree = "n"
open_worktree_with_prompt = "W"
delete_worktree = "x"
merge_worktree = "G"
mr_overview = "v"
agent_actions = "P"
activity_feed = "F"

Missing keys use their defaults. Each action must have a unique key — duplicates are rejected at startup with a clear error message.

Navigation keys (j/k/↑/↓/Enter/Esc/q) are not configurable.