| # Codex Usage Profiler | |
| Local CLI for summarizing Codex usage from `~/.codex/state_5.sqlite` and rollout | |
| JSONL files. | |
| It reports: | |
| - daily and ISO-week token totals | |
| - tokens by cwd, model, role, and main vs subagent | |
| - top sessions | |
| - optional rollout token breakdowns for input, cached input, output, and | |
| reasoning tokens when those events exist | |
| - Markdown and static HTML output | |
| ## Usage | |
| ```bash | |
| python3 -m codex_usage_profiler | |
| ``` | |
| Default output is written to: | |
| - `reports/codex-usage.md` | |
| - `reports/codex-usage.html` | |
| Useful options: | |
| ```bash | |
| python3 -m codex_usage_profiler \ | |
| --state ~/.codex/state_5.sqlite \ | |
| --sessions-dir ~/.codex/sessions \ | |
| --out reports \ | |
| --format both \ | |
| --tz Europe/Berlin \ | |
| --days 30 \ | |
| --top 25 | |
| ``` | |
| `--days N` includes the last `N` local calendar days including today. Week | |
| buckets use ISO weeks, starting on Monday. | |
| The report never includes raw prompts, messages, command output, or model | |
| responses. It only uses metadata and token counters. | |
| ## Development | |
| Run tests with: | |
| ```bash | |
| python3 -m unittest discover -s tests | |
| ``` | |