---
name: usage-bar
description: Install or check the Claude Code usage status bar (rate limits 5h/7d, session context, reset countdown). Also use to change the display language.
user-invocable: true
allowed-tools: Bash(python3 *), Bash(bash *), Bash(chmod *), Bash(cp *), Bash(mkdir *), Bash(grep *), Bash(cat *)
---

# claude-usage-bar

Manage the persistent status bar that shows Claude Code usage limits.

## Step 1 — Check installation status

```
!`test -f ~/.claude/statusline-usage.sh && echo "INSTALLED" || echo "NOT_INSTALLED"`
```

```
!`test -f ~/.claude/usage-bar.conf && cat ~/.claude/usage-bar.conf || echo "NO_CONFIG"`
```

## Step 2 — Act on the result

### If NOT installed

Copy the script from the skill directory and update settings.json:

```
!`
cp "${CLAUDE_SKILL_DIR}/statusline-usage.sh" ~/.claude/statusline-usage.sh
chmod +x ~/.claude/statusline-usage.sh
`
```

```
!`python3 -c "
import json, os
p = os.path.expanduser('~/.claude/settings.json')
try: cfg = json.load(open(p))
except: cfg = {}
cfg['statusLine'] = {'type': 'command', 'command': '~/.claude/statusline-usage.sh'}
with open(p, 'w') as f: json.dump(cfg, f, indent=2); f.write('\n')
print('settings.json updated.')
"`
```

Write the default config file:

```
!`cat > ~/.claude/usage-bar.conf << 'EOF'
# claude-usage-bar — configuration
# Available languages: en (English), it (Italian)
# Override per-session: USAGE_BAR_LANG=it claude
#
LANG=en
EOF
echo "Config written."`
```

Tell the user installation is complete and they need to **restart Claude Code** to see the bar.

### If already installed — show live test

Run a live preview with simulated data:

```
!`bash ~/.claude/statusline-usage.sh <<'EOF'
{"context_window":{"used_percentage":42},"rate_limits":{"five_hour":{"used_percentage":28.0,"resets_at":1800},"seven_day":{"used_percentage":85.0,"resets_at":345600}}}
EOF`
```

Also show the current language setting from the config file.

### If the user wants to change language

Ask which language they want, then update `~/.claude/usage-bar.conf`:

```
!`sed -i 's/^LANG=.*/LANG=it/' ~/.claude/usage-bar.conf && echo "Language set to: it"`
```

Replace `it` with the desired language code. No restart needed — the change takes effect on the next response.

---

## Field reference

Explain to the user what each field means:

- **5h** — Rate limit over the last 5 hours (daily proxy). Green < 80%, orange 80–90%, red ≥ 90%
- **7d** — Weekly rate limit. Same color scale
- **ctx** — Context window usage for the current session. Green < 70%, orange 70–80%, red > 80%
- **reset** — Countdown to limit reset. Hours/minutes if < 24h, days and hours if ≥ 24h
- Rate limit data is only available with a **Claude.ai Pro or Max** plan

## Supported languages

| Code | Language |
|------|----------|
| `en` | English  |
| `it` | Italiano |

To add a new language, open `statusline-usage.sh` and add a new entry to the `T` dictionary in the Python section.