douglasmonsky/codex-usage-tracker

View on GitHub ↗

Local-first MCP tools and dashboard for investigating Codex token usage, credits, costs, caching, and thread patterns.

194 ★18 forksPythonUpdated 23d ago

What you need to know

Local usage-data product that turns Codex session metadata into exact totals of tokens, time, tool calls, allowances, credits and cost

Install

pipx install "codex-usage-tracking==0.28.0"
codex plugin marketplace add douglasmonsky/codex-usage-tracker --ref v0.28.0
codex plugin add codex-usage-tracker@codex-usage-tracker

Usage

  • •Install the plugin, then start a fresh Codex task to discover the new plugin tool catalog
  • •Answer questions about how Codex work consumes tokens, time, allowance and cost

Key features

  • ✓Six-tool MCP surface
  • ✓Evidence Console and SQLite kernel
  • ✓Exact session, turn, call, tool, resource, allowance, token, credit and cost facts

Best for

Tracking OpenAI Codex CLI usage, costs and credits from local session metadata

Caveats

  • ⚠Current 0.28 release is frozen and will be removed before the replacement release
  • ⚠The new runtime does not migrate or open its database
  • ⚠Do not commit or share real Codex logs, prompts or credentials

Reviewed 2026-08-11

Topics

clicodexcodex-clicodex-plugincodex-skillcost-analysisdashboarddeveloper-toolsllm-observabilitylocal-firstmcpmodel-context-protocolopenaiprivacy-firstprompt-cachingpypipythonsqlitetoken-usageusage-analytics
Stars
194★
Forks
18
Language
Python
License
MIT
Created
2026-05-17
Last push
2026-08-12