usage-band mod
Four rings above the prompt show context use, your 5-hour and weekly limits, and an estimated prompt-cache countdown.
Last checked against the official docs: 2026-10-02
| Type | Community |
|---|---|
| Author | Veit Voss |
| Version · License | 0.7.3 · MIT |
| Source | github.com/Vosssa/claude-usage-band |
We have not installed or run this mod. Everything here comes from the author's README and source, read on 2026-10-02. Mods run with your permissions: read the code and run claude plugin validate before installing.
What it does
- Rings show how full the context is, how much of the 5-hour and weekly plan limits you've used, and roughly when the prompt cache expires.
- When context passes 400k tokens it offers Clear, Compact or Later.
Requirements
- The author says it works in the terminal and the Desktop app.
- With an API key instead of a plan, the 5-hour and weekly rings aren't shown.
Good to know
- The cache countdown is an estimate from typical cache lifetimes, not a reading from the server.
- Clear and Compact act on your session; they are not display-only.
How to get it
- Install from Vosssa/claude-usage-band following its README.
New to installing mods? See the install guide for --plugin-dir and marketplace installs.
Related mods
- diff: Powers the /diff pane: your session's uncommitted changes shown file by file beside the transcript, refreshed as Claude edits.
- telemetry: Sends the analytics events that Claude Code's built-in mods record. Refuses calls from mods you install.
- Token Weather: Draws a one-line 'weather forecast' of how full your context window is, above the prompt.
- Replay Theater: Adds /replay so you can step through every file edit Claude made in the last turn, one diff at a time.