claude-pace-marketplace
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/astro-han--claude-pace)HTML
<a href="/listings/astro-han--claude-pace"><img src="/api/listings/astro-han--claude-pace/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](https://github.com/Astro-Han/claude-pace/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`.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 29 lines
- {
- "name": "claude-pace-marketplace",
- "owner": {
- "name": "yuhan",
- "email": "lei.yuhan@outlook.com"
- },
- "metadata": {
- "description": "Claude Pace statusline plugin marketplace",
- "version": "0.9.6"
- },
- "plugins": [
- {
- "name": "claude-pace",
- "source": {
- "source": "github",
- "repo": "Astro-Han/claude-pace",
- "ref": "v0.9.6"
- },
- "description": "Lightweight statusline with quota pace tracking. Pure Bash + jq.",
- "category": "monitoring",
- "tags": [
- "statusline",
- "quota",
- "usage",
- "pace-tracking"
- ]
- }
- ]
- }
README.md · README · 158 lines
- # 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](https://code.claude.com/docs/en/statusline)
- - [Claude Code settings](https://docs.anthropic.com/en/docs/claude-code/settings)
- ## Table of Contents
- - [Install This Claude Code Statusline](#install-this-claude-code-statusline)
- - [Upgrade](#upgrade)
- - [Claude Code Statusline Comparison](#claude-code-statusline-comparison)
- - [How Claude Pace Tracks Quota](#how-claude-pace-tracks-quota)
- - [Claude Code Statusline FAQ](#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:**
- ```bash
- npx claude-pace
- ```
- Restart Claude Code. Done.
- **Manual:**
- ```bash
- 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](https://github.com/Astro-Han/claude-pace/releases).
- Add to `~/.claude/settings.json`:
- ```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
- | | claude-pace | [claude-hud](https://github.com/jarrodwatts/claude-hud) | [CCometixLine](https://github.com/Haleclipse/CCometixLine) | [ccstatusline](https://github.com/sirmalloc/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](https://github.com/sirmalloc/ccstatusline). The entire source of claude-pace is [one file](claude-pace.sh). Read it.
- ## How Claude Pace Tracks Quota
- 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`.
- ## 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](docs/decisions/2026-05-20-quota-cache-removal.md).
- **Can I inspect the source?**
- The entire tool is [one Bash file](claude-pace.sh). Read it before you install it.
- ## Also by the Author
- [**diffpane**](https://github.com/Astro-Han/diffpane) - Real-time TUI diff viewer for AI coding agents. See what Claude Code changes as it happens.
- ## License
- MIT
- *Last updated: 2026-11-10 · v0.9.6*
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.