Statusline Generator

A single-source-of-truth statusline for Claude Code. One script, two layouts, end-to-end self-verification.

Quick health check (start here when something is wrong)

Run this first whenever the statusline misbehaves. It catches the silent failures that account for most "configured but not working" reports:

bash scripts/health_check.sh

It validates four layers:

1. ~/.claude/statusline.sh exists and is executable. Missing chmod +x is the single most common silent-failure cause, Claude Code runs the script, exec fails, statusline goes blank.
2. ~/.claude/settings.json has a valid statusLine block pointing at the script.
3. Mock stdin tests covering complete data, zero tokens, missing fields, $HOME path shortening, and zero-fork git-branch rendering (via a synthetic .git/HEAD, no git binary required).
4. Real stdin replay from /tmp/.claude-statusline-last-stdin.json if you previously ran with CLAUDE_STATUSLINE_DEBUG=1.

Each failure prints a one-line fix command, you don't have to read documentation to recover.

Quick install

bash scripts/install_statusline.sh

This script:

• Backs up any existing ~/.claude/statusline.sh and settings.json.
• Copies generate_statusline.sh to ~/.claude/statusline.sh and chmod +xs it.
• Updates settings.json statusLine block via jq (preserves other settings).
• Mandatorily runs health_check.sh and shows the result, installation is not "complete" until verification passes.

Restart Claude Code (or send any new message) to see the statusline update.

What you get

Default, minimal one-line layout

~/code/myproject  [main]  Opus 4.7 (1M context)  ctx: 108K / 1M