Claude Status Bar plugin
A Claude Code status line with 5-hour and weekly limit usage, reset countdowns, model and prompt cache lifetime
- 391 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The installer edits `~/.claude/settings.json`, starts a background daemon and downloads updates by itself every six hours.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/leeguooooo-claude-code-usage-barDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The installer edits `~/.claude/settings.json`, starts a background daemon and downloads updates by itself every six hours.
This is third-party code. Review the repository files before installing.
What it does
Claude Status Bar shows one line at the bottom of the terminal with how much is left before Claude Code limits and when they reset. The numbers are the same ones Claude Code enforces, not a local guess. Next to them sits a projection of usage at the end of the window in percent. The second part of the line shows the model and context window, the prompt cache countdown, project, branch, git worktree, lines added and removed in the session and its duration. A snowflake with a timer shows when the next turn will cost full price. The `cs` program runs through a background daemon and stays under 1% CPU at one refresh per second. `cs theme` changes the look: three styles with a live preview. `cs --setup` wires the status line and installs a skill through which Claude Code changes settings from a plain request.
Who it is for. Developers on paid Claude plans who hit the 5-hour and weekly limits in the middle of work.
Good fit when
- The 5-hour window often ends abruptly, and you want the remainder and reset time always in view.
- You want to know when the prompt cache expires so the next turn stays cheaper.
- Parallel sessions run in several git worktrees, and you need to see which is which.
- You work through Bedrock or Vertex and need session cost instead of subscription limits.
Not a fit when
- You need charts and weekly cost reports.
- You work in Codex: the author has a separate Codex Statebar project for it.
- Your environment forbids programs that update themselves from the internet.
Example request
Switch the status bar to thin bars and make the remaining quota colour #4ec85b.Limitations
Prebuilt binaries exist for macOS on Apple Silicon and Linux x86_64; other platforms fall back to pip, and Windows has a separate PowerShell script. `cs` upgrades itself every six hours, and a stuck version is updated with `cs upgrade`. `cs --setup` writes to `~/.claude/settings.json` after backing it up. The Claude Code plugin carries only commands and the skill, and `cs` itself is installed separately. IP checks and cost display are opt-in.
How to disable. Remove the `statusLine` block from `~/.claude/settings.json` or restore the backup, then uninstall the `claude-statusbar` package or the `cs` binary.
FAQ
Where does Claude Status Bar get its limit numbers?
From the same 5-hour and weekly limit data Claude Code passes to the status line. There is no local estimate from logs.
How do I install it as a plugin?
Run `/plugin marketplace add leeguooooo/plugins` and `/plugin install claude-statusbar@leeguooooo-plugins`. The plugin carries commands, and the `claude-statusbar` package is installed separately with pip or uv.
How do I change the look?
`cs theme` shows three styles with a live preview. Individual keys change with `cs config set`, for example `cs config set bar_glyph thin`.
Does it load the CPU much?
With the daemon it stays under 1% at one refresh per second. The mode without it is `cs --setup --inline` and takes about 3%.
What if the line does not appear?
Restart Claude Code and run `cs doctor`. If the version is stuck, `cs upgrade` or rerunning the installer helps.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code status line showing model, effort level, context fill, git branch and the 5-hour and weekly limits.
A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
A Claude Code status line showing 5-hour and 7-day quota use plus the pace: whether what is left lasts until the window resets
28 components, up to nine lines and 227 settings: a Claude Code status panel with tokens, cache and session price.
An always-on-top widget and a CLI show Claude Code limits for 5 hours and 7 days, token burn and the cost of each turn.
A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Claude Status Bar (this card) | no | 391 | |
| ccusage | no | 19,415 | token and cost reports from local logs; here live limit remainder in the status line |
| Claude Code Usage Monitor | no | 8,799 | a separate terminal monitor with forecasts; here one line inside Claude Code itself |
README in short
The README shows three looks, a table of line segments and one-command installation for macOS, Linux and Windows. Details on the daemon, no-quota mode and cache countdown live in the docs folder.