Codex Token Usage

Overview

Use the bundled script to read local Codex session logs and produce a consistent token usage report. Prefer deterministic script output over ad hoc rg summaries.

Workflow

1. Identify the reporting window from the user request.
   • If the user asks for "one month" or "last month" without naming a calendar month, use the last 30 local calendar days ending today.
   • If the user asks for "this month" or names a specific month, use that calendar month, clipped to today if it is the current month.
   • Use the user's timezone from context when available; default to the local machine timezone only if no timezone is provided.
2. Run scripts/codex_token_usage.py.
3. Report results in a table with these rows: total, input, cached input, output, reasoning output, non-cached input, net usage, cache hit rate, and daily average total.
4. Include the peak day and busiest week with exact dates.
5. State the net usage formula.

Script