thevibeworks/claude-code-statusline

Claude Code Statusline

Quota, context, cost, model, and git -- live in your Claude Code prompt.

<p align="center" <img src="assets/statusline-preview.svg" alt="Claude Code Statusline" width="100%" </p

<p align="center"<a href="https://thevibeworks.github.io/claude-code-statusline/"<bLive animated demo →</b</a</p

One Bash file that plugs into the official statusLine command hook. Shows what matters: active model, context window, session cost, 5h / 7d quota with reset times, prompt-cache health, extra-usage spend, git activity, and subscription tier. When the numbers stop meaning what they appear to mean, the notice engine interprets them — cap projections, expiring-surplus and underuse advice, which model caps first, out-of-band quota re-bases, sibling-account relief. No daemon, no telemetry, no npm.

Install

curl -fsSL https://raw.githubusercontent.com/thevibeworks/claude-code-statusline/main/install.sh | bash

Downloads statusline.sh and the usage-insight skill to ~/.claude/ and wires up settings.json. Re-run it any time to update: it replaces the script but keeps the flags already on your statusLine.command. Restart Claude Code (or send a message) and the statusline appears.

Requires: Bash, jq, curl. STATUSLINESKILL=0 skips the skill; CLAUDECONFIGDIR targets another config dir.

Install from a checkout

git clone https://github.com/thevibeworks/claude-code-statusline
cd claude-code-statusline
make install        # this tree -> ~/.claude, same installer, no download
make status         # installed vs tree, the settings command, the skill

make install runs install.sh with STATUSLINESRC set, so the local path and the curl one-liner share one installer and cannot drift. It refuses to install a statusline.sh that does not parse. make install-check runs shellcheck and the test suite first; make help lists the rest.

Install via Claude Code

Paste this into Claude Code and it will set everything up:

Install claude-code-statusline: download https://raw.githubusercontent.com/thevibeworks/claude-code-statusline/main/statusline.sh to ~/.claude/statusline.sh, make it executable, and add a statusLine command entry to ~/.claude/settings.json pointing to it with padding 0.

<details<summaryManual install / inspect first</summary

# Download and inspect
curl -fsSL https://raw.githubusercontent.com/thevibeworks/claude-code-statusline/main/install.sh -o /tmp/install-statusline.sh
less /tmp/install-statusline.sh
bash /tmp/install-statusline.sh

# Or skip the installer entirely
curl -fsSL https://raw.githubusercontent.com/thevibeworks/claude-code-statusline/main/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

Then add to ~/.claude/settings.json: