Repository navigation
Releases
v1.1.2
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
Fixed in v1.1.2
Update if you're on any earlier 1.1.x. Two more causes of the "rate
limited — backing off" screen, both about the dashboard asking too often:
- Only one dashboard can run at a time now. Anthropic's rate limit is per
account, not per window, and the usage endpoint only has room for about one
request every couple of minutes. Two copies polling the same login will
rate-limit each other however politely each behaves alone — and a second copy
is easy to end up with by accident. It now says "already running" and closes
instead of competing. - Being rate-limited no longer makes it poll faster. The first retry after a
429 was a fixed 60 seconds while the normal poll is 120 — so hitting the limit
doubled the request rate until the back-off grew. Retry waits are now floored
at whatever your poll interval is.
(v1.1.1 fixed the same class of problem in the R key: its cooldown was 5s,
and a refused press gave no feedback, so people pressed it again. It's now 30s
with a visible [R] in 22s countdown.)
What's new in v1.1.x
- Per-model usage tracking. Weekly per-model caps now get their own bars
(Fable,Opus, …) under the overall 7-day window — the same breakdown the
in-app usage screen shows. These had silently stopped appearing: Anthropic
moved the data into a new field, and the dashboard was still reading the old
one. - A "nearest limit" line naming whichever window is furthest along. Worth
watching — a per-model cap is often further along than your overall weekly
bar, so it's the one you'll actually hit first. - Press
Rto refresh on demand.
(Earlier 1.0.x releases added live-ticking reset countdowns, a tunable poll
interval, automatic back-off for rate limits, and a clean single-screen error
state.)
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour, weekly (7-day) and per-model usage with live, colour-coded bars
- Live reset countdowns and extra-usage credits
- Fetches every 120s (or press
R); strictly read-only — never touches
your login
See the README for details and known limitations.
v1.1.1
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
Fixed in v1.1.1
Update if you're on v1.1.0. The R refresh key could trip Anthropic's rate
limit and leave the dashboard sitting on a "rate limited — backing off"
screen. Its cooldown was 5 seconds, letting it fire far faster than the 120s
poll it exists to short-cut, and a refused press gave no feedback — so the
natural response was to press it again.
R now refreshes at most once every 30 seconds (the same floor the automatic
poller uses), and when it's still cooling down the footer shows [R] in 22s
counting down instead of appearing to do nothing.
What's new in v1.1.x
- Per-model usage tracking. Weekly per-model caps now get their own bars
(Fable,Opus, …) under the overall 7-day window — the same breakdown the
in-app usage screen shows. These had silently stopped appearing: Anthropic
moved the data into a new field, and the dashboard was still reading the old
one. - A "nearest limit" line naming whichever window is furthest along. Worth
watching — a per-model cap is often further along than your overall weekly
bar, so it's the one you'll actually hit first. - Press
Rto refresh on demand.
(Earlier 1.0.x releases added live-ticking reset countdowns, a tunable poll
interval, automatic back-off for rate limits, and a clean single-screen error
state.)
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour, weekly (7-day) and per-model usage with live, colour-coded bars
- Live reset countdowns and extra-usage credits
- Fetches every 120s (or press
R); strictly read-only — never touches
your login
See the README for details and known limitations.
v1.0.3
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
What's new in v1.0.3
- Live countdowns. The "resets in" timers now tick down every second
(H:MM:SS), so you can watch your window approach in real time. - Fewer rate-limit (429) hiccups. The default poll interval is now 120s
(matching Anthropic's own usage screen), so the API rate-limits far less often. - Tunable interval. Poll slower if you like:
claude-usage.exe 180, or set
theCLAUDE_USAGE_INTERVALenvironment variable. Minimum 30s. - Simplified footer.
(Earlier 1.0.x releases added automatic back-off for rate limits, a clean
single-screen error state, the correct extra-usage amount, and a version in the
footer.)
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour and weekly (7-day) usage with live, colour-coded bars
- Live reset countdowns and extra-usage credits
- Fetches every 120s; strictly read-only — never touches your login
See the README for details and known limitations.
v1.0.2
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
What's new in v1.0.2
- Correct extra-usage amount. The monthly limit now reads
155.00 AUD
instead of15,500(the API reports cents). - The app version now shows in the footer.
(v1.0.1 added automatic back-off so usage-API rate limits no longer cause
scrolling error storms, plus a gentler 90s poll interval.)
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour and weekly (7-day) usage with live, colour-coded bars
- Reset countdowns and extra-usage credits
- Refreshes every 60s; strictly read-only — never touches your login
See the README for details and known limitations.
v1.0.1
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour and weekly (7-day) usage with live, colour-coded bars
- Reset countdowns and extra-usage credits
- Refreshes every 90s; strictly read-only — never touches your login
See the README for details and known limitations.
v1.0.0 — Live Claude usage dashboard
A live terminal dashboard for your Claude plan limits — run it once when you
clock in and never glance at the in-app /usage screen again.
Download
Grab claude-usage.exe below and double-click it. No Python or install needed.
Requirements
- Logged into Claude Code with a Claude Pro or Max subscription on this
machine (it reads the OAuth token Claude Code already stores). - Windows. (macOS keeps the token in Keychain — not supported yet.)
What it shows
- 5-hour and weekly (7-day) usage with live, colour-coded bars
- Reset countdowns and extra-usage credits
- Refreshes every 60s; strictly read-only — never touches your login
See the README for details and known limitations.