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:

1. Configure — change segments, order, bar style, labels, display mode, thresholds
2. Reset — delete config and restore defaults
3. 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:

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