Agent Dashboard
The Agent Dashboard is an interactive TUI that shows you exactly what your AI agents are doing — every command, its risk level, exit status, and timing — in a single real-time view.
Opening the Dashboard
suv agent dashboardThis opens the interactive terminal UI. The dashboard requires that agent tracking is set up for at least one agent. If no agent commands have been recorded yet, the dashboard will be empty.
Flags
| Flag | Description |
|---|---|
--after <TIME> | Show commands after a specific time (e.g., "3 days ago", "2025-01-15") |
--executor <NAME> | Filter to a specific agent (e.g., claude-code, cursor) |
--here | Only show commands from the current directory |
What the Dashboard Shows
Summary Panel
At the top of the dashboard, a summary panel displays aggregate metrics for the selected time period:
- Agent count — how many distinct agents have run commands
- Total commands — the total number of agent-executed commands
- Success rate — percentage of commands that exited with code 0
- Risk counts — breakdown of commands by risk level (Critical, High, Medium, Low, Safe)
Command Timeline
Below the summary, a chronological timeline lists every agent command. Each entry shows:
- Timestamp — when the command was executed
- Risk level indicator — a visual marker showing the assessed risk (
!!for Critical/High,~for Medium,.for Low,okfor Safe) - Exit status — success (green) or failure (red) with the exit code
- Command text — the full command that was executed
- Executor — which agent ran it
- Directory — the working directory at time of execution
Search and Keyboard Shortcuts
Type to live-filter the command timeline. Letters and digits are search text, so actions use Ctrl shortcuts.
| Key | Action |
|---|---|
| Up / Down | Navigate commands |
| Left / Right | Previous / next page |
| Home / End | First / last row on the current page |
| Tab | Toggle command detail |
| Ctrl+F | Cycle Today, 7 days, 30 days, and All time |
| Ctrl+A | Cycle the executor filter |
| Ctrl+R | Toggle Medium-and-above risk filtering |
| Ctrl+P | Open the Prompt Explorer |
| Ctrl+Y | Copy the selected command |
| Esc | Quit |
Examples
Monitor recent Claude Code activity
suv agent dashboard --after "3 days ago" --executor claude-codeOpens the dashboard filtered to Claude Code commands from the last 3 days. Use the Ctrl+R key to quickly filter down to only risky commands.
Check agent activity in the current project
suv agent dashboard --hereShows only agent commands that were executed in the current working directory and its subdirectories.
Review all agent activity today
suv agent dashboardOpens the dashboard with the default time period. Press Ctrl+F to cycle through the available time ranges.
Ctrl+P in the dashboard to jump directly into the Prompt Explorer and see which prompts triggered the commands you're looking at. This is especially useful for understanding why an agent ran a particular sequence of commands.