quota-meter

quota-meter keeps your subscription’s usage windows on screen for the whole session. Claude Code only tells you how full the 5-hour and 7-day windows are in a notice that appears once you are already close. This mod pins that reading under the prompt, adds a countdown to the reset, and works out how long the current pace can keep going before a window fills.

What it does

• The pinned line shows each window’s percent used, the time until the first one resets, and a tail with the useful part: which window fills first at the recent pace (5h full in ~2h05m), or that nothing hits 100% before a reset, or that it is still collecting a burn rate.
• The /quota pane has one block per window: a bar, the reset as a clock time and as a countdown, the burn rate in percent per hour with the span it was measured over, and the projection. Run /quota again to close it.
• On a Claude gateway the spend limit appears as a third window.

Install

Needs Claude Code 2.1.269 or later with function hooks enabled and a Claude subscription. An API-key session reports no plan limits, so the line reads no plan limits reported yet and the pane says the same.

claude plugin marketplace add Arunjay4213/claude-mods
claude plugin install quota-meter@claude-mods

The marketplace is the author’s own claude-mods, unrelated to this site; it also holds context-lens and token-ledger. The line is pinned from session start and gets its first figures once Claude has answered. /quota opens the pane.

How it works

The windows come from $.session.usage(), which reports what the last API response carried: each window’s kind, percent used and reset time. The mod samples it after every finished turn and on a 60-second clock tick, which also keeps the countdown moving while the session sits idle. Each sample (time, whole percent, reset time) goes into $.store under samples, at most 240 per window, so restarting Claude Code inside the same window keeps the burn rate you had built up.

The burn rate is the straight slope from the first kept sample to the last, and it is only quoted once the samples span 5% of the window: 15 minutes for the 5-hour window, about 8.4 hours for the 7-day one. Below that both surfaces say collecting. The projection is the remaining percent divided by that rate; if the window resets before then, the pane says resets first. Samples older than the window are dropped, and a percent that fell or a reset time that moved means the window reset, so everything before it is discarded too.

The mod makes no network calls of its own and sends nothing to the model.

Limitations

• The first reading needs a turn. At session start the last response belongs to the previous session, or there is none.
• The 7-day window shows collecting for its first 8.4 hours, so a fresh session projects from the 5-hour window alone. The pane always prints the span a rate was measured over.
• A spend limit has no fixed length, so its samples are kept for seven days, and it can read above 100% once passed: the bar stops at full, the percent does not.
• The pane docks beside the transcript in the fullscreen layout from 110 columns and sits inline above the prompt on narrower terminals. Terminal sessions only.