convez.ai
SkillDevOps & InfraestruturaIntermediário
mil-orb

Claude Gauge

mil-orb/claude-gauge

Monitore rate limit e custos em tempo real na barra de status

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin 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-gauge

1 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

Estrelas
5
Forks
0
Acompanhando
2
Saúde
57%
Último commit
há 8 meses
Versão
v1.1.1
Issues abertas
0
Contribuidores
3

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 drain mode 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:

TypePreviewDescription
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:

SchemeTransitionStyle
gradientgreen → yellow → redUniform fill, single color
oceancyan → blue → purpleUniform fill
emberyellow → orange → deep redUniform fill
frostwhite → light blue → deep blueUniform fill
retrogreen / yellow / redHard CGA steps at 33%/66%
spectrumgreen → yellow → redPer-character gradient — each bar character is a different color
monowhite → gray → darkGrayscale

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 statusLine block from ~/.claude/settings.json

Requirements

  • Node.js 18+ (included with Claude Code)
  • Claude Code v2.1.80+ (provides native rate_limits field)
  • A terminal with 24-bit color support (most modern terminals)
  • No additional dependencies

License

MIT

Ver o original no GitHub

Bom para

Relacionados