Element guide
Claude Code statusline with rate limit
Visualize Claude Code's 5-hour and 7-day rate limit usage in your statusline before you bump into a soft cap.
Why show rate limits?
Claude Code reports rate-limit usage on rate_limits.five_hour.used_percentage and rate_limits.seven_day.used_percentage, plus reset timestamps. Pinning those numbers in your statusline turns a hidden quota into a visible signal — useful when you are deep into a batch of agentic edits and want to know whether you have room to keep pushing.
statusline.sh ships two element variants for each window. The bar variant renders an inline progress bar (configurable width, filled/empty chars). The pct variant prints just the percentage. Both share a hidden showResetTime flag that adds a T-1h22m countdown computed from the reset timestamp.
How it looks
The preview combines the model, a 5-hour bar in cyan, and a 7-day percentage in magenta. Either variant is conditional — if Claude Code does not emit rate-limit data in your session JSON, the element renders nothing and the statusline collapses around it.
How to add it
Open the builder, drag the Rate Limit 5h and/or 7d elements onto the canvas, and pick a variant from the inspector. The same hand-rolled compiler that lowers every other element to a RenderOp[] powers this one — what you see in the live preview is exactly what the installed bash and PowerShell scripts will render.