A minimal statusline for Claude Code. One command to install, three presets, zero dependencies.
npx statusline-pro
Running it in a terminal opens an interactive picker: preset, then theme, then context display, each with a live preview rendered from your real session data. Pick one at each step, hit Enter, done. No config file is written — your choices live in the statusline command itself. Run it again any time to change them; it starts from whatever's currently installed.
compact
default — adds the weekly quota window (and git branch, if you're in a repo)
full — two lines with extra-usage budget and session cost
Everything renders in warm gray until a metric gets hot: amber past the warn threshold, red past crit, and only the single highest-priority hot metric is bold. When the terminal is narrow, low-value segments drop first (session cost, then reset times, then branch) so context and quota always survive.
Subscription vs API-key mode is detected automatically: subscriptions get the 5-hour and weekly quota windows, API keys get exact session cost instead.
All set by the interactive picker — no flags to remember:
| Option | Choices | Description |
|---|---|---|
| Preset | compact / default / full |
Layout |
| Theme | dark / light |
Palette, default dark |
| Context | percentage / gauge |
Show context as a number or a 5-cell gauge |
Light theme:
Context gauge:
npx statusline-pro --uninstall
Restores whatever statusline you had before, exactly — the installer backs up your previous statusLine entry (and its script, if it pointed at one) and puts it back.
Node ≥ 18. No runtime dependencies.
MIT