Skip to content

Keybindings

These keys are hardcoded and cannot be remapped.

KeyAction
j / k or / Navigate list
TabToggle between MR list and worktree panel
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
dDelete selected worktreedelete_worktree
mMerge selected worktree into default branchmerge_worktree
aOpen agent actions panelagent_actions
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 opencode session.

[keybindings]
refresh = "R"
open_browser = "O"
copy_branch = "y"
filter_projects = "p"
create_worktree = "n"
delete_worktree = "x"
merge_worktree = "g"
agent_actions = "a"

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///Tab/Enter/Esc/q) are not configurable.