grzegorz-raczek-unit8

Claude Quota — Development skill for Claude Code

Development community

Menu bar gauges for Claude Code quota (SwiftBar plugin).

How to install Claude Quota

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

What Claude Quota does

Menu bar gauges for Claude Code quota (SwiftBar plugin).

Alternatives in Development

Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
CoderBar — Native macOS agent control for Codex and Claude — monitor, approve, ask, and jump back from the menu bar 100 ★
Botbus Protocol — The BotBus protocol: how a menu bar app on your computer and the companion apps on your phone and watch stay i 81 ★

README

claude-quota

Menu bar gauges for your Claude Code quota — one bar per account, like this:

![menu bar screenshot](docs/menubar.png)

*(dark menu bar shown — outlines, labels and the mascot follow the menu bar appearance, so light mode gets black-on-light)*

Each bar shows the 5-hour-window utilization for one account, colored green / orange (≥70%) / red (≥90%).
When the 5-hour window is fully used, the bar shows a countdown until reset (4:28) instead of the percentage.
When the weekly limit is hit, the bar turns black with a countdown to the weekly reset (2D) — that's the harder cap, whatever the 5-hour window says.
The dropdown lists full detail for every account inline: 5-hour and weekly windows, per-model windows where your plan reports them, extra-usage credits, and reset times.
Refreshes every 5 minutes (SwiftBar filename convention) plus a manual "Refresh now" entry.

Quick install

curl -fsSL https://raw.githubusercontent.com/grzegorz-raczek-unit8/claude-quota/main/install.sh | bash

Requires macOS and [Homebrew](https://brew.sh). When macOS shows a Keychain permission dialog on the first refresh, click **Always Allow**.

How it works

The plugin reads your Claude Code OAuth token from the macOS Keychain (**read-only** — it never refreshes or rewrites tokens, so it can't log you out) and queries the same usage endpoint that Claude Code's `/usage` screen uses. No passwords, no scraping, no third-party services.

**Note:** that endpoint is internal to Claude Code and undocumented, so a future Claude Code change may require a small fix here.

Install from a checkout

git clone https://github.com/grzegorz-raczek-unit8/claude-quota.git
cd claude-quota
./install.sh

Either install path sets up [SwiftBar](https://github.com/swiftbar/SwiftBar) via Homebrew if you don't have it, and adds it to your Login Items so the gauges come back after a reboot. If an account shows ⚠, its token went st