Codex Usage Tracker

Codex Usage Tracker turns local Codex session metadata into exact, bounded facts an agent or developer can explore and explain: session, turn, tool call, resource, allowance, token, credit and cost data, surfaced through a six-tool MCP interface, an Evidence Console, and a local SQLite kernel. Version 0.28.0 is the current public release of this design.

The project's next direction is a cleaner, agent-first kernel rather than a larger dashboard: fast setup covering anywhere from the last 24 hours to all-time history, incremental reuse on later runs, compact named queries and stable evidence selectors, and agent-owned interpretation instead of server-written narrative findings; the 0.28 code stays available as a frozen reference during that rewrite. It installs with pipx and registers as a Codex plugin marketplace entry. Development uses synthetic fixtures only; real Codex logs, prompts, outputs or credentials are never committed or shared.