Claude Usage — Menu Bar Usage Monitor for Claude

Built for developers

🔑

Zero-config auth

Automatically reads your Claude Code OAuth credentials from the macOS Keychain. No API keys, no session cookies, no browser DevTools.

⚡

Always in your menu bar

See your session usage percentage at a glance. Click to expand the full breakdown of session and weekly limits with reset timers.

🎯

Near-zero cost

Each poll is a single Haiku token — ~$0.000012 per request. That's roughly $0.10/month at the default 5-minute refresh interval. Essentially free.

🔔

Custom alerts

Set separate notification thresholds for session and weekly usage. Get macOS notifications the moment you cross your limit. Menu bar turns red when critical.

🛠

Native Swift

Built with SwiftUI. Lightweight ~2MB binary. No Electron, no web views, no background daemons. Launch at login support built in.

🔓

Open source

Fully open source. Inspect the code, verify the API calls, contribute features. Your credentials never leave your machine.

How it works

Reads your existing credentials

If you've ever run claude auth login, your OAuth token is already stored in the macOS Keychain. Claude Usage reads it automatically — no extra login needed.

Pings the Anthropic API

Every few minutes, it sends a tiny 1-token Haiku request to the Anthropic API. Both successful (200) and rate-limited (429) responses include your usage data in the response headers.

Parses rate-limit headers

The API returns headers like anthropic-ratelimit-unified-5h-utilization and anthropic-ratelimit-unified-7d-utilization containing your exact session and weekly usage percentages.

Displays in your menu bar

Your usage appears as a compact percentage in the menu bar. Click to see the full breakdown with progress bars, reset timers, and weekly limits — just like the claude.ai settings page.

What it costs you

Per poll	~15 input + 1 output token	$0.000012
Per day	288 polls (every 5 min)	$0.003
Per month	~8,640 polls	~$0.10

Each poll sends a minimal 1-token Haiku request. Even rate-limited (429) responses return usage data in the headers — so nothing is wasted. For subscription users (Pro/Max), this has zero impact on your plan limits.

Get started

Requires macOS 14+ and Claude Code installed.

Build from source


                    $ git clone https://github.com/bishojbk/claude-usage

                    $ cd claude-usage

                    $ make install

Prerequisites


                    # Authenticate Claude Code (if not already)

                    $ claude auth login

Swift 6 SwiftUI macOS 14+ Anthropic API Keychain

Your Claude usage,always visible.