Keybindings reference

The full default keymap, generated from the action catalog (crates/tui-core/src/action.rs). Press ? in the app to open Ask Lazybox: typing searches your live bindings immediately, and Enter asks in plain language. Press ? again at its empty prompt for the compact shortcut index. If you’ve remapped keys via ui.action_keys or selected a preset, those in-app surfaces show your effective bindings; this page shows the defaults.

Grouped actions live behind leader keys (press the leader, a which-key menu pops up, the next key picks the action). The default keymap is leaders-only: no single-key aliases for grouped actions.

The design

The keymap follows five rules:

1. Ask, don’t memorize. ? searches the effective keymap and answers workflow questions; the static index is secondary.
2. Common verbs stay direct. Enter opens, s starts a shell, e opens the editor, r replies, z snoozes, and / searches.
3. Families use mnemonic leaders. w work, a agent, b main branch, g GitHub, and x workspace management. Every leader opens a visible menu.
4. Risk requires intent. Destructive/provider mutations are behind a leader and confirmation; quit is q q.
5. Terminal mode has one escape namespace. ]] opens every lazybox command that must work while the embedded program owns the keyboard.

Global

Work from any non-terminal pane. A focused terminal forwards keys to the PTY; press ]]q to return first. Text selection (F8) is the deliberate exception and works inside a terminal too.

