Skip to content

TUI Keybindings

KeyAction
EnterOpen split view (trace + session)
j / kMove selection down/up
Tab / xExpand/collapse process tree
*Pin/unpin session (star)
BOpen starred sessions tab
SOpen sessions browser
tOpen trace view
cOpen costs view
/Search across agent traces
$Toggle cost-per-turn display
dToggle diff view
FFocus the agent’s own terminal pane in iTerm2 (agents in tmux get the attach command instead)
sCycle sort order (name, cost, cpu, mem, age, model)
mMute/unmute notifications
:newOpen agent launcher
?Show help overlay
qQuit

The agent list, its preview, the header counts and the sessions view use the words the phone uses, from one answer aimux computes for every surface:

  • needs you: a permission prompt waits (Claude Code’s session registry reports it; aimux remote hooks install adds the alerts, see Permission alerts). The LAST column says “needs you” in amber.
  • working: Claude Code’s registry says the session is busy. Harnesses without a registry (Codex) fall back to reading the transcript’s last lines.
  • idle: open in a terminal and not working.

An error (a crash or a full context) keeps its ✕ and the word “Error”. The hooks’ markers are read by the TUI itself; remote serve need not run. Without the hooks a permission prompt still shows as needs you when Claude Code’s registry reports the session waiting, and the header and help say, muted, “Permission alerts need aimux remote hooks install” (checked at start and every 5 minutes).

Opening a running agent starts with focus on the trace. Resuming a past session or opening an OpenShell sandbox session starts with focus on the session pane: press Tab before using the trace keys below.

KeyAction
j / kNext/previous turn; inside an expanded turn, scroll it line by line
J / KScroll an expanded turn by 10 lines
n / p or SpaceNext/previous turn, even when the current one is expanded
EnterExpand or collapse the selected turn
aCycle the turn’s label: GOOD, BAD, WASTE, none
NAdd a note to the current turn
g / GJump to the first/last turn
cCollapse all turns
/Filter turns (Esc clears the filter)
eOpen export menu
TabSwitch focus between trace and session panes
Ctrl+fFull-screen the focused pane
Ctrl+] or Ctrl+gClose split view

Esc does not close the split view: it is sent to the agent’s terminal, so the agent’s own shortcuts (cancel, reverse search) keep working.

KeyAction
jExport as JSONL to ~/.aimux/exports/
oExport as OTEL to configured endpoint
EscCancel

A session’s title is the one you wrote, else the name you gave it with Claude Code’s /rename, else one aimux generated, else Claude Code’s own name for it, else its first message. The dashboard, aimux sessions, search and the phone clients choose it the same way. / also matches that title.

A session that is open leads its title with what it is doing: needs you (in amber), working or idle, as in the agent list.

KeyAction
j / kMove selection down/up
g / GJump to top/bottom
EnterResume selected session
/Filter by title, prompt, project, tags
PFilter by directory path
FDeep content search inside session files (ranked index; see note below)
sCycle sort order (age, cost, turns, title, failure mode)
AToggle between current directory and all projects
a / vCycle annotation (achieved, partial, failed, abandoned)
fSet failure-mode tag
NAdd/edit note
CCopy session ID to clipboard
pToggle trace preview pane
dDelete session (with confirmation)
DCleanup mode (find duplicates/empty sessions)
HShow/hide subagent and automated sessions. Automated ones show in full; a subagent session stays hidden if it is near-empty (no cost, at most 5 turns) or an analyzer session (aimux’s own analysis or hook prompts, or mentioning “session analyzer”). Near-empty, analyzer and undated sessions stay hidden otherwise; any search shows every session
EscClear filters (path first, then text), then exit view

F searches the same ranked index as aimux sessions: keyword ranking, plus semantic ranking when OPENAI_API_KEY is set. The TUI refreshes the index when it starts and embeds changed sessions in the background, so a search doesn’t wait for them; only a new query’s own embedding calls the API (cached after the first time). New messages match by keyword right away and usually join semantic ranking within seconds. If more than 20 sessions changed at once, they are not embedded automatically; run aimux sessions index to catch up. If the embedding API is unreachable, the work stays queued and the next search retries it, even if no files changed. One exception: when the index was written by a newer aimux build (several builds can share the file, one per open session), an older build uses it as it is without refreshing and logs a note once, and aimux sessions index refuses to rebuild it; update aimux to bring that build’s search up to date.

Press / from the agent list to search across all active agent traces. Type a query (file name, function, error message) and aimux highlights matching sessions. This searches inside the trace content, not just session titles.

Type : to open the command palette:

CommandAction
:newLaunch new agent session
:export-otelExport current trace via OTEL