Claude Gauge — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Claude Gauge (Plugin) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
Aggregate score unchanged between these scans.
The primary manifest — the file an agent reads to learn what this artifact does.
<p align="center"> <img src="assets/session-demo.gif" alt="claude-gauge demo" width="580"> </p>
<h1 align="center">claude-gauge</h1>
<p align="center"> Rate limit awareness for Claude Code — without wasting a single token. </p>
<p align="center"> <img src="https://img.shields.io/badge/Claude_Code-plugin-5A45FF?style=flat-square" alt="Claude Code Plugin"> <img src="https://img.shields.io/badge/node-18%2B-brightgreen?style=flat-square" alt="Node 18+"> <img src="https://img.shields.io/badge/zero-dependencies-blue?style=flat-square" alt="Zero Dependencies"> <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License"> <a href="https://github.com/mil-orb/claude-gauge/actions/workflows/github-code-scanning/codeql"><img src="https://github.com/mil-orb/claude-gauge/actions/workflows/github-code-scanning/codeql/badge.svg" alt="CodeQL"></a> </p>
You don't know you're approaching your rate limit until Claude stops responding. Checking with /usage breaks your flow. Alt-tabbing to the Anthropic dashboard breaks it even more.
claude-gauge puts a live session dashboard in your status line — rate limit utilization, token count, cost, and session duration, all in one glanceable bar. The bar fills as you consume quota — green when you're fine, red when you're running low. Always visible, zero interruption.
Claude Code → statusline.js → reads native rate_limits field
from Claude Code's statusline JSON
↓
Renders fuel bar + session metricsClaude Code (v2.1.80+) natively provides rate limit data in the rate_limits field of the JSON passed to statusline scripts. claude-gauge reads this directly — no proxy, no extra API calls, no external dependencies.
Step 1 — In Claude Code, run these two commands:
/plugin marketplace add mil-orb/claude-gauge
/plugin install claude-gaugeStep 2 — Restart Claude Code.
That's it. The gauge appears in your status line immediately.
<p align="center"> <img src="assets/screenshot.png" alt="claude-gauge in Claude Code" width="580"> </p>
████████▒░░░░░░░░░░░ ⚡32% · 47.9k · $1.84 · 3m
│ │ │ │ └─ session duration
│ │ │ └──────── session cost (USD)
│ │ └───────────────── session tokens (input + output)
│ └───────────────────────── 5h rate limit utilization
└─────────────────────────────────────────────── gauge bar (fills as quota is consumed)drain mode for a fuel gauge that empties)⚡32% — your 5-hour rolling utilization percentageFive built-in visualizations:
<p align="center"> <img src="assets/display-modes.gif" alt="display modes" width="580"> </p>
| Type | Preview | Description |
|---|---|---|
bar | ██████████████░░░░░░ | Default — fills as quota is consumed |
drain | ░░░░░░██████████████ | Fuel gauge — empties as quota is consumed |
dots | ●●●●●●●●●●●●●○○○○○○ | Minimal circle pips |
blocks | ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀ | Dense braille blocks |
compact | ● ⚡23% | Text only, no bar |
Seven 24-bit true color schemes that escalate as utilization climbs:
<p align="center"> <img src="assets/color-schemes.gif" alt="color schemes" width="580"> </p>
| Scheme | Transition | Style |
|---|---|---|
gradient | green → yellow → red | Uniform fill, single color |
ocean | cyan → blue → purple | Uniform fill |
ember | yellow → orange → deep red | Uniform fill |
frost | white → light blue → deep blue | Uniform fill |
retro | green / yellow / red | Hard CGA steps at 33%/66% |
spectrum | green → yellow → red | Per-character gradient — each bar character is a different color |
mono | white → gray → dark | Grayscale |
spectrum is the only per-character scheme — it paints a full rainbow gradient across the bar width regardless of fill level. All others apply one color uniformly based on utilization percentage.
Run /claude-gauge:config for an interactive setup, or edit config.json in the plugin directory directly. Changes take effect on the next status line refresh — no restart needed.
{
"display": "bar", // bar, drain, dots, blocks, compact
"color": "gradient", // gradient, ocean, ember, frost, retro, spectrum, mono
"bar_size": "medium", // small (10), medium (20), large (30), xlarge (40), or a number
"show_cost": true, // running session cost in USD
"show_duration": true, // elapsed session time
"show_lines": false, // lines added and removed
"currency_rate": null // local currency conversion (e.g. 0.79 for GBP, symbol auto-detected)
}Tip: Config path is ~/.claude/plugins/claude-gauge/config.jsonStep 1 — Run the uninstall script:
bash ~/.claude/plugins/cache/mil-orb/claude-gauge/*/scripts/uninstall.shStep 2 — Remove the plugin from Claude Code:
/plugin uninstall claude-gaugeStep 3 — Start a new Claude Code session.
<details> <summary>What the uninstall script does</summary>
statusLine block from ~/.claude/settings.json</details>
rate_limits field)MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.