01 / Session
Live rolling 5-hour window
Watch the Pro/Max session quota tick down as you prompt, so you know when to stop before Claude cuts you off mid-refactor.
→ updates every 60 seconds
macOS 12+ · MIT · No telemetry
Your Claude plan usage, live in the menu bar.
01Built for
Built for the people Anthropic’s rolling quota change hit hardest.
Claude Max developers running agentic loops. Claude Pro heavy writers hitting the weekly wall midweek.
02 / Weekly
Weekly quota and reset clock
See how much of the 7-day allowance you have left and exactly when it rolls over, not a vague 'try again later' banner.
→ reset timestamp to the minute
$
03 / Spillover
Extra-usage balance
Track your pay-as-you-go spillover in dollars, so the metered billing Anthropic rolled out in 2026 stops being a surprise.
→ current billing cycle total
04 / Auth
Browser extension auto-auth
Install the Chrome/Arc/Brave extension and it forwards your existing claude.ai session. No DevTools, no manual cookie paste.
→ Chrome · Arc · Brave
05 / Privacy
No telemetry, MIT license
Rust source on GitHub. The only network egress is claude.ai itself. No analytics, no accounts, no upsell.
→ auditable · written in Rust
$ claude
62% · $3.40
$ _
62% · $3.40
$ _
06 / CLI
CLI included
Pipe the same numbers into shell prompts, tmux status lines, or scripts. Useful next to ccusage, which tracks something different.
→ tmux · starship · zsh prompt
02Comparison
ClaudeMeter vs ccusage.
They solve different problems. ccusage reads local Claude Code JSONL; ClaudeMeter reads the plan quota Anthropic actually enforces.
| Feature | ClaudeMeter | ccusage |
|---|---|---|
| Reads server plan quota (5h / weekly) | ✓Yes | —No |
| Reads local Claude Code token JSONL | —No (by design) | ✓Yes |
| Browser extension auto-auth | ✓Yes | —N/A |
| macOS menu bar UI | ✓Yes | —CLI only |
| License | ✓MIT | ✓MIT |
03Why people install it
From the threads where people find out the hard way.
I typed 'test one two three' into Claude Code. That put me at 12%.
Hacker News ↗#47586176
Max 20x subscriber at $200/month. Getting rate-limited on every Claude surface with only 18% session used.
claude-code #41212 ↗GitHub
I used it a little Friday, a little Saturday, maybe 10 minutes Monday, and I hit the weekly limit already.
claude-code #9424 ↗GitHub
04Install
Stop getting surprised by “message limit reached”.
ClaudeMeter reads the server-truth numbers Anthropic enforces for Pro and Max: the rolling 5-hour window, the weekly quota, and the extra-usage balance. No cookie pastes. No token guesswork.
5h62%Week41%$3.40