A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.
CC Usage Band
Watch Claude Code's 5-hour and 7-day limits
A one-line band above the prompt with your 5-hour and 7-day limit use and reset times, the context window's tokens, and the last turn's prompt-cache hit rate.
What this mod can do
- Reviewed at commit 60cd609
- Reads environment variables
3 more things it can do
- Remembers data between sessions
- Adds the /usage-band-preview command
- Runs on a timer
Good to know (3)
- The 5h and 7d figures come from subscription rate-limit headers, so they show only on a plan, after a reply.
- Icons are Nerd Font in Ghostty and plain Unicode elsewhere. Set USAGE_BAND_ICONS to override.
- On a narrow terminal it drops the bars first, then the countdowns.
Preview
Terminal
≡ 44K/200K ● 5% [-]Claude Desktop
What it does
In the author's words
A band above the prompt showing your 5-hour and 7-day limits, context window and prompt-cache hit rate, styled for the terminal and the desktop app
- What you see
- A one-line band above the prompt
- Works in
- Terminal and Claude Desktop
- Slash commands
- /usage-band-preview
- Uses your tokens
- No
- Changes files
- Nothing
- Network access
- None
- Reviewed commit
- 60cd609
- Preview recorded with
- Claude Code 2.1.309
How it works
- Reads the session's usage figures as each turn completes.
- Shows 5h and 7d bars with the percent used and time to reset, then context tokens.
- Ends with the cache hit rate, the share of the last turn's input the prompt cache served.
- Turns a metric red past 80% for limits and context, or under 50% for cache hits.
Common questions
How do I see my Claude Code 5-hour and weekly limits while I work?
Usage Band puts them in a band above the prompt, as a bar per window with the percent used and the time until it resets. The figures come from your subscription's rate-limit headers, so they appear after the session's first response and only on a subscription.
What does the prompt-cache hit rate mean?
It's the last turn's cache reads over all of its input (uncached tokens, cache reads and cache writes), summed over the turn's requests. Usage Band turns it red when it falls under 50%.
How do I change the band's icons?
Set USAGE_BAND_ICONS in your shell profile to auto, nerd, unicode or ascii, for example export USAGE_BAND_ICONS=unicode. Run /usage-band-preview to see every terminal style side by side.
Does Usage Band read files or contact the internet?
No. Its README says it reads the session's usage figures and the TERM_PROGRAM and USAGE_BAND_ICONS environment variables, adds /usage-band-preview, and draws the band. statuslin.es's checks found no file writes, programs or internet access.
Badge for your README
Own this listing? Add it to your README. The badge shows the install count as it grows.
[](https://staging.statuslin.es/mods/usage-band?utm_source=readme-badge)
Or show the preview card:
[](https://staging.statuslin.es/mods/usage-band?utm_source=readme-badge)
More like this
Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events
▀▄ ▄▀ [-]
▀▀▀▀▀▀▀▀▀
▀▀▀▀▀▀▀▀▀
▀▄ ▄▀▀▀▀▀▀▀ ▀▀▀▄▄▄
▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀
ctx 22% [ Pet ♥ ] [ ⚙ ] [ ↻ Adventurer ] [ Hide ]A little pixel cat that wanders above the Claude Code prompt, watches your usage limits and announces when work finishes; or switch packs for an adventurer who mines, chops trees and fights zombies
An animated pixel-art companion above your prompt that reacts to your session and your typing, with a live context meter.
Opus 4.8 high ✦ │ ctx 22% │ app (main) │ PR #1287 ● │ $0.41 · 10m +128 -34
Session ● ● ● ● ● ● ● ● ○ ○ ○ 74% left Resets in 2h 6m
Weekly ● ● ● ● ● ● ● ● ● ● ○ 93% left Resets in 2d 0h
Feature-rich bash status line with model, context bar, session cost (read live from Claude Code, so it stays correct on any model), rate-limit bars, and live tool/agent activity that adapts to terminal width. Source: github.com/JungHoonGhae/claude-statusline
✧ ███████████▋ 73% 🗝 Ultima Weapon ✦ app ∙ main
♥ ████████████████████████ 100% 「SAVE POINT」 ✶ Limit Form ◉ 41
Claude Code plan-usage HP bar that reads the Claude auth token to show remaining usage.
app · main · Opus-4.8 · effort high · ctx 22% · 5h 26% ↻2h6m · 7d 7% ↻2d0hFolder, git branch, model (color-coded by family), effort, context usage, and 5h/7d rate-limit usage with reset countdowns — all on one line, each percentage going green → yellow → red as it climbs. Needs jq.
[Opus 4.8] | ━━━━━━ 22% (44K/200K) | app | git:(main) | ⏱ 10m
Single-line status with a context bar, H/W usage limits, project, git branch, MCP server count, and a session timer, with cross-platform credential lookup. Source: github.com/AndyShaman/claude-statusline