Claude Code Statusline Kit (Free)

A status line for Claude Code that shows what you actually need to keep working: how full the context window is, what the session has cost, how much of your 5-hour and weekly limits you've used and when they reset, whether the prompt cache is still warm, plus git branch, PR and model. One Python file, no dependencies, under 50 ms.

Opus | acme-app/web | git:feat/login +1~2 | ███████░░░ 74% 148k/200k | $3.47 | 5h 24% ↻2h15m 7d 91% ↻2d5h

python3 install.py                       # default preset; backs up ~/.claude/settings.json and keeps your other settings
python3 install.py --preset two-line --icons emoji
python3 install.py --project             # this repo only (.claude/settings.json)
python3 install.py --uninstall

It copies statusline.py to ~/.claude/ and sets:

{"statusLine": {"type": "command", "command": "python3 ~/.claude/statusline.py", "padding": 0}}

The line appears after your next message. On Windows the command uses python (Claude Code runs it through Git Bash or PowerShell).

Colors turn yellow at 70% and red at 90% (warn_at, danger_at). Fields Claude Code hasn't sent yet are skipped, never shown as errors. When the terminal is narrow it drops the least important parts first (it reads COLUMNS, as the docs require). It respects NO_COLOR. Any error prints a plain fallback and exits 0, so the UI never breaks.

~/.claude/statusline.json:

{"preset": "full", "icons": "nerd", "bar_width": 12, "warn_at": 60, "danger_at": 85, "git_cache_seconds": 5,
 "lines": [["model", "dir", "git"], ["context", "limits", "cost"]]}

Presets: minimal, default, full, two-line. lines overrides the preset with your own segment order (names from the table: model, effort, dir, git, pr, context, cache, cost, limits, lines, duration, vim, agent). For a ticking reset countdown, install with --refresh 30.

./demo.sh renders every preset for a sample session. ./run_tests.sh runs 10 tests (rendering, null fields, narrow terminals, git parsing, installer keeping your settings).

Field names were checked against the Claude Code status line docs (code.claude.com/docs/en/statusline) on Nov 10, 2026. Not affiliated with Anthropic.

• The 5-hour and 7-day limits show only on Pro, Max and Ultra plans, after the first reply.
• Git status has a 1 s timeout and is cached 5 s.