convez.ai
SkillProdutividadeIntermediário
jeongph

Claude Telemetry

jeongph/claude-telemetry

Barra de status precisa e leve para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Barra de status personalizável e confiável para Claude Code que exibe limites de taxa, uso de API, informações do Git e nível de esforço em tempo real. Implementada em Go, oferece renderização leve e rápida sem dependências externas.

Instalação

$npx convez-ai jeongph/claude-telemetry

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
1
Saúde
42%
Último commit
há 1 mês
Versão
v2.6.2
Issues abertas
0
Contribuidores
2

Casos de uso

  • Monitorar limites de taxa e custos de API em sessões Claude
  • Rastrear informações Git (branch, mudanças, PRs) durante desenvolvimento
  • Visualizar nível de esforço de raciocínio (low/medium/high) em tempo real
  • Adaptar exibição de status a diferentes tamanhos de terminal

Veredito

Skill essencial para usuários de Claude Code que precisam monitorar recursos e contexto em tempo real. Implementação robusta em Go com suporte a múltiplas configurações, i18n e integração Git nativa, sem overhead de performance.

README

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

claude-telemetry

Customizable multi-line status line for Claude Code.

"The status line you can trust" — accurate, lightweight, never breaks.

Installation

Via marketplace (recommended)

  1. Add marketplace:
/plugin marketplace add jeongph/claude-telemetry
  1. Install:
/plugin install claude-telemetry@jeongph-claude-telemetry
  1. Run interactive setup:
/claude-telemetry:setup

This downloads the Go binary, configures your preset, and sets up the status line.

Manual setup

  1. Download the binary for your platform from Releases:
mkdir -p ~/.claude/statusline/bin
curl -fsSL "https://github.com/jeongph/claude-telemetry/releases/latest/download/claude-telemetry-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/')" \
  -o ~/.claude/statusline/bin/claude-telemetry
chmod +x ~/.claude/statusline/bin/claude-telemetry
  1. (Optional) Copy the example config:
cp claude-telemetry/config.example.json ~/.claude/statusline/config.json
  1. Add to ~/.claude/settings.json:
"statusLine": {
  "type": "command",
  "command": "bash /path/to/claude-telemetry/scripts/run.sh"
}
  1. Restart Claude Code

Features

  • Remaining % display — all bars show remaining capacity (like a battery), not usage
  • Preset modes — compact (1 line), normal (2 lines), detailed (3 lines)
  • Auto user detection — OAuth users see rate limits, API key users see cost
  • Git integration — folder:branch, ↑push/↓pull, changes (+/-), untracked (?N), stash (≡N), worktrees (⎇N)
  • Effort level — live reasoning effort (low/medium/high/xhigh/max) shown beside the model name, reflects /effort changes (Claude Code ≥ 2.1.141)
  • PR badge — open PR number and review state for the current branch, no gh CLI needed (Claude Code ≥ 2.1.145)
  • Session name — session title shown as [name], auto-truncated to 20 columns (off by default — Claude Code already shows the title in its UI; enable via sections or the detailed preset)
  • Rate limit countdown — remaining time until reset with progress bar
  • Dynamic color thresholds — green/yellow/red based on remaining %, customizable via config
  • Graceful degradation — loading (···), partial failure (—), error messages instead of silent blank
  • Progress bars — ▰▱ visualization, color-coded green → yellow → red
  • Adaptive width — auto-drops lower priority sections on narrow terminals
  • i18n — English, Korean, Japanese, Chinese (auto-detected)
  • Auto binary sync — a SessionStart hook keeps the binary matched to the plugin version (pinned download + sha256 verification)
  • Self-cleanup on uninstall — if you uninstall the plugin, the status line removes its own settings entry and files within a minute (setup-managed installs only)
  • NO_COLOR support — respects NO_COLOR environment variable
  • Go binary — single binary, no runtime dependencies, sub-10ms rendering
  • v1 fallback — existing jq-based users keep working until they upgrade

Sections

LineSectionDescription
1Session[name] session title (max 20 cols, detailed preset or opt-in)
1ModelModel name with effort level beside it (Fable 5 · xhigh), color-coded low→max (toggle via effort key)
1ElapsedSession duration (Nh Nm format)
1Gitfolder:branch ↑push ↓pull +add/-del ?untracked ≡stash ⎇worktrees
1PROpen PR number + review state ✓/●/✗/◌ (shown only when a PR is open)
2Context◆ Remaining context window % with progress bar
2Remaining◆ 5h / 7d remaining % with reset countdown (OAuth, auto-detected)
2CostSession cost in USD (API key, auto-detected)
2LinesSession lines added/removed
2API DurationTime spent waiting for API responses
2TokensTokens currently in the context window (in/out)
3AgentActive agent name (shown only when active)
3VimVim mode indicator (shown only when active)
3Thinking✦ extended thinking indicator (shown only when enabled)

Line 3 appears only when agent, vim mode, or thinking indicator is active.

Note: Since Claude Code 2.1.132, token counts reflect what is currently in the context window, not cumulative session totals.

Setup

Run /claude-telemetry:setup in Claude Code for interactive configuration — it detects your language, downloads the binary, and walks you through preset selection.

Or edit ~/.claude/statusline/config.json directly:

{
  "preset": "normal",
  "language": "en",
  "colors": true,
  "bar_width": 5,
  "separator": " │ ",
  "user_type": "auto",
  "sections": {},
  "thresholds": {
    "context_warn": 50,
    "context_danger": 20,
    "cost_warn": 1.0,
    "cost_danger": 5.0
  }
}

Presets

PresetLinesSections
compact1Model · Effort, Context, Remaining/Cost
normal2Model · Effort, Elapsed, Git, PR, Context, Remaining/Cost, Agent, Vim
detailed3All sections enabled

Section overrides

Use sections to override preset defaults:

{
  "preset": "normal",
  "sections": {
    "tokens": true,
    "lines": true
  }
}

Thresholds

Color changes at these remaining percentages (customizable):

RemainingColor
> 50%Green
21–50%Yellow
≤ 20%Red

Project-level config

Create .claude-statusline.json in your project root to override global settings per project:

{
  "preset": "detailed"
}

Removal

/claude-telemetry:remove

If you uninstall the plugin without running remove first, the status line detects the missing plugin and cleans itself up automatically within about a minute (settings entry removed from the next session). This applies to installs managed by /claude-telemetry:setup; manual installs are never touched.

Upgrading

  • Plugin users (v2.4.0+): update the plugin (/plugin → Update), then restart Claude Code. The SessionStart hook syncs the binary to the plugin version automatically.
  • Plugin users (older): run /claude-telemetry:setup once after updating the plugin — it downloads the matching binary and migrates your settings to the version-independent launcher path.
  • Manual installs: re-run the curl command from Manual setup; the binary is all that matters.

Upgrading from v1

v2 is backward-compatible. Existing v1 config files work as-is. Run /claude-telemetry:setup to download the Go binary — your existing settings are preserved.

If you don't run setup, the v1 jq-based rendering continues to work via the built-in fallback.

Requirements

  • Claude Code
  • git (optional, for branch/changes display)
  • Claude Code ≥ 2.1.141 for Effort, ≥ 2.1.145 for PR badge (older versions simply hide these sections)

License

MIT

Ver o original no GitHub

Bom para

Relacionados