A minimal Claude Code statusline showing branch, diff, model, context, throughput, and rate limit usage.

• Essential – relevant indicators shown without extra labels, dividers, or empty states
• Quiet – supporting the main action, not competing with it
• Terminal-first – plain text symbols, no emojis

Indicators without data are hidden rather than shown empty.

1. Download the script:

curl -o ~/.claude/statusline.sh https://raw.githubusercontent.com/levibe/claude-code-statusline/main/statusline.sh && chmod +x ~/.claude/statusline.sh

Or clone and symlink: git clone https://github.com/levibe/claude-code-statusline && ln -s claude-code-statusline/statusline.sh ~/.claude/statusline.sh

2. Add to your ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

3. Restart Claude Code.

• jq – JSON parsing
• git – branch and diff information

brew install jq git or apt install jq git

• Tracks text diffs, untracked files, and binary file changes (binary files count as +1 added or -1 removed)
• Caps line counting at 10k to avoid slowdowns on large diffs
• TPM uses a 5-minute sliding window and includes subagent token usage
• Shows short SHA on detached HEAD; falls back to symbolic ref in empty repos
• Uses --no-optional-locks on all git calls to prevent lock contention
• Fixes model name bleeding across sessions (CC bug)
• Validates model names to filter garbled input from Claude Code

CHANGELOG.md

Run the test suite:

brew install bats-core  # https://bats-core.readthedocs.io/en/stable/installation.html
bats test/

Issues and feature requests

MIT