Key	Action	What it does
Tab	cycle panes	Move focus to the next pane.
Shift-R	refresh	Re-poll every provider for fresh tasks.
Ctrl-l	redraw	Clear the terminal and repaint the whole UI from scratch.
,	settings	Open the Settings palette.
t	theme	Open the theme picker — arrow through the built-in palettes with a live preview, Enter to keep one.
]	snippets	Browse the snippet workflow library — every ]]s<key> shortcut with its description and body, so you can see what’s available without already knowing the key.
?	ask lazybox	Search the live keymap or ask how to use lazybox in plain language.
Shift-I	icon legend	Open the glyph legend — every sidebar marker (status pills, agent-state glyphs, row badges, and the repo header’s kind / role counts such as 3⇄ 2○ · 2A 1R) painted the way it renders on a row, beside its one-line meaning.
Shift-T	coach	Start (or re-run) the onboarding coach — a slim rail that gives you one objective at a time and confirms when you actually do it.
Shift-D	sync diagnostics	Show recent provider-sync outcomes, last poll times, and errors.
Shift-M	messages	Open the messages log — a scrollable, clearable history of recent footer notices, so an error that flashed and faded is still readable.
Shift-E	errors	Open the Error Inbox — the daemon’s durable, deduplicated error store (survives restart), grouped by class with counts.
Shift-U	usage stats	Open the usage-stats view — a day/week breakdown of what you’ve done, built from the daemon’s persisted event history: agent sessions, prompts, PRs merged, agent turns, tokens, and cost.
Shift-H	hopper	Open the personal Hopper editor.
Esc	dismiss	Clear the current footer notice, whatever its severity — retryable, info, permanent, or auth.
Enter	detail	Open the current footer error in a full-text detail modal.
`	jump to workspace	Open a fuzzy picker over every workspace (across repos) and jump to the one you pick.
!	next asking	Jump the cursor to the next workspace whose agent is waiting on input (a quick jump; the workspace picker ` reaches any workspace).
Shift-F	next failing	Jump the cursor to the next PR whose CI is failing (a quick jump; the workspace picker ` reaches any workspace).
Shift-L	next stopped agent	Jump the cursor to the next workspace whose agent has stopped and needs you — blocked on its provider usage / rate limit (#847), or stopped on an infrastructure failure such as a 502 or a refused gateway connection (#1782).
Shift-N	next unread	Jump the cursor to the next workspace with unread activity, wrapping around (#1502).
.	focus mode	Maximize the focused workspace’s terminal to near-fullscreen behind a slim event header, hiding the sidebar and activity pane.
Shift-W	start work	Pick a project, name a workspace, and start the default agent in it — all in one step, from any pane.
Shift-C	connect box	Connect to (or disconnect from) the remote box on demand.
Shift-K	resume stopped agents	Resume every stopped agent at once — a settle-gated ‘continue’ injected into each one: the rate-limit blocked (⧗), the parked-on-auto-continue (☾) and the stopped-on-an-error (↯) alike.
Ctrl-k	recover credit	Select the provider’s Wait for credit option for the focused blocked agent, wait for its composer, and submit the configured continuation prompt.
Shift-P	activity pane	Cycle the activity pane: full feed → one-line summary (new-activity / failing-CI counts) → hidden → full.
F8 | Alt-s | Ctrl-Alt-s	text selection	Toggle lazybox’s mouse capture so the host terminal regains native text selection (trackpad-select + Cmd-C in agent scrollback).
Shift-Arrows	resize splitters	Grow / shrink the focused splitter.
q q	quit (two-press chord)	Quit lazybox.

Workspace

Act on the focused workspace. Available from the sidebar and the activity pane (the sidebar selection stays the reference frame while reading activity).

Key	Action	What it does
Enter	open	Focus the workspace’s activity / terminal.
s	shell	Open a shell in the workspace’s worktree.
e	editor	Open the worktree in the configured editor.
*	focus	Star or unstar the cursor’s workspace, lifting it into a ★ Focused section at the very top of the sidebar — a hand-picked shortlist of PRs/issues across repos, kept together above the repo groups.
v	select	Toggle the focused workspace in/out of the multi-select set.
Shift-V	visual select	Arm a vim-style visual sweep: j/k (and arrows) grow / shrink the multi-select range from the anchor, no Shift-arrow encoding needed.
m	mark read	Mark every activity row on the focused workspace read.
z	snooze	Snooze the workspace for ~4h (toggle).
Shift-A	toggle auto-fix	Arm or disarm auto-fix for the focused PR.
r	reply	Open the reply textarea targeted at this workspace.
n	notes	Edit this workspace’s local scratchpad — a private note that never syncs to a provider.

Sidebar

Manage the sidebar list itself — only while the sidebar has focus.

Key	Action	What it does
{	prev group	Move the cursor to the previous group header (Space / repo / Focused / Hopper) so a long inbox can be crossed a group at a time (#1502).
}	next group	Move the cursor to the next group header (Space / repo / Focused / Hopper) so a long inbox can be crossed a group at a time (#1502).
f	filter	Open the filter menu — toggle state (with-agent, CI-failing, conflict, unread, asking, …), role, and kind predicates.
o	order	Cycle the sort order (recency → by-role → by-role with section headers).
Shift-S	switch mailbox	Cycle the mailbox view (Inbox → Inactive → Snoozed).
/	search project	Open the incremental search bar scoped to the focused project — only that repo group’s workspaces are matched, every other project stays put.
#	search all repos	Open the header search box — an incremental search across every repo group at once (unlike /, which is scoped to just the focused project).
Space	collapse group	Collapse or expand the most local group at the cursor: a parent ticket’s descendants, a Space, or a repo.
p	pin group	Pin or unpin the cursor’s repo group to the top of the sidebar.
Right | l	focus right	Move focus one pane to the right — from the sidebar to the activity pane, or straight to the terminal when the activity pane is hidden.
Shift-B	broadcast	Send one free-text instruction — optionally seeded from a snippet — to every multi-selected workspace at once.

j / k (or arrows) move the cursor; Esc clears a v multi-selection. See Orchestrate multiple agents for the complete broadcast workflow: cross-repo selection, target recap, snippet and free-text compose, delivery, skips, and history.

Activity

Only while the activity (right) pane has focus.

Key	Action	What it does
Enter	toggle section	Collapse / expand the activity section.
→/←	expand/collapse	Expand or collapse the focused activity row.
Left | h	focus left	Move focus one pane to the left — from the activity pane back to the sidebar.
g	top	Jump the activity cursor to the first row.
Shift-G	bottom	Jump the activity cursor to the last row.
d	description	Toggle the PR / issue description visibility.
Space	select row	Toggle the focused activity row in/out of the multi-select set.
z	undo mark-read	Re-unread the most recent auto-marked row.

j / k (or arrows) move the row cursor; →/l expand and ←/h collapse the focused row; w w works on the selection.

Terminal

A focused terminal forwards every key to the PTY; only the chords below are intercepted. ]] (the escape char, doubled) opens the terminal command menu.

Key	Action	What it does
Shift-PgUp/Dn	scroll	Scroll the terminal’s scrollback buffer.
Shift-X	close exited pane	Close an agent pane whose process has exited, from the pane itself — no ]] leader needed, since a frozen pane has no PTY to protect the keystroke from.
]]q	exit to sidebar	]] is a non-timed leader from the terminal: ]]q exits to the sidebar, ]]s opens snippets, ]]f toggles focus.

The ]] terminal leader

]] is a non-timed leader: after the two presses it waits for the command key. Esc or any unbound key cancels back into the terminal; a lone ] followed by any other key is sent to the program verbatim. The escape char is configurable (terminal.escape_char; the legacy ui.terminal_escape_char alias is still accepted).

Chord	Action
]]s	Open the snippet picker (typing a full key auto-submits — ]]srev)
]]l	Open the skills picker — trigger one of the focused agent’s skills explicitly (typing a full name auto-submits)
]]r	Restore the in-flight draft, or the last submitted agent prompt, without sending it
]]R	Restart the focused agent with fresh credentials (resumes its work only if it was blocked; an agent mid-turn is left alone)
]]h	Browse this session’s prompt history (newest-first, snippets tagged); Enter re-sends one
]]n	Send the follow-up declared by the last snippet sent here (next: in snippets.yaml)
]]u	Scan the visible terminal for URLs and open the picked one in the browser (a lone URL opens straight away)
]]f	Toggle focus mode
]]v	Cycle the focus-mode layout (single → split │ → split ─ → 2×2 grid over the starred roster); persists ui.focus_layout
]]q	Exit to the sidebar
]]`	Open the fuzzy jump-to-workspace picker
]]1…9	Jump to the Nth agent workspace (sidebar order)
]]|	Split the focused tile side-by-side (]]\ is an alias)
]]-	Split the focused tile stacked
]]←↓↑→	Move tile focus; Left/Right cycles tabs in Tabs mode
]]x	Close the focused terminal (tile or active tab)
]]H	Open the personal Hopper editor
]]z	Toggle tmux-style zoom of the focused tile (maximize / restore); Splits grid only
]]t	Switch this session’s terminals between tabs and side-by-side tiles, and set how the next one opens (persists ui.terminal_new_layout)

