---
title: TUI Keybindings
description: Keyboard shortcuts for the terminal dashboard.
---

## 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 |
| `s` | Cycle sort order (name, cost, cpu, mem, age, model) |
| `m` | Mute/unmute notifications |
| `:new` | Open agent launcher |
| `?` | Show help overlay |
| `q` | Quit |

## Split View (Trace + Session)

| Key | Action |
|-----|--------|
| `j` / `k` | Scroll trace up/down |
| `g` | Annotate turn as GOOD |
| `b` | Annotate turn as BAD |
| `w` | Annotate turn as WASTE |
| `n` | Add note to current turn |
| `e` | Open export menu |
| `Esc` | Close split view |
| `Tab` | Switch focus between trace and session panes |

## Export Menu

| Key | Action |
|-----|--------|
| `j` | Export as JSONL to `~/.aimux/exports/` |
| `o` | Export as OTEL to configured endpoint |
| `Esc` | Cancel |

## Sessions View

| 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 (ripgrep inside session files) |
| `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 sessions |
| `Esc` | Clear filters (path first, then text), then exit view |

## 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

Type `:` to open the command palette:

| Command | Action |
|---------|--------|
| `:new` | Launch new agent session |
| `:export-otel` | Export current trace via OTEL |
