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.
> /plugin marketplace add Astro-Han/claude-pace> /plugin install claude-pace@claude-pace-marketplace
Repo: Astro-Han/claude-pace
What's inside
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.
5h and 7d quota usage, reset countdowns, and pace delta⇡15% means overspending, ⇣15% means headroomnpx, or as a single scriptMost 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.
(branch), 3f +24 -7 = git diff statsClaude Code supports custom status lines through its statusLine setting and /statusline workflow in the official docs:
Requires jq.
Plugin (recommended):
Inside Claude Code:
/plugin marketplace add Astro-Han/claude-pace
/plugin install claude-pace
/reload-plugins
/claude-pace:setup
npx:
npx claude-pace
Restart Claude Code. Done.
Manual:
mkdir -p ~/.claude
curl -fsSL -o ~/.claude/statusline.sh.new \
https://github.com/Astro-Han/claude-pace/releases/latest/download/claude-pace.sh
mv ~/.claude/statusline.sh.new ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh
This installs the latest release, not the current state of main. To pin an exact
version, swap latest/download for download/v0.9.4 (or any other tag).
Add to ~/.claude/settings.json:
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh"
}
}
Restart Claude Code. Done.
To remove: delete the statusLine block from ~/.claude/settings.json.
Plugin:
/plugin marketplace update claude-pace-marketplace
/plugin update claude-pace
/reload-plugins
/claude-pace:setup
npx: npx claude-pace@latest
Manual: Re-run the curl command above.
Every channel installs a tagged release. /claude-pace:setup copies the script the
plugin ships rather than downloading one, so the plugin version you have is the
version you run. Nothing installs from main.
Release notifications: Watch this repo → Custom → Releases.
| claude-pace | claude-hud | CCometixLine | ccstatusline | |
|---|---|---|---|---|
| Runtime | jq | Node.js 18+ / npm | Compiled (Rust) | Node.js / npm |
| Codebase | Single Bash file | 1000+ lines + node_modules | Compiled binary | 1000+ lines + node_modules |
| Rate limit tracking | 5h + 7d usage %, pace delta, reset countdown | Usage % | Usage % (planned) | None (formatting only) |
| Execution | ~10ms | ~90ms | ~5ms | ~90ms |
| Memory | ~2 MB | ~57 MB | ~3 MB | ~57 MB |
Execution and memory measured on Apple Silicon, 300 runs, same stdin JSON.
Need themes, powerline aesthetics, or TUI config? Try ccstatusline. The entire source of claude-pace is one file. Read it.
Claude Code polls the statusline every ~300ms:
| Data | Source | Cache |
|---|---|---|
| Model, context, cost | stdin JSON (single jq call) | None needed |
| Quota (5h, 7d, pace) | stdin rate_limits (live, no fallback) | None |
| Git branch + diff | git commands | Private cache dir, 5s TTL |
Requires Claude Code 2.1.80+, where rate_limits is available in statusline stdin. When stdin omits rate_limits (older Claude Code, or providers that do not surface the field), claude-pace shows -- for 5h/7d quota and the session cost if available. No cached or stale quota is ever shown, because a cached account-level snapshot cannot be proven to belong to the current provider/account.
Git 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.
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 rate_limits is absent (older Claude Code, or providers that omit it), claude-pace shows -- for 5h/7d and the local session cost when present. No stale quota fallback — see the removal decision.
Can I inspect the source? The entire tool is one Bash file. Read it before you install it.
diffpane - Real-time TUI diff viewer for AI coding agents. See what Claude Code changes as it happens.
MIT
Last updated: 2026-07-28 · v0.9.4
.claude-plugin/
marketplace.json
plugin.json
.github/
claude-pace-demo.gif
workflows/
publish.yml
.gitignore
CHANGELOG.md
claude-pace.sh
commands/
setup.md
docs/
decisions/
2026-05-20-quota-cache-removal.md
superpowers/
plans/
2026-04-13-quota-cache-fallback.md
specs/
2026-04-13-quota-cache-fallback-design.md
LICENSE
npm/
.gitignore
cli.js
package.json
README.md
test.shA reusable skill for building Karpathy-style LLM wikis with Claude Code, Cursor, Codex, and other Agent Skills tools. karpathy-llm-wiki packages Karpathy's LLM Wiki idea into one installable Agent Skills skill.
@astro-hanFAQ
claude-pace is a Claude Code plugin with hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.