Skip to Content
agent-stats

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

  1. Install a release binary for your operating system.
  2. Run a session with a supported coding agent.
  3. Open a seven-day report across all projects.
agent-stats --all --since 7d --plain

The 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

InterfaceCommandBest for
Interactive terminalagent-statsBrowse usage, sessions, and flagged prompts without leaving the terminal
Local dashboardagent-stats serveInspect charts and sortable tables in your browser
Text reportagent-stats --plainRead or save a report without an interactive session
JSON reportagent-stats --all --jsonFeed your own scripts or reporting tools
Agent analysisagent-stats query overview --since 7dFollow statistics to specific requests and sessions

The local dashboard reads your local index. This public website uses sample data.

On this page