claude-pace

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.
• Top line: model, effort, project (branch), 3f +24 -7 = git diff stats

Claude Code supports custom status lines through its statusLine setting and /statusline workflow in the official docs:

• Customize your status line
• Claude Code settings

Table of Contents

• Install This Claude Code Statusline
• Upgrade
• Claude Code Statusline Comparison
• How Claude Pace Tracks Quota
• Claude Code Statusline FAQ

Install This Claude Code Statusline

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/vX.Y.Z with a tag from Releases.

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.

Upgrade

• 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 Code Statusline Comparison

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.

How Claude Pace Tracks Quota

Claude Code polls the statusline every ~300ms:

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.

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 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.

Also by the Author

diffpane - Real-time TUI diff viewer for AI coding agents. See what Claude Code changes as it happens.

License

MIT

Last updated: 2026-09-25 · v0.9.5