Skip to content

Releases

v1.1.2

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 25 Jul 07:04

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 R to 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

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 25 Jul 06:33

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 R to 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

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 12 Jun 05:58

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
    the CLAUDE_USAGE_INTERVAL environment 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

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 12 Jun 04:28

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 of 15,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

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 12 Jun 03:37

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

Pre-release

Choose a tag to compare

@Tr1pl3x Tr1pl3x released this 12 Jun 02:19

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.