Fuelgauge adds color-coded Claude Code usage bars without Node
Fuelgauge is a lightweight Claude Code plugin that displays a real-time status line showing folder, git branch, and color-coded progress bars for context, 5-hour, and 7-day API usage — with no Node.js dependency required.
Score breakdown
Track Claude Code's rolling rate limits in real time so you can pace token usage and avoid surprise budget exhaustion mid-session.
- 01Displays a Claude Code status line with folder name, git branch, and progress bars for context, 5-hour, and 7-day usage.
- 02Color thresholds: green under 70%, yellow 70–89%, red at 90%+.
- 03Runs entirely locally via shell scripts — makes zero API calls and has no Node.js dependency.
Fuelgauge is a cross-platform Claude Code status line plugin published by adityaarakeri that surfaces three critical usage metrics directly in the Claude Code interface: context window fill percentage, 5-hour rate-limit consumption, and 7-day rate-limit consumption. Each metric is rendered as a block progress bar with color thresholds — green below 70%, yellow from 70–89%, and red at 90% and above — alongside the current folder name and active git branch. The motivation is explicit: Claude Code's rate limits are structured on 5-hour and 7-day rolling windows, and without a persistent visual indicator it's easy to exhaust a weekly budget unnoticed.
Installation is handled through Claude Code's plugin system with three commands (`/plugin marketplace add adityaarakeri/fuelgauge`, `/plugin install fuelgauge`, `/fuelgauge:setup`) followed by a restart.
Installation is handled through Claude Code's plugin system with three commands (`/plugin marketplace add adityaarakeri/fuelgauge`, `/plugin install fuelgauge`, `/fuelgauge:setup`) followed by a restart. Manual configuration is also supported by editing `~/.claude/settings.json` to point the `statusLine` command at the bundled shell or PowerShell script. The tool has no runtime cost: it reads data Claude Code already holds locally, makes zero API calls, and fires updates at most every 300ms tied to conversation message changes. On Unix systems the only dependencies are `jq` and `git`; on native Windows it needs `git` on PATH and PowerShell 5.1 or 7+. The 5-hour and 7-day usage bars require Claude Code `v1.2.80` or newer — older versions will display 0% for those metrics. The project is MIT-licensed.
Key facts
- 01Displays a Claude Code status line with folder name, git branch, and progress bars for context, 5-hour, and 7-day usage.
- 02Color thresholds: green under 70%, yellow 70–89%, red at 90%+.
- 03Runs entirely locally via shell scripts — makes zero API calls and has no Node.js dependency.
- 04Updates are throttled to at most every 300ms and only trigger on conversation message changes.
- 05Requires `jq` and `git` on macOS/Linux/WSL; PowerShell 5.1 or 7+ on native Windows.
- 065-hour and 7-day usage bars require Claude Code `v1.2.80` or newer; older versions show 0%.
- 07Published by adityaarakeri under the MIT license; shared on Hacker News by humblejedi.