---
title: Web Dashboard
description: Browser-based agent dashboard with cards, sessions, traces, and themes.
---

Launch the web dashboard:

```bash
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:

```bash
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
