Token Meter

Token Meter vs ccusage

Both projects read the JSONL logs Claude Code and Codex already write and turn them into usage numbers — this is a use-case comparison of what each one does with that data, not a ranking. Where a claim about ccusage couldn't be verified against its published docs, it's marked as such below rather than guessed at.

Last reviewed: 2026-07-15 — feature sets and pricing on both projects change; check the linked repos for the current state.

ccusage is an MIT-licensed CLI by ryoppippi for reporting token usage and estimated cost across a broad set of coding-agent CLIs. Its guide describes daily / weekly / monthly / session reports, JSON export, a 5-hour billing-block view, a beta statusline integration, and a separate @ccusage/mcp package.

Token Meter (this project) ingests Claude Code and Codex JSONL logs into a local SQLite database and layers a session / tool / MCP-server efficiency audit on top — the audit command, the dashboard's tool breakdown, and four read MCP tools. See this repo's README and docs/audit.md for the source of the claims below.

Use-case comparison

Dimension ccusage Token Meter
Primary use case Usage / estimated-cost reporting CLI across many coding-agent CLIs. Local dashboard + MCP server for Claude Code and Codex, with a session / tool / MCP-server efficiency audit layered on the same ingested data.
Supported sources Per its README: Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, and Gemini CLI (15 listed). Ingests Claude Code (~/.claude/projects/) and Codex (~/.codex/sessions/) JSONL logs. A separate proxy command captures TTFT/TPS from a locally-run OpenAI-compatible model (e.g. Ollama, LM Studio, llama.cpp, vLLM) — a different mechanism from log ingest.
Data handling Its README states the tool runs "100% Local," that "Your usage data never leaves your computer," and that it reads files without modifying them. Stores parsed data in a local SQLite file (~/.tokenpulse/usage.db). Per this repo's README, no prompt or response bodies are stored by default — metadata (timestamps, token counts, tool names, response lengths) is all that's kept — and it makes no network calls to either vendor's API.
Audit depth Documents usage/cost tables (daily, weekly, monthly, session, 5-hour blocks) with a per-model --breakdown flag. Its published docs don't describe an anomaly- or waste-flagging feature as of this review. token-meter audit runs six detectors over ingested history — expensive sessions, oversized tool responses, slow tools, repeated calls, cache waste, and a high-cost-model usage signal — ranked by cost and confidence, with terminal and --json output. Findings are worded as neutral observations for a human to review, not verdicts.
Per-tool / MCP-server breakdown Not documented in its guide as of this review. Tracks tool_name, mcp_server, response size, and latency per call. No call arguments are stored beyond a lowercased file extension when a tool call touched a file path — never the path itself or any other input field.
Output modes Terminal tables, JSON export, a 5-hour billing-block live view, a beta statusline integration, and a separate @ccusage/mcp server package (reported to mirror the daily / monthly / session / blocks commands over MCP). Terminal tables (stats, subagents, local, audit), --json audit export, a local web dashboard (servehttp://localhost:8765), and an MCP server (mcp) exposing four read tools: usage_summary, recent_sessions, session_tools, refresh_data.
Cost-figure disclaimer Its docs state costs "are estimates and may not reflect actual billing." This repo's README states cost figures are estimates computed locally from token counts × a published per-model rate table, and are not validated against an actual Anthropic / OpenAI invoice.
License MIT. MIT for the CLI, dashboard, and parsers. Pro-tier features ship in a separate package under a closed-source license.

Notes on this comparison

Sources: github.com/ryoppippi/ccusage · github.com/whdrnr2583-cmd/token-meter · docs/audit.md