Claude Statusline

claude-statusline
  A rich statusline for Claude Code — pure bash, no Node.js required.

  English ·
  한국어

  Install ·
  Features ·
  Config ·
  How it works ·
  vs claude-hud

Why?

The default Claude Code statusline only shows the model name and cost. You don't know:

- How much context you've used until compaction hits
- How close you are to rate limits
- What tools/agents are running in the background
- How much you've spent today, this week, or this month

Even on Max plan where cost isn't a concern, tracking your token usage helps you understand your usage patterns and optimize your workflow.

This statusline fixes all of that.

What it shows

Header badges

Badges only appear when the data exists — e.g. ⚡fast shows only with fast mode on, PR #42 only while a PR is open.

Per-model rate limit buckets

Model-specific weekly buckets are auto-detected from the OAuth usage API — whatever buckets Anthropic reports for your plan show up automatically, so new models appear without a script update. They are ordered by model capability (most capable first, Fable > Opus > Sonnet > Haiku), and buckets the API reports as null (inactive for your plan) are hidden. An Extra gauge appears when extra usage credits are enabled on your account.
Note: which buckets exist depends on your plan and usage. A bucket only appears once that model has tracked usage — most accounts see just one (e.g. Sonnet, as above); Opus shows once you've used Opus. When more than one is active they sort by capability, and any new model Anthropic adds appears automatically — no update needed.

Color coding

Other methods

Clone & install

Manual

Add to ~/.claude/settings.json:

Prerequisites

- jq and curl — the installers auto-install these via your package manager (brew / apt / dnf / yum / pacman /…