# Codex Usage Tracker

A local-first MCP tool and dashboard for investigating how Codex CLI work consumes tokens, time, tools, allowance, credits and cost, and for spotting caching and thread patterns.

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.

Website: https://github.com/douglasmonsky/codex-usage-tracker