oc-stats

CLI tool to analyze OpenCode usage statistics — requests, tokens, cost, broken down by time period or model.

Screenshots

Default — Today's summary:

Daily breakdown:

Model breakdown:

Install

npx oc-stats

Or install globally:

npm install -g oc-stats

Usage

# Today's summary (default)
oc-stats

# Time period breakdown
oc-stats daily
oc-stats weekly
oc-stats monthly
oc-stats yearly

# Model breakdown
oc-stats models

Filters

All commands support the following flags, and they can be combined freely:

| Flag | Description | Example | | --- | --- | --- | | -m, --model <model> | Filter by model | -m anthropic/claude-opus-4-6 | | --from <date> | Start date (YYYY-MM-DD) | --from 2026-02-01 | | --to <date> | End date (YYYY-MM-DD) | --to 2026-02-08 |

# Daily stats for a specific model
oc-stats daily -m anthropic/claude-opus-4-6

# Model breakdown for a date range
oc-stats models --from 2026-02-03 --to 2026-02-08

# Combined
oc-stats weekly -m openai/gpt-5.3-codex --from 2026-01-01 --to 2026-02-01

Data Source

Reads OpenCode's local storage at ~/.local/share/opencode/storage/message/.

Development

pnpm dev              # Run with tsx (no build needed)
pnpm build            # Build with tsup
pnpm test             # Run tests

License

MIT