convez.ai
AgenteProdutividadeIntermediário
shouyuandong

Claude HUD

shouyuandong/claude-hud

Monitor em tempo real de tokens e contexto do Claude Code na sidebar

Ver no GitHub
InicialPluginScore · de 0 a 100

Extensão de VS Code que exibe em tempo real o uso de tokens, janela de contexto, status de agentes e histórico do Claude Code diretamente na sidebar. Fornece visualização completa de métricas sem necessidade de terminal, com gráficos interativos e configuração modular.

Instalação

$npx convez-ai shouyuandong/claude-hud

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á 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar consumo de tokens durante sessões de coding com Claude
  • Acompanhar status de agentes multi-tarefa e progresso em tempo real
  • Visualizar histórico de uso de tokens em períodos de 24h ou 7 dias
  • Otimizar uso da janela de contexto durante desenvolvimento

Veredito

Ferramenta essencial para desenvolvedores usando Claude Code, oferecendo visibilidade clara sobre recursos consumidos sem sair do editor. Implementação limpa em TypeScript com UI responsiva e tema automático.

README

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

Claude HUD

English · 中文

A Heads-Up Display for Claude Code in VS Code sidebar.

Real-time visibility into token usage, context window, agent status, and history — all from the Activity Bar, no terminal needed.

Claude HUD


Features

  • Token Flow — Matrix rain / candlestick / tracer-ball visualization of real-time token rate
  • Context Window — At-a-glance progress bar showing current vs limit
  • Token Usage — IN/OUT token breakdown with proportional bar
  • Agent Status — Multi-agent tree with tasks, progress, and token counts
  • History Chart — Token usage over 24h or 7d
  • Plan Mode Badge — Shows when Claude is in Plan Mode
  • Drag & Reorder — Move modules to your preferred order
  • Auto Theme — Matches VS Code color theme (light / dark)

Overview

Requirements

Usage

  1. Click the Claude HUD icon in the Activity Bar (left sidebar)
  2. The panel shows real-time metrics while Claude Code is active
  3. Click the eye icon (◈) to toggle module visibility
  4. Drag module headers to reorder

Configuration

Toggle individual modules via claudeHud.modules in settings.json:

{
  "claudeHud.modules": {
    "tokenFlow": true,
    "contextWindow": true,
    "tokenUsage": true,
    "agentStatus": true,
    "historyChart": true,
    "sessionTime": true
  }
}

Development

# Install dependencies
npm install

# Compile TypeScript
npx tsc -p ./

# Launch VS Code extension host (F5)

Project Structure

claude-hud/
├── src/
│   ├── extension.ts         # Entry point
│   ├── hudPanel.ts          # WebviewViewProvider
│   ├── dataProvider.ts      # Data source (JSONL parsing)
│   ├── statusBar.ts         # Status bar item
│   ├── historyStore.ts      # Token history persistence
│   ├── configManager.ts     # Module config management
│   ├── types.ts             # Shared types
│   └── webview/
│       ├── script.js         # Frontend rendering
│       └── styles.css        # Styling
├── media/icon.svg            # Extension icon
└── package.json

Acknowledgements

This project references and adapts processing logic from jarrodwatts/claude-hud. Thanks to the original author for the inspiration.

License

MIT

Ver o original no GitHub

Bom para

Relacionados