---
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:

| 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