Usage Band (Auspex)
Shows 5-hour, 7-day and per-model weekly plan windows in desktop and terminal.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add Auspexlabs/usage-band
/plugin install usage-band@usage-band
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add Auspexlabs/usage-band
claude plugin install usage-band@usage-bandThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "Usage Band (Auspex)" (https://github.com/Auspexlabs/usage-band). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add Auspexlabs/usage-band and claude plugin install usage-band@usage-band, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/Auspexlabs/usage-band
cd usage-band
claude --plugin-dir .Clone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads plan-window limits from Anthropic's usage endpoint via the session credential.
Writes files
NoneRuns commands
NoneNetwork
YesAbout every 5 minutes requests https://api.anthropic.com/api/oauth/usage.
Introduction
Usage Band by Auspexlabs / Michael Zhao is a Claude Code function-hooks mod that shows 5-hour, 7-day and per-model weekly plan meters in the desktop Code tab and terminal prompt area, refreshing about every five minutes. It calls api.anthropic.com oauth/usage with the session credential (same endpoint as /usage); the plugin never sees the token. On failure it keeps the last reading. Needs a subscription plan; API-key-only sessions have nothing to show. Author built/tested on 2.1.286. The site already lists another usage-band by Rishit30G; this is a separate implementation, so the slug is usage-band-auspex. Preview is illustrative; not run-tested here.
Who it is for
- Subscribers who want live multi-window and per-model meters near the prompt
Requirements
- Claude Code ≥ 2.1.286
- Author built/tested on 2.1.286 (not a higher stated minimum).
- Needs subscription plan windows (Pro/Max/Team/Enterprise).
- Different repo from the site's Rishit30G usage-band.