| name | statusbar |
| description | ⛁ Manage your statusbar: the persistent gauge showing model, rate limits, context %, directory and git branch at the bottom of Claude Code |
Statusbar
A single command to manage the Claude Code statusbar. Detect current state and act accordingly.
Step 1: Detect current state
Check if the statusbar is installed:
- Does
~/.claude/statusbar-command.sh exist?
- Does
~/.claude/settings.json contain a statusLine key?
- Does
~/.claude/statusbar-config.json exist?
Step 2: Route based on state
If NOT installed
Tell the user the statusbar is not installed and show what it looks like:
Opus 4.6 5hr:██░░░░░░░░ 12% ctx:██░░░░░░░░ 24% Code/myproject main
Ask: Install now?
If yes, follow the install steps from /statusbar-install.
If already installed
Show current configuration and a live preview of what the statusbar looks like.
Then ask what they'd like to do:
- Configure — change segments, order, bar style, labels, display mode, thresholds
- Reset — delete config and restore defaults
- Uninstall — remove statusbar and restore previous config
Configure
Walk through options interactively. Only ask about what the user wants to change — don't force them through every option.
Available settings:
| Setting | Default | Options |
|---|
| Segments | model, rate, context, directory, branch | Pick which to show and reorder |
| Display mode | used | used (24% consumed) or remaining (76% available) |
| Color ramp | same | same (brightens in gauge color) or red (shifts to yellow/red) |
| Bar style | ██░░ | ■■□□, ●●○○, ##--, or custom characters |
| Bar width | 10 | Any number |
| Labels | rate: auto, context: ctx | Custom strings (e.g. ctx → window) |
| Thresholds | 50% / 80% | When colors shift |
| Directory | relative to ~/ | Absolute, or strip custom prefix |
Save changes to ~/.claude/statusbar-config.json. Only include keys the user customized.
Reset
Delete ~/.claude/statusbar-config.json. The statusbar script falls back to built-in defaults.
Uninstall
Follow the steps from /statusbar-uninstall. Restore any backed-up configuration.
Important
- The statusbar script is installed at
~/.claude/statusbar-command.sh (Claude's expected filename)
- The config is at
~/.claude/statusbar-config.json (our config)
- The settings.json key is
statusLine (Claude's key name)
- After any changes, remind the user to restart Claude Code
jq is required at runtime for the statusbar script
