Claude Spend Bar

Your claude.ai usage, in the menu bar. How much of your session and weekly limits you have left, without opening a browser tab.

Safari FileEditView HistoryWindowHelp 38% Thu 14:02

That is the whole app: the clay triangle and a percentage, just left of the clock. Click it for the rest.

Download for Mac Install with Homebrew

Version 2.0.1 · macOS 14 or later · Apple Silicon · free

What you get when you click it

A panel under the menu bar. Nothing else — no window, no Dock icon. Which of the two you see depends on how your Claude account is billed.

The panel on a subscription: an organisation picker, then Session 54%,
Weekly 28% and Weekly Fable 30%, each with a meter and a reset time,
then the Sessions list at API value. — **On a subscription.** One row per limit, with how much is left and when it resets. The session — the one that moves during a working day — is the coloured one.

The panel on a spend limit: $189.42 of $300, $110.58 left this cycle,
63% used, a tape of the five most recent charges, and the Sessions list. — **On a spend limit.** What you have run up this cycle, what is left, and a tape of what each of the last few charges added.

Every Claude Code session, priced

The sessions on this Mac, from the terminal and the desktop app, with what each one cost, using Claude Code's own totals wherever it records them.

The Sessions list with Desktop off, sorted by cost: two terminal sessions,
two headless runs, a CLI total, and the part of the bill no session explains. — **Desktop off, sorted by cost.** The total follows the filter; what no local session explains stays below it.

See where the money went. Each session with its last activity and cost, and a dot on the ones working right now.
Desktop, CLI, Runs. Toggle each on or off in any mix, and sort by recent, cost or name. It remembers.
Eval runs sit under the session that started them. A batch of claude -p runs reads as one line, not forty.
Each account keeps its own. Switch organisation and the list shows only the sessions billed to it.

As wide as you want it

On a MacBook with a notch, a long reading pushes other icons out of sight. Pick how much room it takes in Settings, under Menu bar.

The Menu bar settings screen: Full $189.42 / $300 (today's look, 113 pt),
Compact $189 / 300 (85 pt), Minimal $189 (51 pt) and Mark, the mark alone (16 pt). — **Four styles, measured.** Each row shows your own reading in that style and how wide it is.

From full to just the mark. $478.20 / $1000, $478 / 1k, $478, or the mark alone.
Subscriptions too. 42% · 18% with the weekly, 42%, 42, or the mark.
Changes as you pick. The bar is the preview, and the choice is kept.
Problems still show. Even as a mark alone, a missing key or an error still gets its sign.

Installing

Two ways in. They install the same app — pick whichever you are comfortable with. Either way it keeps itself up to date: new versions download in the background and install while the panel is closed.

Disk image

No terminal needed.

Open the downloaded ClaudeSpendBar.dmg.
Drag Claude Spend Bar onto the Applications folder in the same window.
Open your Applications folder and double-click Claude Spend Bar.

Nothing to download again — the app updates itself.

Homebrew

If you already use brew.

brew install --cask tkachenkobogdan/tap/claude-spend-bar

On 1.4.3 or earlier? Upgrade once by hand; from 1.5.0 on it updates itself:

brew upgrade --cask claude-spend-bar

Homebrew installs it but does not start it. To open it the first time:

Open your Applications folder in Finder.
Double-click Claude Spend Bar.

Or from the same terminal:

open -a "Claude Spend Bar"

Spotlight will not find it until macOS has indexed it, so use Finder or the command above rather than ⌘Space.

Nothing appears in the Dock — look for the clay triangle in the menu bar, at the top right of your screen. The app adds itself to your login items the first time it runs, so it is there after a restart. You can turn that off in its settings.

Connecting your Claude account

The app reads your usage through your own Claude Code, which already knows your plan and limits. It never asks for, stores or sends a login.

The Connect screen: Spend Bar runs your claude to ask for usage, found two
accounts, never reads, stores or sends a login, and never talks to claude.ai.

Install the Claude Code CLI, or the Claude app, which carries its own copy.
Sign in to Claude Code once, in Terminal: claude auth login.
Click the triangle in the menu bar and press Connect.

Not signed in yet? The panel shows the exact command, and Open Terminal types it for you to run. Coming from 1.x: your old session key is deleted from the Keychain on first launch.

Unofficial, and built on undocumented output

This app is not made by, endorsed by, or affiliated with Anthropic. It reads the usage report Claude Code's /usage command prints. That output is not a published API: it carries no compatibility promise and can change or disappear in any Claude Code release, without notice.

When that happens the app stops showing a reading until it is updated. Treat the numbers as a convenience, not as a billing record — the usage page in claude.ai remains the authority.

It reads only your own accounts, through the claude you installed, never holds a login, and never writes anything back.