convez.ai
PluginDevOps & InfraestruturaIniciante
supermrpj

Claude Status Line Bash

supermrpj/claude-status-bash

Dashboard de custos e tokens em tempo real para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Script Bash leve que exibe um painel de status em tempo real na barra de status do Claude Code, mostrando consumo de tokens, custos de API, cache hits e limites de taxa de requisição em uma única linha colorida.

Instalação

$npx convez-ai supermrpj/claude-status-bash

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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 meses
Versão
v1.0.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar gastos de API durante sessões de codificação
  • Acompanhar consumo de tokens e eficiência do cache em tempo real
  • Controlar limites de taxa horária e semanal durante desenvolvimento
  • Otimizar custos observando impacto do prompt caching

Veredito

Ferramenta prática e minimalista para desenvolvedores usando Claude Code que precisam rastrear custos e uso de tokens. Instalação simples, zero dependências críticas além de jq, e feedback visual imediato — útil para quem quer evitar surpresas na conta.

README

A tradução para o português deste README ainda está na fila.

Claude Status Line

A lightweight Bash script for Claude Code that displays a real-time dashboard in the status bar showing token usage, API costs, cache hits, and rate limit consumption — all in a single, color-coded line.

 Cost: $0.042  |  In: 18432  |  Cache: 12100  |  Out: 841  |  5H: 12% (reset at 22:30)  |  7D: 3% (reset at 02/May 14:00)

Preview image

Prerequisites

This script requires jq to parse the JSON payload from Claude Code.

PlatformInstall command
macOSbrew install jq
Debian / Ubuntusudo apt-get install jq
Windows (Git Bash)Download from jqlang.github.io/jq/download and add to PATH

One-Line Installation

curl -fsSL https://raw.githubusercontent.com/supermrpj/claude-status-bash/main/install.sh | bash

The installer will:

  1. Check that jq is available.
  2. Download status_line.sh to ~/.claude/.
  3. Safely merge the required statusLine key into ~/.claude/settings.json without overwriting your existing configuration.

Restart Claude Code after installation to activate the status line.

Manual Installation

If you prefer to install manually:

# 1. Download the script
curl -fsSL https://raw.githubusercontent.com/supermrpj/claude-status-bash/main/status_line.sh \
  -o ~/.claude/status_line.sh
chmod +x ~/.claude/status_line.sh

# 2. Add to ~/.claude/settings.json
jq '. * {"statusLine":{"type":"command","command":"~/.claude/status_line.sh"}}' \
  ~/.claude/settings.json > /tmp/settings.json && mv /tmp/settings.json ~/.claude/settings.json

What Each Field Shows

FieldDescription
CostCumulative API cost in USD for the session
InTotal input tokens consumed
CacheTokens served from the prompt cache (saves cost)
OutTotal output tokens generated
5H% of your 5-hour rate limit used, with reset time
7D% of your 7-day rate limit used, with reset time

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados