Claude Code Usage Quota Mod with Auto Compact
Know your Claude limits before they hit you. A live band above the Claude Code prompt that shows your plan limits, forecasts whether you'll run out before they reset, and shows how full your context window is. Compact in one click, or let it compact automatically.
The 5 Hour and Weekly limits are your whole Claude account's, including what you use in Claude chat and Cowork. The band itself shows in Claude Code: the desktop app and the terminal.
Live from the moment a session opens. Many usage mods stay blank until Claude replies, because they only read the figures each reply carries. This one asks Anthropic's usage service straight away, for free (it uses no tokens and doesn't count toward your limits), so your limits are there as soon as the band appears, and it keeps them current every few seconds while you work.
Type /quota to turn the band off and on.
EXPANDED
COLLAPSED
One row that still shows the time left until each limit resets:
[!TIP]
Never hit a full context again: Auto compact, on by one click.
With Auto compact on, the band compacts your session once the context reaches 30% (the default; set 15 to 99). A long context costs more on every reply, so compacting early keeps replies cheaper and your limits lasting longer. Auto compact never interrupts a reply. Want to compact right now? The Compact button runs /compact in one click.
Each session keeps its own Auto compact setting, even after a restart, so you can run them differently side by side:
- Building something big? Set Auto compact higher (say 70%) or turn it off, so Claude keeps the whole picture. Press Compact yourself at a good stopping point. (With it off, Claude Code's built-in compaction still steps in when the context is nearly full.)
- Everyday sessions? One click turns Auto compact on at 30%. They stay lean, and your 5 Hour and Weekly limits last longer.
WHAT IT SHOWS
5 Hour and Weekly limits
- The % used, matching the app's own Plan usage limits panel.
- A forecast of where you'll be at reset: a grey tick on the bar and a note, e.g. On pace for about 87% by reset – resets in 23m.
- A headline at a glance: On track. You should reach Wednesday's reset with room to spare.
- The forecast starts from your usual pace (learned from your past windows) and shifts to your actual pace as the window goes on, so an early burst doesn't set it off.
- Bars turn amber at 75% and red at 90%, or sooner if you're on course to run out.
On course to run out, it warns you and says when you'll hit the limit:
Context window
- The % used and space free, as
/context counts it, split into Messages, Tools and Other.
- Amber at 50%, red at 80%: the point to compact.
Compacting
- Compact runs
/compact in one click.
- Auto compact runs at your % (30% by default, 15 to 99), never mid-reply. Each session keeps its own setting; a new session starts with it off.
If the session is already past your % when you turn it on, it asks first:
- Now compacts straight away.
- After my next compact waits until the session is compacted some other way (Compact,
/compact, or Claude Code's own), then takes over.
Works in light and dark themes and at every width down to the narrowest. Collapsed or expanded is shared across all sessions.
[!NOTE]
MORE SCREENSHOTS
Early in a 5 hour window:
Running out on the Weekly limit:
| Light theme | Narrowest window |
|---|
| |
| |
WHERE IT WORKS
- Claude desktop app, Code tab
- Claude Code in a terminal
[!NOTE]
In the desktop app, the band appears once a session has started. The brand-new Welcome back screen has no session yet, so no mod can draw there. Send your first message and it appears.
In the terminal, ▲/▼ expands and collapses it. The [-] next to it is Claude Code's own control and hides the band; ctrl+x ctrl+a brings it back.
Collapsed:
INSTALL
Needs Claude Code 2.1.287 or later, signed in with a Pro or Max plan.
Desktop app: in the Code tab, send this as a message, allow the claude plugin commands if asked, then quit and reopen the app:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
