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 new chord to set it (it must include Ctrl, so it can
never swallow a typed key). Pressing the prefix twice sends the literal chord to
the focused pane.
The Preset row below it applies a whole bundle at once. The tmux preset
switches the prefix to Ctrl+b and maps the tmux keys onto luvus:
| tmux | luvus 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
luvus’s defaults. A preset is a starting point, so you can still rebind
individual keys afterward. Choose luvus (default) to revert.
Note: , renames the tab on both the luvus 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 Luvus 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).
Ctrl+Space ? 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).