claude-code-usage-bar
Lightweight Claude Code statusLine: 5h/7d rate-limit usage, reset countdowns, model + context window, prompt-cache age — one line, 3 styles × 9 themes, daemon f
What is claude-code-usage-bar?
Lightweight Claude Code statusLine: 5h/7d rate-limit usage, reset countdowns, model + context window, prompt-cache age — one line, 3 styles × 9 themes, daemon fast-mode
Overview of claude-code-usage-bar
What it is
Claude Status Bar (cs) is a lightweight tool that displays Claude Code usage information directly in the terminal status line or as a floating HUD on macOS. It shows official 5-hour and 7-day rate-limit bars, reset countdowns, the active model, context window size, and prompt-cache freshness — all in one line.
Key features
- Official 5h/7d rate-limit bars and reset countdowns, with end-of-window projections - Prompt-cache countdown (e.g. ❄ 4m23s) indicating when the next turn pays full price - Two surfaces: terminal statusLine or a floating HUD for the Claude desktop app (macOS)
- Fast performance: native cache reader plus background daemon, well under 1% CPU at one refresh per second - Opt-in extras: session cost, relay balance, git ahead/behind, activity, IP checks, IELTS writing-coach progress - Three customizable looks (aurora with block bars, aurora with thin line, classic) and 9 themes - Self-upgrades every 6 hours; manual upgrade via
cs upgrade
Use cases
- Monitoring remaining rate-limit quota during long Claude Code sessions - Knowing exactly when the 5-hour or 7-day window resets - Tracking prompt-cache age to avoid full-price API calls - Using the floating HUD on the macOS desktop app for always-visible usage - Integrating with ccx to get warnings when quota is nearly exhausted
Getting started
Install with the one-liner (macOS Apple Silicon / Linux x86_64): bash curl -fsSL https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/install.sh | bash Windows (PowerShell, no admin): powershell irm https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/install.ps1 | iex Or via pip / uv: bash pip install claude-statusbar # or: uv tool install / pipx install cs --setup # wires the statusLine hook + installs the skill Restart Claude Code after installation.
License and pricing
This project is open source under the MIT license. No pricing information is stated.
Based on the project's public README and repository metadata.