Skip to content

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.

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.

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.

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.

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.