Home

Tokmeter

Every AI coding agent you run, on one ledger.

Tokmeter reads the session files your AI coding agents already write to disk and turns them into token and cost totals by project, model, provider, and day — across Claude Code, Codex, Gemini CLI, Cursor, and 20+ more. No API keys, no telemetry, no account. Your usage data stays on your machine; the only network calls are an optional public price-catalog fetch (--light skips it) and the macOS app's update check.

npx -y @sriinnu/tokmeter --today

Start here

• Installation — CLI, daemon, MCP server, macOS app
• CLI reference — commands, filters, cleanup
• MCP & daemon — using tokmeter from an agent or over HTTP
• Troubleshooting — daemon, bar updates, "shrinking" history
• FAQ

Canonical docs (in the repo)

The repository is the source of truth; these pages summarize and link into it.

• MCP tool reference — all 24 tokmeter_ tools
• How the numbers work — bucket semantics, where estimates enter
• Backup, snapshot & restore — the confirmation/backup model
• Consuming tokmeter — integration guidance
• Architecture — daemon lifecycle, storage, refresh

Packages

• @sriinnu/tokmeter — core API, CLI, and TUI
• @sriinnu/tokmeter-mcp — MCP server, daemon, and statusline (was @sriinnu/drishti through 1.12.0)

Applications are AGPL-3.0-only; core source is MPL-2.0.