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.
| Key | Command | Key | Command |
|---|---|---|---|
←↓↑→ / hjkl | focus pane | c | new tab |
; | next pane (cycle) | n / p / ⇥ | cycle tabs |
. | next blocked agent | , | rename tab |
v / s | split right / down | N | new workspace (folder picker) |
x | close pane | D | close workspace |
z | zoom pane | w / W | next / previous workspace |
r | resize mode (then arrows) | G | new worktree |
f | fork agent session | g | git tab |
b / B | toggle left / right sidebar | o | orchestration board |
a | agents All/Active | m | jump palette (tabs / workspaces / agents) |
e | toggle FILES dock | / | global fuzzy finder |
= | Settings | q / d | detach |
1–9 | jump to tab |
The prefix and presets
Section titled “The prefix and presets”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 (F1–F12) 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:
| tmux | artuditu command |
|---|---|
% / " | split right / down |
o | next pane |
, | rename tab (window) |
( / ) | previous / next workspace (session) |
w | jump 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.
The jump palette
Section titled “The jump palette”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.
The global fuzzy finder
Section titled “The global fuzzy finder”/ 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.
No-prefix keys and menus
Section titled “No-prefix keys and menus”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.
Remapping
Section titled “Remapping”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).