Keyboard reference
This page is generated from KEYMAP_CATALOG and the same help-section mapping that produces the in-app ? overlay. It covers 498 catalog entries across 28 contexts.
Movement, text editing, and list navigation share one grammar. A binding listed under several contexts means the same key does the same kind of action there; the section heading names the surface. Bindings marked hidden from which-key hints are still listed here and still work.
Contexts
| Context | Reference section |
|---|---|
pane | Panes and focus |
roster | Roster |
chat | Group chat and Direct conversation |
work | Work list |
settings | Settings |
wizard | Wizard |
picker | Dialogs |
confirm | Dialogs |
result | Dialogs |
approvals | Dialogs |
wizardField | Wizard |
wizardText | Wizard |
wizardMemory | Wizard |
promptField | Dialogs |
promptText | Dialogs |
settingsField | Settings |
settingsText | Settings |
settingsMemoryField | Settings |
settingsMemoryText | Settings |
filter | Dialogs |
global | Global keys |
help | Global keys |
command | Command and search |
search | Command and search |
composerInsert | Composer · Insert |
composerNormal | Composer · Normal |
composerVisual | Composer · Visual |
completion | Composer · Insert |
Global keys
Context: global, help.
Global
| Keys | Action | Notes |
|---|---|---|
? | Open help | — |
F2 | Open Ensemble from a native session | — |
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Scroll down | — |
k | Scroll up | — |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
PageDown | Page down | Hidden from which-key hints; help still lists it. |
PageUp | Page up | Hidden from which-key hints; help still lists it. |
gg | Top of help | — |
G | Bottom of help | — |
Esc | Close help | — |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Filter help | — |
n | Next match | — |
N | Previous match | — |
Notes
| Key or gesture | Meaning |
|---|---|
Tab / Shift+Tab | Cycle the visible panes; the cycle always lands in select mode. |
Esc | Go up one level. The full ladder is in Modes and Esc ladder. |
:q / Space q | Leave Ensemble deliberately; no other key quits. |
Panes and focus
Context: pane.
Focus
| Keys | Action | Notes |
|---|---|---|
h | Select the pane to the left | — |
l | Select the pane to the right | — |
j | Select the stacked pane below | — |
k | Select the stacked pane above | — |
Enter | Enter the selected pane | — |
Esc | Stay in pane selection | Hidden from which-key hints; help still lists it. |
i | Focus the composer from chat | — |
Tab | Next visible pane | — |
Shift+Tab | Previous visible pane | — |
Navigate
| Keys | Action | Notes |
|---|---|---|
v | Open full approvals | — |
Leader
| Keys | Action | Notes |
|---|---|---|
Space | Leader menu | — |
Notes
| Key or gesture | Meaning |
|---|---|
h/l | Select the column to the left or right; from chat, h selects Agents first and l selects Work. |
j/k | Select the stacked pane below or above: Agents/Workspaces on the left, Work/Approvals on the right. |
Enter | Enter the selected pane. Selecting a pane never starts content navigation or focuses the composer. |
Esc | Leave interaction and return to pane selection. |
Enter | Chat Enter enters transcript navigation; it never focuses the composer. |
i | Focus the composer from chat. Esc then returns to chat interaction, and another Esc returns to selection. |
white / grey | The selected or interacting pane has a white border and heading. AGENTS/WORKSPACES headings follow their own sub-pane, and Work cards are white only in Work interaction. |
Roster
Context: roster.
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Move down | — |
k | Move up | — |
gg | First item | Hidden from which-key hints; help still lists it. |
G | Last item | Hidden from which-key hints; help still lists it. |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
z | Collapse or expand the workspace group | — |
Esc | Return to pane selection | Hidden from which-key hints; help still lists it. |
Focus
| Keys | Action | Notes |
|---|---|---|
Tab | Next visible pane | — |
Shift+Tab | Previous visible pane | — |
Open
| Keys | Action | Notes |
|---|---|---|
Enter | Open the selected target | — |
Create
| Keys | Action | Notes |
|---|---|---|
a | New agent | — |
n | New workspace | — |
Edit
| Keys | Action | Notes |
|---|---|---|
e | Edit selection | — |
s | Agent settings | — |
Archive
| Keys | Action | Notes |
|---|---|---|
x | Archive selection | — |
Delete
| Keys | Action | Notes |
|---|---|---|
X | Delete selection | — |
Navigate
| Keys | Action | Notes |
|---|---|---|
v | Open full approvals | — |
State
| Keys | Action | Notes |
|---|---|---|
I | Init workspace files | — |
p | Pause / resume workspace | — |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Filter roster | — |
Leader
| Keys | Action | Notes |
|---|---|---|
Space | Leader menu | — |
Notes
| Key or gesture | Meaning |
|---|---|
x / X | x archives; X deletes and asks for confirmation. |
Group chat and Direct conversation
Context: chat.
Scroll
| Keys | Action | Notes |
|---|---|---|
j | Scroll transcript down | — |
k | Scroll transcript up | — |
gg | First message | Hidden from which-key hints; help still lists it. |
G | Last message | Hidden from which-key hints; help still lists it. |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
PageUp | Page transcript up | Hidden from which-key hints; help still lists it. |
PageDown | Page transcript down | Hidden from which-key hints; help still lists it. |
End | Jump to newest message | Hidden from which-key hints; help still lists it. |
Navigation
| Keys | Action | Notes |
|---|---|---|
Enter | Keep transcript navigation | Hidden from which-key hints; help still lists it. |
Esc | Clear search | Hidden from which-key hints; help still lists it. |
Focus
| Keys | Action | Notes |
|---|---|---|
Tab | Next visible pane | — |
Shift+Tab | Previous visible pane | — |
Open
| Keys | Action | Notes |
|---|---|---|
i | Focus the composer | — |
Create
| Keys | Action | Notes |
|---|---|---|
a | New agent | — |
n | New workspace | Unavailable while transcript search is open. |
Edit
| Keys | Action | Notes |
|---|---|---|
s | Agent settings | — |
Navigate
| Keys | Action | Notes |
|---|---|---|
v | Open full approvals | — |
o | Native session | — |
w | Next workspace | — |
W | Previous workspace | — |
z | Next agent | — |
Z | Previous agent | — |
State
| Keys | Action | Notes |
|---|---|---|
I | Init workspace files | — |
p | Pause / resume workspace | — |
Work
| Keys | Action | Notes |
|---|---|---|
x | Cancel selected work or remove queued message | — |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Search transcript | — |
Leader
| Keys | Action | Notes |
|---|---|---|
Space | Leader menu | — |
Notes
| Key or gesture | Meaning |
|---|---|
j / k | Scroll the transcript by line; there is no message cursor. |
Work list
Context: work.
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Next work card | — |
k | Previous work card | — |
h | Previous card in the row | — |
l | Next card in the row | — |
gg | First work card | Hidden from which-key hints; help still lists it. |
G | Last work card | Hidden from which-key hints; help still lists it. |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
PageUp | Previous Work page | Hidden from which-key hints; help still lists it. |
PageDown | Next Work page | Hidden from which-key hints; help still lists it. |
Esc | Return to pane selection | Hidden from which-key hints; help still lists it. |
Open
| Keys | Action | Notes |
|---|---|---|
Enter | Open work result or toggle a history group | — |
w | Why this card? | — |
Work
| Keys | Action | Notes |
|---|---|---|
d | Delegate work | — |
t | Reassign work | — |
r | Retry failed or stalled work | — |
R | Restart work | — |
x | Cancel work or dismiss the focused history group | — |
History
| Keys | Action | Notes |
|---|---|---|
D | Clear the history view | — |
Navigate
| Keys | Action | Notes |
|---|---|---|
o | Native session | — |
Approvals
| Keys | Action | Notes |
|---|---|---|
v | Open full approvals | — |
View
| Keys | Action | Notes |
|---|---|---|
f | Toggle active and history | — |
Focus
| Keys | Action | Notes |
|---|---|---|
Tab | Next visible pane | — |
Shift+Tab | Previous visible pane | — |
Leader
| Keys | Action | Notes |
|---|---|---|
Space | Leader menu | — |
Notes
| Key or gesture | Meaning |
|---|---|
d | Delegates in the work list; inside a text buffer d is the delete operator. |
h/j/k/l | Focus moves to the nearest card in that direction; h/l page at the leftmost/rightmost row edge, j/k page at a vertical edge, gg/G jump first/last, and Ctrl+d/u step a half page. |
white / grey | The selected Work pane has a white border; cards are white only after Enter enters Work interaction. The pane border and card focus stay separate. |
d/t/r/R/x/o | Only actions valid for the focused card are advertised: active cards delegate, reassign, restart, and cancel; stalled or retrying cards also retry; failed or cancelled history cards retry or restart; replied cards stay read-only. Enter opens the durable result when the card has one. |
v / Enter | Approvals live only in the right column. Split mode pins a small summary under Work; v opens the full-height inbox from any pane, Enter from the small selection opens the same inbox, j/k move, Enter resolves, and Esc returns to split mode. Closing the right pane hides approvals. |
Composer · Insert
Context: composerInsert, completion.
Insert
| Keys | Action | Notes |
|---|---|---|
Enter | Send message | — |
Shift+Enter | Insert a new line | — |
Esc | Go to composer Normal | — |
Ctrl+G | Leave the composer immediately | — |
Ctrl+C | Stop running work | — |
Completion
| Keys | Action | Notes |
|---|---|---|
$ | Open agent mentions | — |
@ | Open file references | — |
/ | Run a slash command | — |
Up | Previous completion | — |
Down | Next completion | — |
Enter | Accept the completion | — |
Esc | Close the completion popup | — |
Notes
| Key or gesture | Meaning |
|---|---|
text | Type at the cursor. Enter sends and keeps Insert focus; Shift+Enter adds a line. |
/ | At message start / lists commands plus every skill with Command, Skill | General, or Skill | <Owner> flags; after $Agent / it lists only that agent's assigned skills. |
General | A General skill has no Skillbox owner; it routes to the leader for triage. A General skill under a non-leader mention is rejected with the leader's name so the Skillbox stays authoritative. |
/init | Init is solo-only and workspace-only: send /init by itself. It appends a visible System Agent job, streams progress and a report, and never falls through to native /init. |
exact text | Each addressed agent receives the exact text once per message; multiple skills for one agent group into one prompt, no per-skill bodies or tasks are created, and separate messages keep their order. |
validation | Invalid skill or agent references reject the whole message before work starts, name the exact skill and owner, and keep the draft. |
Composer · Normal
Context: composerNormal.
Motion
| Keys | Action | Notes |
|---|---|---|
h | Move left | — |
j | Move down | — |
k | Move up | — |
l | Move right | — |
w | Next word | — |
b | Previous word | — |
e | End of word | — |
0 | Line start | — |
^ | First non-blank character | — |
$ | Line end | — |
gg | Buffer start | — |
G | Buffer end | — |
Insert
| Keys | Action | Notes |
|---|---|---|
i | Insert before the cursor | — |
a | Insert after the cursor | — |
I | Insert at line start | — |
A | Insert at line end | — |
o | Open a line below | — |
O | Open a line above | — |
Enter | Send message | — |
Ctrl+G | Leave the composer immediately | — |
Edit
| Keys | Action | Notes |
|---|---|---|
d | Delete operator (then a motion, d, or gg) | — |
y | Yank operator (yy) | — |
g | Chord prefix (gg) | — |
x | Delete the character | — |
dd | Delete the line | — |
D | Delete to the line end | — |
dh | Delete left | — |
dj | Delete down | — |
dk | Delete up | — |
dl | Delete right | — |
dw | Delete the next word | — |
db | Delete the previous word | — |
de | Delete to the word end | — |
d0 | Delete to the line start | — |
d$ | Delete to the line end | — |
dgg | Delete to the buffer start | — |
dG | Delete to the buffer end | — |
u | Undo | — |
Ctrl+R | Redo | — |
Yank
| Keys | Action | Notes |
|---|---|---|
yy | Yank the line | — |
Paste
| Keys | Action | Notes |
|---|---|---|
p | Paste after the cursor | — |
P | Paste before the cursor | — |
Visual
| Keys | Action | Notes |
|---|---|---|
v | Start character Visual | — |
V | Start line Visual | — |
Navigation
| Keys | Action | Notes |
|---|---|---|
: | Open the command line | — |
/ | Search the transcript | — |
Esc | Go to chat Normal | — |
Notes
| Key or gesture | Meaning |
|---|---|
Vim subset | No counts, text objects, macros, marks, or extra registers. |
Composer · Visual
Context: composerVisual.
Motion
| Keys | Action | Notes |
|---|---|---|
h | Extend left | — |
j | Extend down | — |
k | Extend up | — |
l | Extend right | — |
w | Extend to the next word | — |
b | Extend to the previous word | — |
e | Extend to the word end | — |
0 | Extend to the line start | — |
^ | Extend to the first non-blank | — |
$ | Extend to the line end | — |
gg | Extend to the buffer start | — |
G | Extend to the buffer end | — |
g | Chord prefix (gg) | — |
Selection
| Keys | Action | Notes |
|---|---|---|
o | Swap the selection ends | — |
y | Copy the selection | — |
d | Cut the selection | — |
x | Cut the selection | — |
c | Cut the selection and insert | — |
p | Replace the selection with the clipboard | — |
P | Replace the selection with the clipboard | — |
V | Switch to line selection | — |
Navigation
| Keys | Action | Notes |
|---|---|---|
v | Leave Visual | — |
Esc | Leave Visual | — |
Ctrl+G | Leave the composer immediately | — |
Notes
| Key or gesture | Meaning |
|---|---|
motions | Motions extend the selection; o swaps its ends. |
Settings
Context: settings, settingsField, settingsText, settingsMemoryField, settingsMemoryText.
Tabs
| Keys | Action | Notes |
|---|---|---|
h | Previous tab | — |
l | Next tab | — |
Tab | Next tab | — |
Shift+Tab | Previous tab | — |
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Next row | — |
k | Previous row | — |
gg | First row | Hidden from which-key hints; help still lists it. |
G | Last row | Hidden from which-key hints; help still lists it. |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
Esc | Close settings | — |
Edit
| Keys | Action | Notes |
|---|---|---|
Enter | Edit or toggle row | — |
e | Edit row | — |
p | Promote memory | — |
Space | Toggle skill | — |
d | Delete operator (then a motion, d, or gg) | — |
y | Yank operator (yy) | — |
g | Chord prefix (gg) | — |
x | Delete the character | — |
dd | Delete the line | — |
D | Delete to the line end | — |
dh | Delete left | — |
dj | Delete down | — |
dk | Delete up | — |
dl | Delete right | — |
dw | Delete the next word | — |
db | Delete the previous word | — |
de | Delete to the word end | — |
d0 | Delete to the line start | — |
d$ | Delete to the line end | — |
dgg | Delete to the buffer start | — |
dG | Delete to the buffer end | — |
u | Undo | — |
Ctrl+R | Redo | — |
Create
| Keys | Action | Notes |
|---|---|---|
a | Add row | — |
Delete
| Keys | Action | Notes |
|---|---|---|
x | Delete row | — |
Reorder
| Keys | Action | Notes |
|---|---|---|
J | Move backup down | — |
K | Move backup up | — |
State
| Keys | Action | Notes |
|---|---|---|
s | Save settings | — |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Filter tab | — |
Text
| Keys | Action | Notes |
|---|---|---|
Enter | Finish editing | — |
Esc | Field Normal | — |
Ctrl+G | Leave the field | — |
Esc | Return to settings | — |
Enter | Save memory | — |
Motion
| Keys | Action | Notes |
|---|---|---|
h | Move left | — |
j | Move down | — |
k | Move up | — |
l | Move right | — |
w | Next word | — |
b | Previous word | — |
e | End of word | — |
0 | Line start | — |
^ | First non-blank character | — |
$ | Line end | — |
gg | Buffer start | — |
G | Buffer end | — |
Insert
| Keys | Action | Notes |
|---|---|---|
i | Insert before the cursor | — |
a | Insert after the cursor | — |
I | Insert at line start | — |
A | Insert at line end | — |
o | Open a line below | — |
O | Open a line above | — |
Yank
| Keys | Action | Notes |
|---|---|---|
yy | Yank the line | — |
Paste
| Keys | Action | Notes |
|---|---|---|
p | Paste after the cursor | — |
P | Paste before the cursor | — |
Visual
| Keys | Action | Notes |
|---|---|---|
v | Start character Visual | — |
V | Start line Visual | — |
Notes
| Key or gesture | Meaning |
|---|---|
Insert / Normal / Visual | Text fields use the composer grammar; Esc returns to the settings rows, and Ctrl+G leaves the field directly. |
a / e / Enter | Memory add/edit uses the same persistent field: Enter saves, an add clears for the next entry, an edit keeps its text, and the field stays focused. |
Wizard
Context: wizard, wizardField, wizardText, wizardMemory.
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Next option | — |
k | Previous option | — |
Down | Next option | Hidden from which-key hints; help still lists it. |
Up | Previous option | Hidden from which-key hints; help still lists it. |
gg | First option | Hidden from which-key hints; help still lists it. |
G | Last option | Hidden from which-key hints; help still lists it. |
n | Next step | — |
N | Previous step | — |
Esc | Cancel wizard | — |
Open
| Keys | Action | Notes |
|---|---|---|
Enter | Select, continue, or submit | — |
Memories
| Keys | Action | Notes |
|---|---|---|
a | Add memory | Only in a memory field. |
e | Edit memory | Only in a memory field. |
x | Delete memory | Only in a memory field. |
Select
| Keys | Action | Notes |
|---|---|---|
Space | Toggle option | Only with multiple candidates. |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Filter options | — |
Text
| Keys | Action | Notes |
|---|---|---|
Enter | Continue | — |
Shift+Enter | New line | — |
Esc | Field Normal | — |
Ctrl+G | Leave the field | — |
n | Next step | — |
N | Previous step | — |
Esc | Cancel wizard | — |
Enter | Save memory | — |
Esc | Back to the memory list | — |
Ctrl+G | Back to the memory list | — |
Motion
| Keys | Action | Notes |
|---|---|---|
h | Move left | — |
j | Move down | — |
k | Move up | — |
l | Move right | — |
w | Next word | — |
b | Previous word | — |
e | End of word | — |
0 | Line start | — |
^ | First non-blank character | — |
$ | Line end | — |
gg | Buffer start | — |
G | Buffer end | — |
Insert
| Keys | Action | Notes |
|---|---|---|
i | Insert before the cursor | — |
a | Insert after the cursor | — |
I | Insert at line start | — |
A | Insert at line end | — |
o | Open a line below | — |
O | Open a line above | — |
Edit
| Keys | Action | Notes |
|---|---|---|
d | Delete operator (then a motion, d, or gg) | — |
y | Yank operator (yy) | — |
g | Chord prefix (gg) | — |
x | Delete the character | — |
dd | Delete the line | — |
D | Delete to the line end | — |
dh | Delete left | — |
dj | Delete down | — |
dk | Delete up | — |
dl | Delete right | — |
dw | Delete the next word | — |
db | Delete the previous word | — |
de | Delete to the word end | — |
d0 | Delete to the line start | — |
d$ | Delete to the line end | — |
dgg | Delete to the buffer start | — |
dG | Delete to the buffer end | — |
u | Undo | — |
Ctrl+R | Redo | — |
Yank
| Keys | Action | Notes |
|---|---|---|
yy | Yank the line | — |
Paste
| Keys | Action | Notes |
|---|---|---|
p | Paste after the cursor | — |
P | Paste before the cursor | — |
Visual
| Keys | Action | Notes |
|---|---|---|
v | Start character Visual | — |
V | Start line Visual | — |
Notes
| Key or gesture | Meaning |
|---|---|
Insert / Normal / Visual | Text fields use the composer grammar; Esc goes to field Normal, and another Esc cancels (dirty asks first). Ctrl+G leaves the field immediately. |
a / e / x | Memories are an ordered list: a adds, e edits, x deletes, j/k selects, and n/N move between steps. Enter saves one memory and keeps the field focused for the next. |
Dialogs
Context: picker, confirm, result, approvals, promptField, promptText, filter.
Navigation
| Keys | Action | Notes |
|---|---|---|
j | Next item | — |
k | Previous item | — |
Down | Next item | Hidden from which-key hints; help still lists it. |
Up | Previous item | Hidden from which-key hints; help still lists it. |
gg | First item | Hidden from which-key hints; help still lists it. |
G | Last item | Hidden from which-key hints; help still lists it. |
Esc | Cancel | — |
Enter | Close | Hidden from which-key hints; help still lists it. |
Esc | Close | — |
j | Next approval | — |
k | Previous approval | — |
Down | Next approval | Hidden from which-key hints; help still lists it. |
Up | Previous approval | Hidden from which-key hints; help still lists it. |
gg | First approval | Hidden from which-key hints; help still lists it. |
G | Last approval | Hidden from which-key hints; help still lists it. |
Esc | Close full approvals and return to split | — |
Open
| Keys | Action | Notes |
|---|---|---|
Enter | Select | — |
Select
| Keys | Action | Notes |
|---|---|---|
Space | Toggle item | Only with multiple candidates. |
Search
| Keys | Action | Notes |
|---|---|---|
/ | Filter items | — |
Tab | Change session scope | — |
Backspace | Type to filter | — |
Enter | Finish filtering | — |
Esc | Clear filter | — |
Decision
| Keys | Action | Notes |
|---|---|---|
y | Yes | — |
Enter | Yes | Hidden from which-key hints; help still lists it. |
n | No | — |
Esc | No | Hidden from which-key hints; help still lists it. |
Scroll
| Keys | Action | Notes |
|---|---|---|
j | Scroll down | — |
k | Scroll up | — |
Down | Scroll down | Hidden from which-key hints; help still lists it. |
Up | Scroll up | Hidden from which-key hints; help still lists it. |
gg | Top of result | Hidden from which-key hints; help still lists it. |
G | Bottom of result | Hidden from which-key hints; help still lists it. |
Ctrl+D | Half page down | — |
Ctrl+U | Half page up | — |
PageDown | Page down | Hidden from which-key hints; help still lists it. |
PageUp | Page up | Hidden from which-key hints; help still lists it. |
Approvals
| Keys | Action | Notes |
|---|---|---|
Enter | Resolve the focused approval | — |
Focus
| Keys | Action | Notes |
|---|---|---|
Tab | Next visible pane | — |
Shift+Tab | Previous visible pane | — |
Leader
| Keys | Action | Notes |
|---|---|---|
Space | Leader menu | — |
Text
| Keys | Action | Notes |
|---|---|---|
Enter | Submit | — |
Shift+Enter | New line | — |
Esc | Field Normal | — |
Ctrl+G | Leave the field | — |
Esc | Cancel | — |
Motion
| Keys | Action | Notes |
|---|---|---|
h | Move left | — |
j | Move down | — |
k | Move up | — |
l | Move right | — |
w | Next word | — |
b | Previous word | — |
e | End of word | — |
0 | Line start | — |
^ | First non-blank character | — |
$ | Line end | — |
gg | Buffer start | — |
G | Buffer end | — |
Insert
| Keys | Action | Notes |
|---|---|---|
i | Insert before the cursor | — |
a | Insert after the cursor | — |
I | Insert at line start | — |
A | Insert at line end | — |
o | Open a line below | — |
O | Open a line above | — |
Edit
| Keys | Action | Notes |
|---|---|---|
d | Delete operator (then a motion, d, or gg) | — |
y | Yank operator (yy) | — |
g | Chord prefix (gg) | — |
x | Delete the character | — |
dd | Delete the line | — |
D | Delete to the line end | — |
dh | Delete left | — |
dj | Delete down | — |
dk | Delete up | — |
dl | Delete right | — |
dw | Delete the next word | — |
db | Delete the previous word | — |
de | Delete to the word end | — |
d0 | Delete to the line start | — |
d$ | Delete to the line end | — |
dgg | Delete to the buffer start | — |
dG | Delete to the buffer end | — |
u | Undo | — |
Ctrl+R | Redo | — |
Yank
| Keys | Action | Notes |
|---|---|---|
yy | Yank the line | — |
Paste
| Keys | Action | Notes |
|---|---|---|
p | Paste after the cursor | — |
P | Paste before the cursor | — |
Visual
| Keys | Action | Notes |
|---|---|---|
v | Start character Visual | — |
V | Start line Visual | — |
Notes
| Key or gesture | Meaning |
|---|---|
| Policy | Pickers, prompts, confirms, results, and approvals share one grammar: j/k, Enter, Space, /, Esc. |
Command and search
Context: command, search.
Command
| Keys | Action | Notes |
|---|---|---|
Enter | Run command or search | — |
Esc | Cancel and restore the previous filter | — |
Tab | Complete the command name | — |
History
| Keys | Action | Notes |
|---|---|---|
Up | Recall an older entry | — |
Down | Recall a newer entry | — |
Editing
| Keys | Action | Notes |
|---|---|---|
left | Move the caret left | Hidden from which-key hints; help still lists it. |
right | Move the caret right | Hidden from which-key hints; help still lists it. |
Home | Move the caret to the start | Hidden from which-key hints; help still lists it. |
End | Move the caret to the end | Hidden from which-key hints; help still lists it. |
Backspace | Delete the previous character | — |
Delete | Delete the character under the caret | Hidden from which-key hints; help still lists it. |
Search
| Keys | Action | Notes |
|---|---|---|
n | Next match | — |
N | Previous match | — |
Esc | Clear the committed search | — |
Notes
| Key or gesture | Meaning |
|---|---|
: | Commands navigate or change state only; destructive actions stay on keys and the leader with their confirms. |
←/→ Home/End | The : and / input keeps a cursor: Left/Right, Home/End, Backspace, Delete, and insertion at the cursor all edit in place; history and Tab completion still apply. |
Leader menu
Context: leader.
Leader
| Keys | Action | Notes |
|---|---|---|
Space ? | Help | — |
Space q | Leave Ensemble | — |
Space Esc | Cancel | — |
Create
| Keys | Action | Notes |
|---|---|---|
Space a | New agent | — |
Space n | New workspace | — |
Edit
| Keys | Action | Notes |
|---|---|---|
Space e | Edit workspace | — |
Space s | Settings | — |
Space l | Dispatch limits | — |
Archive
| Keys | Action | Notes |
|---|---|---|
Space w | Archive workspace | — |
Space A | Archive agent | — |
Delete
| Keys | Action | Notes |
|---|---|---|
Space W | Delete workspace | — |
Space D | Delete agent | — |
Navigate
| Keys | Action | Notes |
|---|---|---|
Space v | Approvals | — |
Space o | Native session | — |
Space O | Adopt native session | — |
View
| Keys | Action | Notes |
|---|---|---|
Space b | Pane visibility | — |
Space bl | Toggle the left pane | — |
Space br | Toggle the right pane | — |
State
| Keys | Action | Notes |
|---|---|---|
Space p | Pause / resume | — |
Space i | Init workspace files | — |
Work
| Keys | Action | Notes |
|---|---|---|
Space d | Delegate | — |
Space t | Reassign | — |
Space r | Retry | — |
Space R | Restart | — |
Space x | Cancel work | — |
Notes
| Key or gesture | Meaning |
|---|---|
Space | Leader key opens the which-key menu; Esc cancels it. |
Modes and Esc ladder
| Key or gesture | Meaning |
|---|---|
NORMAL | Lists navigate rows; text buffers run the Vim subset. |
INSERT | Type into the focused composer or text field. |
VISUAL / V-LINE | Select text by character or line, then yank, cut, or change. |
COMMAND | The : command line or the / search/filter input. |
mode | Mode is global and persistent: focus, overlay, wizard-step, and surface changes never assign it; Enter never changes it. Only explicit mode keys do. |
caret | Every text editor shows a block caret in Normal and a line caret in Insert, Visual, and Command; an unfocused editor shows none. |
Esc | Insert → Normal (composer or text field). |
Esc | Visual → Normal. |
Esc | Composer Normal → chat interaction → pane selection. |
Esc | Settings text field Normal → settings Normal. |
Esc | Settings Normal → close settings. |
Esc | Wizard text field Insert → field Normal; field Normal → cancel the wizard (a dirty draft asks first). |
Esc | Wizard step Normal → cancel the wizard. n next and N previous move between steps; Enter advances. |
Esc | Cancel the dialog, picker, confirm, or result overlay. |
Esc | Command → Normal, restoring the previous filter. |
Esc | Chat interaction → pane selection; a select-mode Esc clears a filter or committed search first, otherwise it is a no-op. |
Esc | Esc never leaves Ensemble. Quit deliberately with :q or Space q. |
Ctrl+G | Leave the focused composer, settings, wizard, or prompt text field immediately when the host consumes Esc. |
Clipboard and mouse
| Key or gesture | Meaning |
|---|---|
Wheel | Scroll the scrollable pane under the pointer |
Drag | Select text in the pane where the drag starts |
Release | Copy the selection to the system clipboard and show a toast |
Double-click | Select a word |
Triple-click | Select a line |
Click card | Focus that Work card |
Click ‹ › | Page the Work pane |
Click approval | Focus an inline approval; click the focused row again to resolve it |
y / yy | Yank to the system clipboard. |
d / dd / x | Deletes are cuts and also write to the system clipboard. |
p / P | Read the system clipboard first; the internal register is the fallback. |
Visual y / d / c | Yank, cut, or change the selected range. |
async | A paste is discarded if focus or the buffer changed while the clipboard read was in flight. |
toast | Copy success clears a mouse selection; failure keeps it and shows an error. |
Statusline legend
| Key or gesture | Meaning |
|---|---|
mode | Chip: NORMAL, INSERT, VISUAL, V-LINE, or COMMAND. |
context | Agents, Workspaces, Group chat, Direct conversation, Work list, Settings, Wizard, Dialog, Approvals, or Help. |
git:(branch*) | Branch, dirty mark, ahead ↑, and behind ↓ counts. |
position | line:col in a text buffer, row/total in a list, or percent in the transcript. |
chord | Pending multi-key prefix, e.g. g. |
hints | Context keys generated from the binding catalog, e.g. enter open │ / filter │ space leader. |
│ | Chrome joins segments with a faint │ and one space; ASCII | is the fallback. Chat message content is never rewritten. |
LEADER | The LEADER rail badge is a true cutout on an opaque surface; when no surface is guaranteed, black/white contrast is chosen from the accent. |
row 2 | : or / input while active; otherwise the latest transient message; otherwise blank. |
Native-session scope
| Key or gesture | Meaning |
|---|---|
| Policy | Native-session keys are owned by the host; a hidden Ensemble page never consumes them. |
quit / F2 | Leaving Ensemble hides the page; native keys, including /, go to the host immediately. F2 returns to Ensemble. |
Custom overlays not in the keymap catalog
Two read-only overlays use local key handlers instead of KEYMAP_CATALOG. Their keys are listed here explicitly and are not part of the in-app help coverage check.
:logs viewer
| Keys | Action |
|---|---|
Esc / q | Close the viewer. |
r | Refetch the current filter. |
j / Down | Scroll down one row. |
k / Up | Scroll up one row. |
PageDown / Ctrl+d | Scroll down ten rows. |
PageUp / Ctrl+u | Scroll up ten rows. |
g | Jump to the top. |
G | Jump to the bottom. |
:limits panel
| Keys | Action |
|---|---|
j / Down | Select the next row. |
k / Up | Select the previous row. |
h / Left | Decrease the selected value. |
l / Right | Increase the selected value. |
Enter / s | Validate and save all four limits. |
Esc / q | Cancel and close the panel. |
The native OpenCode host owns keys inside a native session; this page does not claim host bindings.
Next
- Command reference: the
:logsand:limitsarguments. - Configuration: the values the limits panel writes.