usage-bar

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.