Web Dashboard

Launch the web dashboard:

aimux web              # default port 9090
aimux web --port 8080  # custom port

Card Grid

The main view shows agent cards grouped by project. Each card displays:

• Provider badge (Claude, Codex, Gemini) with color coding
• Status (Active, Idle, Waiting, Error)
• Launch mode badge (tmux or direct)
• Title from the session’s first prompt or auto-generated
• Project name and git branch
• Last activity snippet showing the most recent tool call
• CPU% and memory usage with color-coded thresholds
• Model, token counts, and cost

Click a card to toggle the trace panel. Click again to close it.

Views

Toggle between views using the tab bar:

• Live Agents - Live agent cards with filtering and sorting
• Sessions - Historical session table with search
• Plugin tabs - Custom dashboards from plugins (e.g., Skill Dashboard)

List vs Card View

Toggle between card grid and compact list view using the view mode buttons in the filter bar (grid/list icons). Both views show CPU%, memory, token counts, and cost per agent.

Filtering and Sorting

The filter bar provides:

• Status filters: All, Active, Idle, Waiting, Error
• Provider filters: Claude, Codex, Gemini
• Recent filter: Show only agents active in the last 5 minutes
• Text search: Filter by project name or branch
• Content search: Search inside session traces across all agents
• Sort: Last Active, Cost, Tokens

Right Panel

Selecting an agent opens the right panel with three tabs:

• Trace: Turn-by-turn conversation with tool calls, inline diffs, and outputs
• Diffs: PR-style diff review with hierarchical file tree, line-numbered diffs, and per-file stats
• Session: Live terminal with “Review Diffs” split view (diffs auto-refresh alongside the session)

Additional features:

• Annotations: Label turns as good/bad/waste with notes
• Export: JSONL to ~/.aimux/exports/ or OTEL to configured endpoint
• Fullscreen: Expand the panel to fill the viewport
• Resizable: Drag the panel border or the split divider to resize

Session History

Click the Sessions tab to browse past agent sessions. The sessions table shows:

• Provider and project name
• Title (auto-generated or from first prompt)
• Age since last activity
• Turn count, token usage, and cost
• Resumable indicator for sessions that can be continued
• Star icon: Click to pin/unpin sessions for quick access

Starring Sessions

Click the star icon (☆/★) on any session row or agent card to pin it. Starred sessions:

• Sort to the top of the sessions list
• Appear in the dedicated ★ Starred tab (with count)
• Persist across restarts (stored in .meta.json sidecar files)
• Show on agent cards in the Agents tab

Title Generation

Click Generate Titles in the sessions toolbar to auto-generate LLM titles for untitled sessions.

Click any row to open its trace in the right panel. The toolbar provides two filter inputs:

• Filter sessions: Search by title, prompt, project, annotation, or tags
• Filter by path: Narrow to sessions in a specific directory (type a directory name like “research” or “aimux”)

Both filters stack: filter by path first, then search within those results. Use the content search (ripgrep) for deep matches inside session files.

CLI Session Commands

You can also browse sessions from the terminal:

aimux sessions --list              # table output
aimux sessions --list --json       # JSON output
aimux sessions "query" --list      # search by keyword
aimux sessions --export            # JSONL for pipelines
aimux resume <id>                  # resume a session
aimux resume <id> --dry-run --json # preview resume command

Cross-Session Search

Search across all agent traces to find specific files, functions, or topics:

• Web: Use the “Search inside sessions…” input in the filter bar. Results show session ID, file path, and a snippet of the matching content.
• TUI: Press / to search across all active agent traces.

This is useful for questions like “which agent edited auth.go?” or “who ran the database migration?”.

Dark/Light Theme

Toggle between dark and light themes using the sun/moon button in the header bar. The preference is saved to localStorage and persists across sessions.

• Dark: Pure black base (#000000), red accent (#FF3131)
• Light: Light grey base (#F5F5F5), Red Hat Red accent (#EE0000)

Stats Bar

The header shows aggregate statistics:

• Session count, active/idle/waiting/error counts
• Repository count
• Total tokens in/out
• Total cost across all agents