TUI Keybindings
Agent List
Section titled “Agent List”| Key | Action |
|---|---|
Enter | Open split view (trace + session) |
j / k | Move selection down/up |
Tab / x | Expand/collapse process tree |
* | Pin/unpin session (star) |
B | Open starred sessions tab |
S | Open sessions browser |
t | Open trace view |
c | Open costs view |
/ | Search across agent traces |
$ | Toggle cost-per-turn display |
d | Toggle diff view |
F | Focus the agent’s own terminal pane in iTerm2 (agents in tmux get the attach command instead) |
s | Cycle sort order (name, cost, cpu, mem, age, model) |
m | Mute/unmute notifications |
:new | Open agent launcher |
? | Show help overlay |
q | Quit |
What a session is doing
Section titled “What a session is doing”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 installadds 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).
Split View (Trace + Session)
Section titled “Split View (Trace + Session)”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.
| Key | Action |
|---|---|
j / k | Next/previous turn; inside an expanded turn, scroll it line by line |
J / K | Scroll an expanded turn by 10 lines |
n / p or Space | Next/previous turn, even when the current one is expanded |
Enter | Expand or collapse the selected turn |
a | Cycle the turn’s label: GOOD, BAD, WASTE, none |
N | Add a note to the current turn |
g / G | Jump to the first/last turn |
c | Collapse all turns |
/ | Filter turns (Esc clears the filter) |
e | Open export menu |
Tab | Switch focus between trace and session panes |
Ctrl+f | Full-screen the focused pane |
Ctrl+] or Ctrl+g | Close 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.
Export Menu
Section titled “Export Menu”| Key | Action |
|---|---|
j | Export as JSONL to ~/.aimux/exports/ |
o | Export as OTEL to configured endpoint |
Esc | Cancel |
Sessions View
Section titled “Sessions View”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.
| Key | Action |
|---|---|
j / k | Move selection down/up |
g / G | Jump to top/bottom |
Enter | Resume selected session |
/ | Filter by title, prompt, project, tags |
P | Filter by directory path |
F | Deep content search inside session files (ranked index; see note below) |
s | Cycle sort order (age, cost, turns, title, failure mode) |
A | Toggle between current directory and all projects |
a / v | Cycle annotation (achieved, partial, failed, abandoned) |
f | Set failure-mode tag |
N | Add/edit note |
C | Copy session ID to clipboard |
p | Toggle trace preview pane |
d | Delete session (with confirmation) |
D | Cleanup mode (find duplicates/empty sessions) |
H | Show/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 |
Esc | Clear 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.
Cross-Session Search
Section titled “Cross-Session Search”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.
Command Palette
Section titled “Command Palette”Type : to open the command palette:
| Command | Action |
|---|---|
:new | Launch new agent session |
:export-otel | Export current trace via OTEL |