Claude Code statusline

What I built

• One Bash script that Claude Code runs as its statusLine command: it reads the session JSON on stdin and prints a single coloured line
• A 20-block context bar that turns from green to yellow to red as the window fills, next to input and output token totals
• Session cost with cost per minute, and a day total summed from a local log of every session's latest cost
• Burn rate in tokens per minute and an estimate of the minutes left before the context window is full
• Lines added and removed, cache hit rate, and output tokens per dollar with a rank from bronze (5,000) to trophy (50,000)
• Test results from a .test-status file, JUnit XML reports or Playwright's last run, and the git branch with staged, unstaged and untracked counts
• 5-hour and 7-day plan usage from Anthropic's OAuth usage endpoint, with the token read from the macOS Keychain

How it works

1. ReadClaude Code pipes the session JSON to the script on each status update.
2. ComputeContext bar, cost per minute, burn rate, ETA and cache hit rate with jq and bc.
3. CollectGit state cached 5 s, test results and the day total cached 30 s.
4. LimitsPlan usage from the Anthropic API, at most once a minute.
5. PrintUp to 15 segments in one ANSI-coloured line; empty ones are left out.

Quality and reliability

• Every slow source sits behind a file cache: git for 5 s, test results and the day total for 30 s, plan usage for 60 s, so a render stays cheap
• The day total keeps only the latest cost of each session from the log, so a session that renders a thousand times counts once
• Without a Keychain token, or when the API does not answer within 5 seconds, the line still prints: the last cached limits stay, or the segment is left out

Technology

• Bash
• jq
• bc
• curl
• git
• macOS Keychain (security)
• Claude Code statusLine hook