usage-statslisted
Install: claude install-skill espensev/ai-skills
# Usage Stats — Usage, Cost & Agent Analytics
Unified analytics over token consumption, session activity, and agent
performance — the former `token-audit`, `session-stats`, and `agent-report`
skills merged over a single shared data layer.
**All commands run to completion autonomously.**
**Config:** `.codex/skills/project.toml` — `[usage-stats]` and `[pricing]` sections (optional)
---
## Commands
Three routed groups. Default to `summary` if no command given.
**Token & cost intelligence** (formerly token-audit):
| Command | Usage | Purpose |
|---------|-------|---------|
| `cost` | `$usage-stats cost` | Current token position, burn rate, budget check |
| `breakdown` | `$usage-stats breakdown` | Per-tool and per-turn token cost attribution |
| `budget` | `$usage-stats budget [set <N>\|check\|reset]` | Session or daily budget management |
| `forecast` | `$usage-stats forecast` | Rate-limit proximity and depletion forecast |
| `history` | `$usage-stats history [N]` | Usage trends across last N sessions (default 7) |
**Session analytics** (formerly session-stats):
| Command | Usage | Purpose |
|---------|-------|---------|
| `summary` | `$usage-stats` or `$usage-stats summary` | Quick session overview |
| `closeout` | `$usage-stats closeout` | Compact end-of-execution outcome, time, tokens, evidence, and risk |
| `tools` | `$usage-stats tools` | Tool usage breakdown with counts and patterns |
| `timeline` | `$usage-stats timeline` | Activity timeline with phases |
| `comp