release_queue / claude_token_meter
Claude Token Meter
A macOS menu bar app that tracks your Claude Code token usage — today, this week, this month — by reading the session logs Claude Code already writes to disk. No API key, no network access, nothing leaves your machine.
Private beta — builds are distributed by link on request.
how it stays live
Hundreds of megabytes, read every 30 seconds.
The session logs are large, so the scan skips any line without a
"usage"
key and splits the
remaining files across all cores.
:scan
Parallel reads
Entries are deduplicated by
message.id + requestId
—
the same approach tools like ccusage use.
:cache
One background thread
A Rust thread re-reads the logs every 30 seconds and keeps the parsed snapshot both windows are served from, so the popover opens with the numbers already in hand.
:label
Computed in Rust
The menu bar label has to be built in Rust rather than in the popover, because macOS suspends a hidden webview's timers.
what it reads
Local files, and only local files.
Usage comes from ~/.claude/projects/**/*.jsonl,
the logs Claude Code already writes. The app also checks
$CLAUDE_CONFIG_DIR/projects
and ~/.config/claude/projects
if you've
moved Claude Code's config. There is no API key and no network call.
worth knowing
- Cost is an estimate. Rates use Anthropic's list API prices. On a Pro/Max subscription tokens aren't billed individually — read the number as "API-equivalent value".
- Old months may under-report. Claude Code prunes session logs after a retention period.
- macOS only, for now — it's a menu bar app built on Tauri 2 with a Rust core.
access
Builds go out by link.
Claude Token Meter is in private beta. Signed
.dmg
builds are shared
individually rather than posted publicly — ask and we'll send you one.