Get started with agent-stats
Measure how you use AI coding agents with the session logs already on your machine.
agent-stats reads local session logs and reports requests, tokens, estimated cost, cache usage, and tool calls. Use it to compare models, inspect an expensive session, or find prompts you keep repeating.
Run your first report
- Install a release binary for your operating system.
- Run a session with a supported coding agent.
- Open a seven-day report across all projects.
agent-stats --all --since 7d --plainThe report starts with the scope and totals, followed by breakdowns by coding agent, model, project, and tool. Read your first report explains what the numbers mean.
Choose an interface
| Interface | Command | Best for |
|---|---|---|
| Interactive terminal | agent-stats | Browse usage, sessions, and flagged prompts without leaving the terminal |
| Local dashboard | agent-stats serve | Inspect charts and sortable tables in your browser |
| Text report | agent-stats --plain | Read or save a report without an interactive session |
| JSON report | agent-stats --all --json | Feed your own scripts or reporting tools |
| Agent analysis | agent-stats query overview --since 7d | Follow statistics to specific requests and sessions |
The local dashboard reads your local index. This public website uses sample data.