Skip to content

Keybindings

Press the prefix (Ctrl+Space by default), then a key. Ctrl+Space ? shows the live cheat-sheet. Remap anything, change the prefix, or apply a preset in Settings → Keys.

KeyCommandKeyCommand
←↓↑→ / hjklfocus panecnew tab
;next pane (cycle)n / p / cycle tabs
.next blocked agent,rename tab
v / ssplit right / downNnew workspace (folder picker)
xclose paneDclose workspace
zzoom panew / Wnext / previous workspace
rresize mode (then arrows)Gnew worktree
ffork agent sessionggit tab
b / Btoggle left / right sidebaroorchestration board
aagents All/Activemjump palette (tabs / workspaces / agents)
etoggle FILES dock/global fuzzy finder
=Settingsq / ddetach
19jump to tab

The prefix is configurable. From the Prefix row at the top of Settings → Keys, press a safe key, then press it again to confirm. You can use a single function key (F1F12) or a character/Space chord containing Ctrl or Alt, such as Ctrl+b, Alt+\, or Ctrl+Alt+Space. Bare text keys are rejected so Artuditu can never swallow normal typing. Super/Cmd, Hyper, and Meta are rejected because desktop environments do not report them consistently. Pressing the configured prefix twice sends that literal key to the focused pane.

The no-Ctrl (F12) preset is the most portable single-key option. On a Mac keyboard configured to use media controls, press Fn+F12; Artuditu still receives it as F12. Artuditu asks you to confirm any captured prefix before saving it, so an operating-system or terminal shortcut cannot silently lock you out.

The Preset row below it applies a whole bundle at once. Available presets are artuditu (default) (Ctrl+Space), no-Ctrl (F12), and tmux. The tmux preset switches the prefix to Ctrl+b and maps the tmux keys onto artuditu:

tmuxartuditu command
% / "split right / down
onext pane
,rename tab (window)
( / )previous / next workspace (session)
wjump palette (choose-window / choose-tree)

The rest of tmux’s keys (c, n, p, x, z, d, digits) already match artuditu’s defaults. A preset is a starting point, so you can still rebind individual keys afterward. Choose artuditu (default) to revert.

Note: , renames the tab on both the artuditu defaults and the tmux preset (the same as tmux’s rename-window), and Settings lives on =. The Menu button (top-right) always opens Settings too.

m (or w under the tmux preset) opens the palette: every tab, every workspace, and every agent in one overlay. Type to filter, and use the scope chips (or Tab) to narrow it to one category. Arrows move, Enter jumps, Esc clears the filter then closes.

/ opens one finder across the selected Artuditu home. It ranks named sessions, workspaces, tabs, panes, agents, file paths, and retained pane output. Use Tab or Shift+Tab to move through All, Navigate, Files, and Output. Ctrl+i toggles case-sensitive retained-output matching. Enter opens the selected target. A non-empty query needs one Esc to clear and a second Esc to close.

Navigation results appear first. File, output, and other running-session results arrive in the same list without resetting the selected row. See the Global Fuzzy Finder guide for limits and CLI use.

Shift+↑ enters scroll mode, and the mouse does everything else.

Right-click menus (no key needed): a tab to rename it, a workspace row for its menu (rename / close / worktrees / git / board), a pane to split or close it, an agent row for quick actions, or a FILES row to open it read-only or in an editor (plus new / rename / delete). See Panes, Tabs & Workspaces and Browsing & Opening Files.

Custom bindings persist in config.json: prefix holds the prefix chord, and keybindings maps each command id to a key (an empty value unbinds it). Pressing the configured prefix and then ? shows the current map, and every command is editable in Settings → Keys (the vim hjkl and Tab aliases included, since nothing is bound behind your back).