Claude Telemetry
jeongph/claude-telemetry
Barra de status precisa e leve para Claude Code
Ver no GitHubBarra 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-telemetry1 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
- 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)
- Add marketplace:
/plugin marketplace add jeongph/claude-telemetry
- Install:
/plugin install claude-telemetry@jeongph-claude-telemetry
- Run interactive setup:
/claude-telemetry:setup
This downloads the Go binary, configures your preset, and sets up the status line.
Manual setup
- 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
- (Optional) Copy the example config:
cp claude-telemetry/config.example.json ~/.claude/statusline/config.json
- Add to
~/.claude/settings.json:
"statusLine": {
"type": "command",
"command": "bash /path/to/claude-telemetry/scripts/run.sh"
}
- 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
/effortchanges (Claude Code ≥ 2.1.141) - PR badge — open PR number and review state for the current branch, no
ghCLI 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 viasectionsor 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_COLORenvironment variable - Go binary — single binary, no runtime dependencies, sub-10ms rendering
- v1 fallback — existing jq-based users keep working until they upgrade
Sections
| Line | Section | Description |
|---|---|---|
| 1 | Session | [name] session title (max 20 cols, detailed preset or opt-in) |
| 1 | Model | Model name with effort level beside it (Fable 5 · xhigh), color-coded low→max (toggle via effort key) |
| 1 | Elapsed | Session duration (Nh Nm format) |
| 1 | Git | folder:branch ↑push ↓pull +add/-del ?untracked ≡stash ⎇worktrees |
| 1 | PR | Open PR number + review state ✓/●/✗/◌ (shown only when a PR is open) |
| 2 | Context | ◆ Remaining context window % with progress bar |
| 2 | Remaining | ◆ 5h / 7d remaining % with reset countdown (OAuth, auto-detected) |
| 2 | Cost | Session cost in USD (API key, auto-detected) |
| 2 | Lines | Session lines added/removed |
| 2 | API Duration | Time spent waiting for API responses |
| 2 | Tokens | Tokens currently in the context window (in/out) |
| 3 | Agent | Active agent name (shown only when active) |
| 3 | Vim | Vim mode indicator (shown only when active) |
| 3 | Thinking | ✦ 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
| Preset | Lines | Sections |
|---|---|---|
compact | 1 | Model · Effort, Context, Remaining/Cost |
normal | 2 | Model · Effort, Elapsed, Git, PR, Context, Remaining/Cost, Agent, Vim |
detailed | 3 | All 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):
| Remaining | Color |
|---|---|
| > 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:setuponce 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