hwayoungjun

Claude Usage Bar — Productivity skill for Claude Code

Productivity community

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

How to install Claude Usage Bar

This entry records only its repository, not the path inside it, so there is no exact command to give. Open hwayoungjun/claude-usage-bar and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Usage Bar does

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

Alternatives in Productivity

Performance Optimization Skill — Systematic performance analysis and optimization for RTK CLI tool, focusing on startup time (<10ms), memory us 11.9k ★
Nosqli — NoSQL injection scanner (MongoDB/Mongoose/operator-injection DBs) — auth bypass via $ne/$gt operators, bracket 4.5k ★
Tradingview MCP — Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick p 2.6k ★

README

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