Scrollback

Key	Action
Shift-PgUp / Shift-PgDn	Scroll the scrollback
Shift-Home / Shift-End	Jump to the top / bottom
Ctrl-c	Forwarded to the program as an interrupt

Leader menus

Press the leader key, then the second key. Every menu shows a which-key popup while it waits.

w — work

w opens a deterministic work menu: press w w for the default or already-running agent, or choose an agent / model tier below. Nothing waits on a timeout, so the second key acts immediately.

Chord	Action
w w	work on this
w c	work in claude
w x	work in codex
w u	work in cursor
w S	Haiku
w M	Sonnet
w L	Opus

a — agent

Chord	Action
a R	restart stopped agents
a K	recover all credit
a c	spawn claude
a x	spawn codex
a u	spawn cursor
a S	Haiku
a M	Sonnet
a L	Opus

b — main branch

Chord	Action
b s	shell on main (confirmed first)
b c	claude on main (confirmed first)
b x	codex on main (confirmed first)
b u	cursor on main (confirmed first)

g — github

Chord	Action
g m	merge PR (confirmed first)
g u	update branch
g g	auto-merge on green
g t	track main
g p	policies
g r	reviewers
g a	assignees
g l	labels
g s	sync
g o	open in browser
g h	history
g i	browse issues
g d	delete / close (confirmed first)
g c	close PR (confirmed first)
g f	convert to draft
g y	mark ready
g v	review diff

x — workspace

Chord	Action
x n	floating workspace
x c	coordination workspace
x R	rename
x m	move to space
x p	new project
x i	import checkout
x r	add scan root
x o	open with
x a	adopt sessions
x s	send to session
x f	convert session
x j	join into PR
x z	long snooze (confirmed first)
x x	archive (confirmed first)
x C	close issue (confirmed first)
x k	close & kill (confirmed first)
x w	reset agent (confirmed first)
x $	meter
x h	compact context
x u	move up
x d	move down
x t	move to top
x b	move to bottom
x ,	source attention
x v	save view
x V	views
x A	add repo

E — epic

Chord	Action
E j	next blocked
E m	merge order
E g	graph view
E A	auto-dispatch
E R	auto-review
E M	merge in order
E r	set role
E p	spawn planner
E c	spawn coordinator

Mouse

• Click any pane to focus it; drag a splitter to resize.
• Right-click a sidebar row for the context menu; right-click a URL / path / #N reference inside a terminal to open it.
• The wheel scrolls the pane under the cursor (terminal scrollback included).
• The mouse-capture toggle (F8 / Alt-s / Ctrl-Alt-s) hands the mouse back to the host terminal for native text selection.

Pickers

The filter-as-you-type pickers — snippets (]]s), jump-to-workspace (`), and prompt history (]]h) — share one key protocol. Because typing filters the list, the letter keys go to the filter and the arrows (not j / k) move the selection:

Key	Action
↑ / ↓	Move the selection
Home / End	Jump to the first / last match
Enter	Confirm the highlighted row
(type) / Backspace	Edit the filter
Esc / Ctrl-c	Dismiss

The snippet picker adds two shortcuts on top of this protocol: typing a key that uniquely identifies one snippet submits it immediately (so ]]srev sends rev with no Enter), and Ctrl-F skips straight to free text in the broadcast flow.

The reviewers / labels / assignees picker (Choice) is a different modal — a multi-select with no filter, toggled with Space — so it does not follow the protocol above.