Your limits. Zero tokens. Live in the menu bar.

Session, week and Fable next to your clock, plus an optional pace and daily budget. ClaudioStat asks Claude Code directly, so a refresh costs zero tokens and never touches your login.

Download for macOS View on GitHub

Version 0.4.6 · macOS 15 or later · Apple silicon or Intel · 2.9 MB

Try the menu bar

Sample numbers. Click the status item and try the menu. P and B start off, as in the app: turn them on under Data. The icon pulses while Claude Code is thinking, and the warnings show when usage is too fast: try the switches. The app speaks the same twelve languages. It starts in your Mac’s, and Language in its menu switches it.

S: Session; Your current 5-hour window.
W: Week; All models, this week.
F: Fable; Fable only, this week.
P: Pace; How fast W rose over the last hour, per day or per hour. Experimental.
B: Budget; What's left of the week, per day (or per working hour) until the reset.

In the menu bar, S and W turn orange when you are using them faster than they last until the reset, and red when you are well past that. A warning triangle takes the icon's place when Claude flags a limit.

B is your budget per day.

Off by default: turn it on under Data, per day or per hour. Drag the sliders to see how it is worked out; this is the same formula the app uses. Stay under B each day and the week lasts until the reset.

Used this week 18% Weekly reset in 6d 20h

82% left over 7 days (the partial day counts in full) = 11.7% a day, rounded down to 11%.

Small on purpose.

Your limits at a glance

Session, week and Fable next to your clock. Turn on pace (P), budget (B) and the time to each reset under Data, or show just the icon or just the numbers under Display.
Every reset, counted down

Open the menu to see when each limit resets and how much of the week is left per day.
Warns you in time

S and W turn orange, then red, when you are using them faster than they last until the reset, and the menu says why. A warning triangle takes the icon's place when Claude flags a limit. Notifications tell you when a limit is reached, when it resets, and when the week passes 80% and 90%.
Zero tokens

ClaudioStat sends Claude Code a get_usage control request and nothing else, so a refresh costs nothing from your limits.
Never sees your login

Claude Code keeps its own login, and signing in runs its own claude auth login in your browser. ClaudioStat never sees or stores a credential, and it runs Claude Code with hooks, plugins and MCP servers off. To pulse the icon while Claude Code is replying, it reads the end of the session file that changed in ~/.claude/projects, and saves and sends nothing.
Sleeps when Claude does

While neither the Claude app nor Claude Code in a terminal is running, ClaudioStat stops asking Claude Code, and the last numbers dim so you can tell they are old.
Native and tiny

A small Swift app, a 2.9 MB download, with no Dock icon unless you turn on Keep in Dock. It refreshes every 1, 3, 5 or 10 minutes, can launch at login, and installs updates in one click: a window shows the progress, then Reopen starts the new version.
Every account in one bar

Using more than one Claude account? Add profile… signs in to another one in your browser, and each becomes a profile named by its email. Pick Multiple users under Data to see them all side by side, with Profile name on to tell them apart. Single user shows just the checked one. With more than one shown, Show data below offers Show profile per block, Show profile per submenu or Off.

How it gets the numbers

Claude Code already knows your limits. ClaudioStat just asks it, the same way each time.

Runs your installed claude once, headless, with hooks, plugins and MCP servers off and no session saved.
Sends one get_usage control request. No prompt goes with it, so it costs zero tokens.
Reads five_hour, seven_day and the Fable window, works out P and B and updates the bar.

What ClaudioStat sends and reads

Commandclaude -p --input-format stream-json --output-format stream-json \
--verbose --no-session-persistence --strict-mcp-config --setting-sources ""

Request{"type":"control_request","request_id":"1",
 "request":{"subtype":"get_usage","skip_behaviors":true}}

Reply (simplified){"type":"control_response","response":{
"subtype":"success","response":{"rate_limits":{
  "five_hour":{"utilization":42,"resets_at":"2026-09-28T16:13:00Z"},
  "seven_day":{"utilization":18,"resets_at":"2026-10-05T12:00:00Z"},
  "model_scoped":[{"display_name":"Fable","utilization":7}]}}}}

Install

Open the DMG and drag ClaudioStat to Applications.
Allow it once. ClaudioStat is signed by its developer and notarized by Apple, so macOS only asks you to confirm the first time you open it.
Sign in once. A setup window finds Claude Code and, if needed, signs you in through your browser. Then the numbers appear in the menu bar.

Requirements

macOS 15 or later
Apple silicon or Intel
Claude Code, on its own or in the Claude desktop app, and a Claude plan
Installed in Applications, for launch at login and updates

Download for macOS

Reading the menu

The messages ClaudioStat shows. Pick one to see what it means.

Add profile…

There is no profile yet, or you removed them all. Click it: ClaudioStat checks Claude Code and connects your account, signing you in through your browser if needed.

Claude Code not found

ClaudioStat looks for claude in ~/.local/bin, /opt/homebrew/bin and /usr/local/bin, then for the copy the Claude desktop app keeps. Install Claude Code, then click the message and try again.

Claude Code answered but had no plan limits to share. Click the message: your browser opens so you can sign in with your Claude plan, and the numbers follow.

Updating…

ClaudioStat is asking Claude Code for its first numbers. They usually arrive a few seconds after launch.

Paused · Claude isn't open

“Pause when Claude is closed” is on and neither the Claude desktop app nor Claude Code in a terminal is running, so ClaudioStat stops asking Claude Code and dims the last numbers. Open Claude or Claude Code, or turn the option off. A terminal session is noticed within a minute, or as soon as you open the menu.

Update failed 9:41 PM

The last refresh got no usable answer within 30 seconds. It tries again at the next refresh, or you can use Refresh now (⌘R).

⚠︎ Session limit reached

Claude has locked this limit, or flagged it (then it reads, for example, “Session limit: warning”). A warning triangle takes the icon’s place in the menu bar until it clears.

Using 24% a day, 17% a day lasts until reset

Shown under S or W when it turns orange or red: you are using that limit faster than it lasts until the reset. Orange is a little faster, red is well past it. W counts per day or per hour: pick Budget per day or Budget per hour under Data.

Week -

A dash means there is no fresh number. After a failed refresh you get dashes, never old numbers. F stays a dash when Claude Code reports no Fable limit, and P until ClaudioStat has a reading from an hour ago. The menu bar leaves such a letter out, and shows just the icon when there is no number at all.

Launch at login

It only works for the copy in /Applications, so the menu item stays greyed out anywhere else. Move ClaudioStat there and open it again.

Update available!

A check found a newer version and you chose Later, so this takes the place of Check for updates… until you update. Click it, then Update Now.

Reopen ClaudioStat to start using it

After Update Now, a window shows each step under a loading bar: downloading, checking the signature, installing. When the bar fills, the new version is in place. Click Reopen to start it. If it can’t reopen, quit ClaudioStat and open it yourself.

Couldn’t install the update

Most often ClaudioStat isn’t in the Applications folder, the only place it updates itself: move it there and check again. It also stops if the download fails or isn’t signed by its developer. Click Download to get the new DMG and install it yourself.