claude-token-burn-bar 🔥

A compact, color-coded status line plugin for Claude Code.

See your session & weekly rate limits with progress bars and reset timers — all in one line.

[Opus 4.6 (1M context)] session ━━━───── 38% (Resets in 3 hr 54 min) | weekly ━━━━──── 42% (Resets Tue 3:00 PM)

Features

• Session limit — progress bar + percentage of 5-hour rate limit used
• Weekly limit — progress bar + percentage of 7-day rate limit used
• Session reset countdown — (Resets in X hr Y min)
• Weekly reset date — (Resets Tue 3:00 PM)
• Color-coded — green / yellow / red based on usage
• Graceful fallback — shows -- when rate limit data isn't available yet

Note

When you first open Claude Code, the status line will show placeholder values (────── --) because rate limit data has not been fetched yet. This is normal — Claude Code only receives rate limit information after your first API request. Simply send any message and the status line will update with real data.

Color coding

Usage	Color
< 50%	Green
50-79%	Yellow
>= 80%	Red

Installation

Step 1: Add the marketplace and install the plugin

claude plugin marketplace add blackmetalz/claude-token-burn-bar
claude plugin install claude-token-burn-bar@blackmetalz-claude-token-burn-bar

Step 2: Run the setup skill inside Claude Code

Open Claude Code and run the setup skill:

/claude-token-burn-bar:setup-burn-bar

This will automatically configure the status line in your ~/.claude/settings.json.

Step 3: Restart Claude Code

The status line will appear after restart. On first launch it shows placeholder values (────── --) — send any message and it will update with real data.

Uninstall

Remove the plugin and clean up settings:

claude plugin remove claude-token-burn-bar@blackmetalz-claude-token-burn-bar

Then remove the statusLine key from ~/.claude/settings.json manually, or run:

# From the plugin repo (if cloned)
bash uninstall.sh

Reinstall (for testing)

Note: claude plugin update may cache marketplace data for a few minutes. For rapid development, use remove + install instead.

claude plugin remove claude-token-burn-bar@blackmetalz-claude-token-burn-bar && claude plugin install claude-token-burn-bar@blackmetalz-claude-token-burn-bar

Then run /claude-token-burn-bar:setup-burn-bar again inside Claude Code and restart.

Requirements

• jq must be installed
• Claude Code with status line support

License

MIT