Skip to content
Back to search

claude-pace-marketplace

SkillWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/astro-han--claude-pace/badge.svg)](/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

i

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
  1. {
  2. "name": "claude-pace-marketplace",
  3. "owner": {
  4. "name": "yuhan",
  5. "email": "lei.yuhan@outlook.com"
  6. },
  7. "metadata": {
  8. "description": "Claude Pace statusline plugin marketplace",
  9. "version": "0.9.6"
  10. },
  11. "plugins": [
  12. {
  13. "name": "claude-pace",
  14. "source": {
  15. "source": "github",
  16. "repo": "Astro-Han/claude-pace",
  17. "ref": "v0.9.6"
  18. },
  19. "description": "Lightweight statusline with quota pace tracking. Pure Bash + jq.",
  20. "category": "monitoring",
  21. "tags": [
  22. "statusline",
  23. "quota",
  24. "usage",
  25. "pace-tracking"
  26. ]
  27. }
  28. ]
  29. }
README.md · README · 158 lines
  1. # Claude Pace
  2. 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.
  3. 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.
  4. ![claude-pace statusline demo](.github/claude-pace-demo.gif)
  5. ## TL;DR
  6. - Claude Code status line with `5h` and `7d` quota usage, reset countdowns, and pace delta
  7. - Pace-aware rate limit tracking, `⇡15%` means overspending, `⇣15%` means headroom
  8. - Pure Bash + jq, single file, no Node.js runtime and no lockfile churn
  9. - Install as a Claude Code plugin, with `npx`, or as a single script
  10. 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.
  11. - **⇣15%** green = you've used 15% less than expected. Headroom. Keep going.
  12. - **⇡15%** red = you're burning 15% faster than sustainable. Slow down.
  13. - **15%** / **20%** = used in the 5h and 7d windows. **3h** = resets in 3 hours.
  14. - Top line: model, effort, project `(branch)`, `3f +24 -7` = git diff stats
  15. Claude Code supports custom status lines through its `statusLine` setting and `/statusline` workflow in the official docs:
  16. - [Customize your status line](https://code.claude.com/docs/en/statusline)
  17. - [Claude Code settings](https://docs.anthropic.com/en/docs/claude-code/settings)
  18. ## Table of Contents
  19. - [Install This Claude Code Statusline](#install-this-claude-code-statusline)
  20. - [Upgrade](#upgrade)
  21. - [Claude Code Statusline Comparison](#claude-code-statusline-comparison)
  22. - [How Claude Pace Tracks Quota](#how-claude-pace-tracks-quota)
  23. - [Claude Code Statusline FAQ](#claude-code-statusline-faq)
  24. ## Install This Claude Code Statusline
  25. Requires `jq`.
  26. **Plugin (recommended):**
  27. Inside Claude Code:
  28. ```
  29. /plugin marketplace add Astro-Han/claude-pace
  30. /plugin install claude-pace
  31. /reload-plugins
  32. /claude-pace:setup
  33. ```
  34. **npx:**
  35. ```bash
  36. npx claude-pace
  37. ```
  38. Restart Claude Code. Done.
  39. **Manual:**
  40. ```bash
  41. mkdir -p ~/.claude
  42. curl -fsSL -o ~/.claude/statusline.sh.new \
  43. https://github.com/Astro-Han/claude-pace/releases/latest/download/claude-pace.sh
  44. mv ~/.claude/statusline.sh.new ~/.claude/statusline.sh
  45. chmod +x ~/.claude/statusline.sh
  46. ```
  47. This installs the latest release, not the current state of `main`. To pin an exact
  48. version, swap `latest/download` for `download/vX.Y.Z` with a tag from
  49. [Releases](https://github.com/Astro-Han/claude-pace/releases).
  50. Add to `~/.claude/settings.json`:
  51. ```json
  52. {
  53. "statusLine": {
  54. "type": "command",
  55. "command": "~/.claude/statusline.sh"
  56. }
  57. }
  58. ```
  59. Restart Claude Code. Done.
  60. To remove: delete the `statusLine` block from `~/.claude/settings.json`.
  61. ## Upgrade
  62. - **Plugin:**
  63. ```
  64. /plugin marketplace update claude-pace-marketplace
  65. /plugin update claude-pace
  66. /reload-plugins
  67. /claude-pace:setup
  68. ```
  69. - **npx:** `npx claude-pace@latest`
  70. - **Manual:** Re-run the `curl` command above.
  71. Every channel installs a tagged release. `/claude-pace:setup` copies the script the
  72. plugin ships rather than downloading one, so the plugin version you have is the
  73. version you run. Nothing installs from `main`.
  74. Release notifications: Watch this repo → Custom → Releases.
  75. ## Claude Code Statusline Comparison
  76. | | claude-pace | [claude-hud](https://github.com/jarrodwatts/claude-hud) | [CCometixLine](https://github.com/Haleclipse/CCometixLine) | [ccstatusline](https://github.com/sirmalloc/ccstatusline) |
  77. |---|---|---|---|---|
  78. | Runtime | `jq` | Node.js 18+ / npm | Compiled (Rust) | Node.js / npm |
  79. | Codebase | Single Bash file | 1000+ lines + node_modules | Compiled binary | 1000+ lines + node_modules |
  80. | Rate limit tracking | 5h + 7d usage %, pace delta, reset countdown | Usage % | Usage % (planned) | None (formatting only) |
  81. | Execution | ~10ms | ~90ms | ~5ms | ~90ms |
  82. | Memory | ~2 MB | ~57 MB | ~3 MB | ~57 MB |
  83. Execution and memory measured on Apple Silicon, 300 runs, same stdin JSON.
  84. 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.
  85. ## How Claude Pace Tracks Quota
  86. Claude Code polls the statusline every ~300ms:
  87. | Data | Source | Cache |
  88. |------|--------|-------|
  89. | Model, context, cost | stdin JSON (single `jq` call) | None needed |
  90. | Quota (5h, 7d, pace) | stdin `rate_limits` (live, no fallback) | None |
  91. | Git branch + diff | `git` commands | Private cache dir, 5s TTL |
  92. 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.
  93. 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`.
  94. ## Claude Code Statusline FAQ
  95. **Does it need Node.js?**
  96. No. Only `jq` (available via `brew install jq` or your package manager). No npm, no node_modules, no lock files.
  97. **How does pace tracking work?**
  98. 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).
  99. **Does it make network calls?**
  100. 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).
  101. **Can I inspect the source?**
  102. The entire tool is [one Bash file](claude-pace.sh). Read it before you install it.
  103. ## Also by the Author
  104. [**diffpane**](https://github.com/Astro-Han/diffpane) - Real-time TUI diff viewer for AI coding agents. See what Claude Code changes as it happens.
  105. ## License
  106. MIT
  107. *Last updated: 2026-11-10 · v0.9.6*

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.