Claude Gauge
mil-orb/claude-gauge
Monitore rate limit e custos em tempo real na barra de status
Ver no GitHubPlugin para Claude Code que monitora rate limit, uso de tokens e custos em tempo real diretamente na barra de status. Fornece visualização live do consumo de quota sem necessidade de checar dashboards externos ou executar comandos que quebram o fluxo de trabalho.
Instalação
npx convez-ai mil-orb/claude-gauge1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Acompanhar consumo de quota durante sessões de programação
- Visualizar custos acumulados por sessão em tempo real
- Detectar aproximação do rate limit antes de uma falha
- Otimizar uso de tokens durante desenvolvimento com Claude Code
Veredito

Solução prática e zero-overhead para governança de rate limit no Claude Code. Elimina fricção ao trazer métricas essenciais para a barra de status, sem APIs externas ou dependências — recomendado para desenvolvedores que trabalham frequentemente com Claude Code e precisam controlar custos.
README
A tradução para o português deste README ainda está na fila.
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.
How It Works
Claude Code → statusline.js → reads native rate_limits field
from Claude Code's statusline JSON
↓
Renders fuel bar + session metrics
Claude 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.
Install
Step 1 — In Claude Code, run these two commands:
/plugin marketplace add mil-orb/claude-gauge
/plugin install claude-gauge
Step 2 — Restart Claude Code.
That's it. The gauge appears in your status line immediately.
What You See
████████▒░░░░░░░░░░░ ⚡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)
- Bar fills from left as utilization climbs (use
drainmode for a fuel gauge that empties) - Color shifts green → yellow → red with your chosen color scheme
⚡32%— your 5-hour rolling utilization percentage- Session tokens are read from Claude Code's local JSONL transcript files
Display Types
Five built-in visualizations:
| 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 |
Color Schemes
Seven 24-bit true color schemes that escalate as utilization climbs:
| 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.
Configuration
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.json
Uninstall
Step 1 — Run the uninstall script:
bash ~/.claude/plugins/cache/mil-orb/claude-gauge/*/scripts/uninstall.sh
Step 2 — Remove the plugin from Claude Code:
/plugin uninstall claude-gauge
Step 3 — Start a new Claude Code session.
- Restores your status line — restores your previous statusline config from backup, or removes the
statusLineblock from~/.claude/settings.json
Requirements
- Node.js 18+ (included with Claude Code)
- Claude Code v2.1.80+ (provides native
rate_limitsfield) - A terminal with 24-bit color support (most modern terminals)
- No additional dependencies
License
MIT