claude-quota

Claude Code tells you about a quota when you hit it. claude-quota reads the same usage API the /usage page reads and keeps every bucket in the statusline while you work: the 5-hour session, the 7-day window, the Sonnet and Opus windows, extra usage — each with the share used, how much of the window has elapsed, and a pace arrow that says where you will land at reset if you keep going at this rate. Over 100 % means the quota runs out before it resets.

Colour carries the warning so the numbers can stay small, and the layout is measured in terminal columns and never wraps: three lines on a normal terminal, two on a short one, model │ ctx% │ 5h% │ 7d% on one. Every render also writes an HTML dashboard beside its cache — one card per window with a pace gauge — and links it from the first line on terminals that support OSC 8 links.

The token is the one Claude Code already holds, read from the macOS Keychain; usage is cached for two minutes with a background refresh, so nothing is fetched on the hot path. Every file it writes is 0600, dashboard strings are HTML-escaped, and the on-disk format is specified so other tools on the same machine can share the readings without a daemon. One npm install -g, Node 18 or newer.