Token Meter

Your meter for
Claude Code & Codex.

Local-first dashboard that shows how many tokens you spent, where they went, and how fast each model and MCP tool actually runs. Your JSONL never leaves your machine.

Free + MIT licensed core, available now. Pro ($5) and Pro+ ($24) ship later — no charge today.

npm install -g @whdrnr2583/token-meter
token-meter ingest && token-meter serve

Why Token Meter

📊 Multi-vendor in one view

Claude Code ~/.claude/projects/ and Codex ~/.codex/sessions/ merged. No SDK, no proxy.

🔍 MCP & tool breakdown

See exactly which MCP server eats your tokens and which tool is slow. Latency, response size, call count.

💵 USD-equivalent cost

Your Max plan is a flat fee — but what would the API have cost? Token Meter shows the saving (or burn). Estimates only — not your actual invoice.

🏠 Local-first, private

SQLite in ~/.tokenpulse/ (renamed to ~/.tokenmeter/ in a future release with an automatic migration). No upload, no cloud account required for the free tier.

⚡ MIT licensed core

The CLI and dashboard are open source. Fork it, audit it, ship it.

🕒 Time-of-day insight

Find your most expensive hours, your slowest periods, and the days that blew up the budget.

🔔 Smart alerts

Threshold rules with desktop, email, and webhook actions. Pipe into Slack, Discord, n8n — your call.

Pricing

Free

$0

  • Claude Code + Codex parsing
  • MCP & tool breakdown
  • Project / model / hour breakdown
  • 7-day history
  • USD-equivalent cost
  • 1 desktop alert rule

Pro after beta

$5/mo

  • Everything in Free
  • 30-day history
  • Smart alerts unlimited — desktop, email, webhook, weekly digest
  • Session drill-down — find the exact session that blew the budget
  • Cost forecast & pace alerts — "month-end will be $X"
  • CSV / JSON export
  • Custom pricing matrix — apply your contracted API rates
  • Weekly recommendations
  • Anonymous benchmark comparison
  • Auto-trim rule suggestions

After payment we email your license key (tm_live_...) to your Polar checkout email. Activate with token-meter activate <key>. Full Pro spec →

Pro+ later

~$24/mo

  • Unlimited history
  • Local LLM proxy (Ollama, LM Studio, llama.cpp, vLLM)
  • GPU / VRAM tracking — millisecond TTFT/ITL
  • Behavior-changing automation (MCP auto-trim, model switching, cloud↔local routing)
  • Model benchmark lab
  • Multi-machine sync (encrypted)
  • PDF reports (auto-emailed)

Substantial engineering — ships when the proxy + per-OS GPU work is scheduled in. Not before Pro $5 is live. Full Pro+ spec →