# Add to your Claude Code skills
git clone https://github.com/Astro-Han/claude-pace
README.md
Claude Pace
A lightweight Claude Code status line and rate limit tracker that shows your 5-hour and 7-day quota usage in real time. Pure Bash + jq, single file, zero npm.
If you are searching for a Claude Code statusline, a Claude Code quota monitor, or a Claude Code usage tracker, claude-pace is built for that narrow job. It shows not only how much quota you have used, but whether your current burn rate is sustainable before the window resets.
TL;DR
Claude Code status line with 5h and 7d quota usage, reset countdowns, and pace delta
Pace-aware rate limit tracking, ⇡15% means overspending, ⇣15% means headroom
Pure Bash + jq, single file, no Node.js runtime and no lockfile churn
Install as a Claude Code plugin, with npx, or as a single script
Most statuslines show "you used 60%." That number means nothing without context. 60% with 30 minutes left? Fine, the window resets soon. 60% with 4 hours left? You are about to hit the wall. claude-pace compares your burn rate to the time remaining and shows the delta.
⇣15% green = you've used 15% less than expected. Headroom. Keep going.
⇡15% red = you're burning 15% faster than sustainable. Slow down.
15% / 20% = used in the 5h and 7d windows. 3h = resets in 3 hours.
Best experience is on Claude Code 2.1.80+, where rate_limits is available in statusline stdin. When a later statusline run omits rate_limits, claude-pace can reuse the last known stdin quota snapshot from its private cache until either cached reset time expires.
Cache files live in a private per-user directory ($XDG_RUNTIME_DIR/claude-pace or ~/.cache/claude-pace, mode 700). All cache reads are validated before use. No files are ever written to shared /tmp.
Claude Code Statusline FAQ
Does it need Node.js?
No. Only jq (available via brew install jq or your package manager). No npm, no node_modules, no lock files.
How does pace tracking work?
claude-pace compares your current usage percentage to the fraction of time elapsed in each window (5-hour and 7-day). If you've used 40% of your quota but only 30% of the time has passed, the pace delta shows ⇡10% (red, burning too fast). If you've used 30% with 40% of time elapsed, it shows ⇣10% (green, headroom).
Does it make network calls?
No. Quota data comes from stdin rate_limits on Claude Code 2.1.80+. If a later statusline run omits rate_limits, claude-pace can reuse the last known stdin quota snapshot from its private cache as long as that snapshot's reset times are still in the future. Otherwise it falls back to -- and may still show the local session cost.
Can I inspect the source?
The entire tool is one Bash file. Read it before you install it.
Also by the Author
diffpane - Real-time TUI diff viewer for AI coding agents. See what Claude Code changes as it happens.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
A Claude Code plugin that automatically captures everything Claude does during your coding sessions, compresses it with AI (using Claude's agent-sdk), and injects relevant context back into future sessions.
