Agent Stats
Agent Stats gives you per-agent analytics cards showing command counts, success rates, average durations, risk breakdowns, and the most-used commands — so you can understand how each AI agent is using your terminal.
Usage
suv agent statsThis displays an interactive TUI with analytics cards for each detected agent. The data comes from commands recorded by Suvadu's agent tracking.
Flags
| Flag | Description |
|---|---|
-d / --days <N> | Number of days to include in the stats (default: 30) |
--executor <NAME> | Show stats for a specific agent only (e.g., claude-code, cursor) |
--text | Output plain text instead of the interactive TUI (useful for piping or scripting) |
What the Stats Show
Each agent gets its own analytics card displaying the following metrics:
Summary Metrics
- Total commands — the number of commands this agent has executed in the selected time period
- Success rate — percentage of commands that exited with code 0
- Average duration — mean execution time across all commands from this agent
Risk Breakdown
A breakdown of commands by risk level, showing how many commands fell into each category:
- Critical — destructive operations like
rm -rf /orDROP TABLE - High — potentially dangerous operations like
chmod 777ornpm install - Medium — operations that modify state like
git resetordocker run - Low — minor modifications like file writes or branch operations
- Safe — read-only operations like
git status,ls, orgrep
Top Commands
A ranked list of the most frequently used commands by this agent, showing the command text and how many times it was run.
Top Directories
A ranked list of the directories where this agent executed the most commands, showing which projects or areas of your filesystem the agent works in most.
High-Risk Commands Table
A table listing all commands from this agent that were classified as High or Critical risk, with timestamps and exit codes. This gives you a quick audit trail of the most consequential actions each agent has taken.
Examples
Last 7 days of agent stats
suv agent stats --days 7Shows analytics cards for all agents over the past week. Useful for a weekly review of agent activity.
Cursor-specific stats as plain text
suv agent stats --executor cursor --textOutputs Cursor's analytics in plain text format, suitable for piping to other tools or including in reports.
Full 30-day overview
suv agent statsDefault view: 30-day analytics for all detected agents in the interactive TUI.