Claude Usage Bar

claude-usage-bar

macOS menu bar widget that displays your Claude Code rate limit usage in real time.

How it works

Claude Code sends rate limit data via the `statusLine` hook on every assistant message. This tool captures that data and displays it in your macOS menu bar.

Sessions started from the Claude desktop app are covered too. `statusLine` never fires for those — the app runs Claude Code headless and draws its own UI, so there is no terminal status line to render — so the widget falls back to the usage history the desktop app keeps for its own meter (`~/Library/Application Support/Claude/plan-usage-history.json`). That costs no API call and no credentials, but it only carries percentages, and only about every 15 minutes.

• Menu bar — shows 5h session and 7d weekly usage at a glance
• Display modes — toggle between 5h + 7d (full) and 5h only (short) from the Display submenu; preference is persisted
• Dropdown — detailed view with progress bars and reset times
• Recent sessions — shows last 5 sessions; click to copy claude --resume command
• Auto-refresh — updates every time you chat with Claude Code
• Inactive state — shows ⏸ when Claude Code hasn't been used for 10+ minutes

Install

brew tap hwayoungjun/tap
brew install claude-usage-bar

Setup is automatic — `~/.claude/settings.json` is configured on install and every app launch.

Or build from source:

git clone https://github.com/hwayoungjun/claude-usage-bar.git
cd claude-usage-bar
go build -o claude-usage-bar .
./claude-usage-bar setup

Makefile

Common tasks are available via `make`:

make build              # build ./bin/claude-usage-bar
make dev                # run in foreground (debugging)
make install            # install to /usr/local/bin (or PREFIX=/opt/homebrew on Apple Silicon)
make uninstall          # remove binary + run app uninstall
make se