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.
Topics
Summary and scoring are generated automatically from the original article. We always link back to the publisher and never republish images or paywalled content. Last processed Apr 19, 2026 · 11:33 UTC. How this works →