ClaudeLimits Free

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.

Download for Mac Read the docs →

Free · macOS 13+ · lives in the menu bar, no Dock icon

63% · 2h 41% · 4d
While you work, the same limits climb up in the menu bar — and the in-window usage panel fills and recolours blue → yellow → orange → red as you near the cap. Top row is the 5-hour window, bottom is the week; both refresh on their own.

Four numbers, the whole picture

Everything you need to know about your Claude Code limits, at a glance.

63% 2h 41% 4d

The 5-hour and weekly windows, side by side

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). Show it like Claude Code — floored — or flip on Honest rounding, which rounds to the nearest unit both ways (1d 3h → 1d, 1h 50m → 2h) — never understated, never inflated. Prefer detail? Turn on Two units for 1d 3h.

Keychain your token 🔑 Anthropic /usage API

Exact figures, straight from your account

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 10 minutes.

28% < 50 61% ≥ 50 82% ≥ 75 95% ≥ 90 or plain black & white that follows your menu bar

Colour-coded, or quietly monochrome

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.

Refresh ⌘R VIEW ✓ Mono Color SETTINGS Launch at login ⌁ Refresh on open only ⌁ Reset time Honest ✓ Auto-refresh in ~4h About & Permissions… Fix Keychain password prompts… Product page ↗ Restart Quit ⌘Q

One click from the menu bar

Right-click for the full menu: refresh on demand, switch Mono ↔ Color, open Settings — launch at login, refresh on open only, pick how the reset time rounds (Like Claude Code or Honest), and a live Auto-refresh countdown — open About & Permissions to see exactly what it touches, run Fix Keychain password prompts…, 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.

One click for the full panel

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. The panel is always the exact two-rank time left — 1h 50m, 5d 23h — no matter whether the menu bar shows one rank or two. Leave it open and it updates live the moment fresh numbers arrive.

Under the hood

No scraping, no middle-man server — it talks to the same endpoint Claude Code does.

Exactly like /usage

It 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.

Private by default

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. It's read-only toward the Keychain: it reads the Claude Code-credentials token but never writes it back — any refreshed token lives only in memory, and Claude Code stays the sole writer of that entry.

Tiny & native

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.

Gentle on your account

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 →

Always there

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.