claude-quota

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

The numbers stay small and the colour changes as a window fills up. The layout is measured in terminal columns so it never wraps: three lines on a normal terminal, two on a short one, and a single model │ ctx% │ 5h% │ 7d% line when there is only one row. Every render also writes an HTML dashboard next to its cache, with one card per window and a pace gauge on each. On terminals that support OSC 8 links, the first line of the statusline links to it.

It uses the token Claude Code already holds, which it reads from the macOS Keychain. Usage is cached for two minutes and refreshed in the background, so drawing the statusline never waits for a fetch. Every file it writes is 0600, and the strings that go into the dashboard are HTML-escaped. The on-disk format is specified, so other tools on the same machine can share the readings without a daemon. Installing it is one npm install -g, and it needs Node 18 or newer.