Claude Code status line

claude-pace

A pure Bash and jq status line that tracks rate limits and tells you whether your usage pace is sustainable.

245 stars 22 forksStatus lines Plugin marketplace Source

Install

Inside Claude Code
/plugin marketplace add Astro-Han/claude-pace
From source
git clone https://github.com/Astro-Han/claude-pace.git

From the README

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:

npx:

Restart Claude Code. Done.

Manual:

This…
Read the full README on GitHub

How status lines work

  • A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
  • Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
  • Or run /statusline inside Claude Code and describe what you want.
Claude Code docs

Details

Language
Shell
License
MIT
Last updated
24 September 2026
Topics
anthropicbashclaudeclaude-codeclaude-code-statuslineclideveloper-toolsjqpluginquota-trackerrate-limitstatusline

FAQ

What is claude-pace?

A pure Bash and jq status line that tracks rate limits and tells you whether your usage pace is sustainable. It is a status line for Claude Code, from Astro-Han/claude-pace on GitHub.

How do I install claude-pace?

Run /plugin marketplace add Astro-Han/claude-pace inside Claude Code, then follow the setup in the README.

Is claude-pace popular?

Astro-Han/claude-pace has 245 GitHub stars and 22 forks, and is included in 1 curated Claude Code list. It was last updated on 24 September 2026.

More status lines

Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.