Multi-line status line for Claude Code. Shows repo, GitButler/git branch, model + effort, session and daily cost, rate-limit progress, and context/token usage across four lines.

claude-statusline

An enhanced multi-line status line for Claude Code that adds repo name, git branch info, model + effort level, cost tracking, rate limits, and token usage — grouped by category across four lines.

#Features

Shows current repo name with a folder icon
GitButler support: displays active GitButler branches when on gitbutler/workspace
Falls back to regular git branch display when not using GitButler
Shows current model name with its effort level (color-coded) and a thinking-mode indicator when extended thinking is on
Cost tracking with native USD→local conversion (session + daily cost), no external CLI required
Rate limit progress bar (5-hour window with time remaining, color-coded green/yellow/red)
Falls back to session duration display when rate limit data isn't available
Context window progress bar and token usage display
Subagent rows: shows each running teammate's model in the agent panel (via subagentStatusLine)
Auto-updates from main once per day

#Status Line Example

The main session shows the four-line block:

text

📂 my-app · 🤖 Opus 4.7 (1M context) · ⚡ high · 🤔
🌿 gb/dark-mode, gb/billing-fixes, gb/onboarding-copy + 2 more
💸 A$3.14 session · 💰 A$72.50 today · ⏱️ ████░░░░░░ 42% 2h15m left
💭 ███░░░░░░░ 31% ctx · 🧠 89k in / 14k out

When you have teammates running, the agent panel below the prompt adds one row per running teammate (see Subagent rows):

text

↳ 🐝 pr-pilot · 🔮 Sonnet 5 · ↓ 81.8k tok
↳ 🐝 explorer · 🍃 Haiku 4.5 · ↓ 12.1k tok

Each line of the main block groups related information:

Line	Purpose	Contents
1	Identity + Model	📂 Repo name · 🤖 Model (with context variant in parens, e.g. `(1M context)`, when Claude Code reports one) · ⚡ Effort · 🤔 Thinking flag
2	Branches	🌿/🔀 Branch (or as many GitButler branches as fit + `+ N more`)
3	Spend & limits	💸 Session cost · 💰 Daily cost · ⏱️ Rate limit bar
4	Technical	💭 Context usage bar · 🧠 Token counts

The branches line uses the full terminal width: it shows as many full branch names as fit (comma-separated), then + N more for the rest. A single long name is truncated with ….

#Icons

Icon	Meaning
📂	Repository name
🌿	GitButler active branch(es)
🔀	Regular git branch (when not using GitButler)
🤖	Current model
⚡	Effort level (`low` dim, `medium` plain, `high` yellow, `xhigh`/`max` red)
🤔	Extended thinking is enabled (hidden when off)
💸	Session cost (local currency)
💰	Daily cost (local currency)
⏱️	5-hour rate limit (progress bar + time remaining)
💭	Context window usage (progress bar)
🧠	Token counts (input / output)

Progress bars are color-coded: green (<70%), yellow (70-89%), red (90%+).

#Subagent rows

When you run background teammates or subagents, Claude Code draws one row per teammate in the agent panel below the prompt. The default row is name · description · token count, which never tells you which model a teammate is on: a Sonnet teammate looks identical to an Opus one. This project ships a second script, subagent-statusline.sh, that rewrites those rows to put the model front and centre (see the example above):

↳ 🐝 marks a spawned worker nested under the main session.
The model glyph and name come from the teammate's own transcript, since the panel data doesn't include the model. It fills in as soon as the teammate's first response lands; before that, the row shows without a model.
Only actively-running teammates appear. Finished and idle rows are hidden, so the panel goes quiet once the work is done.

#Model glyphs

Glyph	Model family
🦉	Opus
🔮	Sonnet
🍃	Haiku
📖	Fable / Mythos

A model outside these families keeps its row but drops the glyph and name.

To enable it, add subagentStatusLine alongside statusLine in ~/.claude/settings.json:

json

"subagentStatusLine": {
  "type": "command",
  "command": "~/.claude/scripts/subagent-statusline.sh"
}

#Install

bash

curl -sSL https://raw.githubusercontent.com/gordonbeeming/claude-statusline/main/install.sh | bash

This will:

Copy statusline.sh and subagent-statusline.sh to ~/.claude/scripts/
Print instructions for updating your ~/.claude/settings.json

After running the installer, add this to your ~/.claude/settings.json:

json

"statusLine": {
  "type": "command",
  "command": "~/.claude/scripts/statusline.sh"
},
"subagentStatusLine": {
  "type": "command",
  "command": "~/.claude/scripts/subagent-statusline.sh"
}

The subagentStatusLine line is optional — leave it out if you only want the main status line.

#Dependencies

jq — for parsing JSON input, GitButler output, and the transcript cost calculation
GitButler CLI (but) — optional, for GitButler branch display

#Currency

Set STATUSLINE_CURRENCY (default AUD) to choose the display currency. Set it to USD for zero-network behaviour. Other supported codes with a custom symbol: GBP, EUR, NZD, CAD, JPY. Any ISO 4217 code with a rate on open.er-api.com also works; unknown codes render with the code as a prefix (e.g. CHF 12.34). Anything that doesn't match the ISO shape (three uppercase letters) silently falls back to AUD.

The USD→local rate is fetched once per day and cached at ~/.claude/scripts/.fx-cache-<CCY>. If the fetch fails and no cached rate is available, the statusline falls back to USD silently.

#Cost calculation

Daily cost is computed by scanning ~/.claude/projects/*/*.jsonl for today's usage records and pricing them against an inline table for the Opus / Sonnet / Haiku families (source: anthropic.com/pricing). The result is cached for 60 seconds. If you start seeing zeros after a new model release, update the pricing table near the top of statusline.sh.

#Auto-Updates

The installed script checks once per day for updates from the main branch of this repo and refreshes both statusline.sh and subagent-statusline.sh. The check runs in the background so it never slows down the status line.

Claude Statusline