Your Claude Code usage limits, always in sight. A tiny macOS menu-bar app
that shows the 5-hour and weekly windows
as four live numbers — percent used and time until reset — and keeps
itself up to date on its own. The figures come straight from your account,
exactly like /usage.
Free · open source · macOS 13+ · lives in the menu bar, no Dock icon
Everything you need to know about your Claude Code limits, at a glance.
Claude Code limits you on two clocks — a rolling 5-hour budget and a
weekly one. ClaudeLimits shows both: top line is the 5-hour window,
bottom line is the week. Each reads percent used and time to
reset (m minutes, h hours, d days).
No scraping and no middle-man. ClaudeLimits reads your OAuth token from the
Keychain and calls the same endpoint Claude Code does —
/api/oauth/usage — so the numbers match /usage to
the digit. It refreshes on its own, every few minutes.
In Colour mode the percentage is tinted by how close you are to the cap — blue under 50%, yellow at 50, orange at 75, red at 90 — while the time-to-reset stays a calm grey, so your eye lands on the number that matters. Prefer it all subtle? Mono mode renders as a normal template glyph that adapts to your menu-bar colour.
Right-click for the full menu: refresh on demand, switch Mono ↔ Color, open Settings — launch at login, refresh on open only, and a live Auto-refresh countdown — open About & Permissions to see exactly what it touches, jump to the product page, or restart and quit. Your choices stick between launches. No windows, no Dock icon — it just sits up top and stays out of the way.
Left-click the icon and the panel opens instantly — no fade,
no wait. Inside are the same three windows Claude Code shows for
/usage, plus an extra row for your plan's model —
Opus only or Sonnet only. Each line carries a percent, a
progress bar tinted by load (blue → yellow → orange → red), a time-to-reset,
and a → straight to claude.ai. Leave it open and it
updates live the moment fresh numbers arrive.
No scraping, no middle-man server — it talks to the same endpoint Claude Code does.
/usageIt reads your OAuth token from the Keychain entry
Claude Code-credentials and calls
/api/oauth/usage directly. Same request, same answer — the
figures line up with /usage. Polled every 10 minutes, with
a polite backoff whenever Anthropic asks it to slow down.
No account, no sign-up, no analytics. Nothing leaves your Mac except that one request to Anthropic's own API — the very same call Claude Code itself makes with the token already on your machine.
One Swift file, plain AppKit, no dependencies. It runs as a menu-bar agent
(LSUIElement) — no Dock icon, no window — and sips almost no
resources while it keeps your numbers fresh.
Anthropic rate-limits the usage endpoint, so ClaudeLimits checks once every 10 minutes — your limits drift slowly, so that's plenty fresh. If the server ever asks it to wait, it backs off for exactly as long as it's told and keeps the last numbers on screen meanwhile. It never hammers, so it never gets you throttled. Prefer zero background traffic? Flip on Refresh on open only and it fetches just when you open it. More on refresh cadence →
Launch at login —
flip it once and ClaudeLimits brings itself back after every reboot, quietly
taking its place in the menu bar. It's a proper login item
(SMAppService), so it survives restarts without a single window
ever popping up.
Full setup & usage guide → install, the readout, view modes, tuning