Keys
Every key Adroit handles runs a named action, and every action can be bound to other keys. F1 shows the bindings in force wherever the keys are. The menu bar offers every action too, with its key.
Mod is Cmd on macOS and Ctrl+Shift elsewhere, so one binding serves every platform.
The main keys
Section titled “The main keys”| Keys | Action |
|---|---|
| Ctrl+q h j k l | Move between the tree, the windows, the prompt and the details |
| Ctrl+q s, Ctrl+q v | Split below or beside the focused window |
| Ctrl+q c, Ctrl+q o | Close the window, or close every other |
| Ctrl+Tab, Ctrl+Shift+Tab | Next or previous tab |
| Ctrl+q g <, Ctrl+q g > | Move the tab a place to either side |
| Ctrl+q M, Ctrl+q m 1 … | Merge the tab into the one before it, or into a tab by number |
| Ctrl+q e | Switch a Markdown document between its viewer and Neovim |
| Mod+1 … Mod+9 | Go to a tab |
| Mod+p | Go to a session, or choose or clone where to start one |
| Mod+t | Start a session in the selected or focused directory |
| Mod+o | Resume a past conversation |
| Mod+j, Mod+k | Next or previous session waiting on you |
| Ctrl+q }, Ctrl+q { | Next or previous workspace |
| Mod+s, Mod+e | Open a shell or Neovim in the current directory |
| Mod+n | Open another window |
| Mod+f, Mod+r | Filter the tree, or read everything again |
| Mod+b, Mod+d | Show or hide the tree or the details |
| Mod+, | Open Settings |
| F1 | Show the keys for where you are |
Ctrl+q is a prefix: it reaches Adroit from anywhere, the prompt’s insert mode and a console included, as Ctrl+w does in Vim. Within it, a key held with Ctrl means the same as without, so Ctrl+q Ctrl+h is Ctrl+q h. Ctrl+w stays with the program in the console or the prompt. To send Ctrl+q itself to the console, press Ctrl+q ..
An action that steps through something repeats with its last key:
Ctrl+q g t t t goes three tabs on. The mode chip says REPEAT
meanwhile.
The keys of the tree, the prompt and the console are on their pages. The complete reference lists every action and every default binding.
Where the keys go
Section titled “Where the keys go”The mode chip at the bottom left says where the keys go: TREE, CONSOLE,
INSERT for the prompt, or PASS while a console takes every key. Keys go
there whatever a click left focused, but for a text field being typed in.
Over the window
Section titled “Over the window”A picker, the list of past conversations, a menu, a question, the keys help and the sheet adding an environment hold the keys while they are open, and share one set of bindings: Ctrl+n and Ctrl+p (or the arrow keys, Tab and Shift+Tab) move, Enter chooses, and Esc or a click on the shade around it closes it. A question also takes y and n. Each names the keys bound now along its foot.
The lightbox takes every key too, by bindings of its own.
Changing them
Section titled “Changing them”Change bindings in Settings › Keys, by action or by area. Keys are recorded as you press them, and a binding that would collide with another is pointed out. Each change is written into your keys file at once, its comments kept.
The file is ~/.config/adroit/keys.toml (or under $XDG_CONFIG_HOME, or
wherever $ADROIT_KEYS points). Adroit reads it again whenever it changes;
a mistake in it is reported at the bottom of the window, and the bindings in
force stay as they were.
[tree]"Ctrl+n" = "cursor.down""Ctrl+p" = "cursor.up""X" = "none""Ctrl+x" = "session.stop"
[console]"Ctrl+c" = "console.send Ctrl+c"
[console.claude]"Tab" = "console.send"Each table is an area of the window, and each entry binds keys to an action.
A binding replaces the one the area had for those keys; "none" takes the
keys away.
| Area | Holds the keys for |
|---|---|
global |
every area, after the area’s own |
tree |
the tree, and the details panel after its own |
filer |
a file tree: the tree’s files and the picker’s |
details |
the details panel |
console |
the console while it shows a session |
console.claude, console.codex, console.pi, console.opencode |
the console of that agent’s session, before console |
prompt |
the prompt, before Neovim |
draft |
a new session not started yet |
viewer |
a file viewer, and a pull request’s or issue’s tab |
overlay |
what is drawn over the window: a picker, a menu, a question, the keys help |
confirm |
a question to answer, before overlay |
lightbox |
the lightbox |
Adroit binds keys in an agent’s area where that agent takes a key otherwise than the prompt would: Tab in Claude Code’s console writes in the prompt, where it takes the suggested prompt.
A key is its modifiers and its name joined by +: Ctrl+q, Shift+Tab,
Mod+p. A sequence is keys separated by spaces: g g, Ctrl+q h. A
character carries its case, so G is Shift+g.