/ Diretório / Playground / Claude HUD
● Comunidade jarrodwatts ⚡ Instantâneo

Claude HUD

por jarrodwatts · jarrodwatts/claude-hud

Um HUD em tempo real para o Claude Code — orçamento de contexto, ferramentas ativas, subagentes em execução, progresso de tarefas. Pare de voar às cegas.

claude-hud é um plugin do Claude Code que mostra o que está realmente acontecendo durante uma sessão: quão cheio está o context window, quais ferramentas estão disparando, quais subagentes estão ativos, progresso da lista de tarefas. Voltado para devs que executam sessões longas ou workflows multi-agente onde 'por que está ficando lento?' vira uma pergunta real.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalação

Repositório do autor · Documentação oficial de Skills do Claude

Casos de uso

Usos do mundo real: Claude HUD

Diagnosticar por que uma sessão longa está de repente lenta

👤 Devs executando sessões multi-hora no Claude Code ⏱ ~10 min beginner

Quando usar: As respostas parecem mais lentas que no início; você suspeita de pressão de contexto.

Pré-requisitos
  • Plugin instalado — Coloque em ~/.claude/plugins ou conforme a convenção de plugin do Claude Code
Fluxo
  1. Abrir HUD
    Abra o HUD. Qual é meu uso de contexto agora?✓ Copiado
    → Percentual ao vivo com detalhamento
  2. Identificar consumidores
    Quais chamadas de ferramenta produziram os maiores resultados nos últimos 30 minutos?✓ Copiado
    → Lista Top-N de outputs volumosos de ferramentas
  3. Compactar
    Compacte a conversa para resumo. Verifique se o HUD mostra que o contexto caiu.✓ Copiado
    → Barra de contexto cai; velocidade retorna

Resultado: Sessões que você pode executar o dia todo sem lentidões inexplicáveis.

Armadilhas
  • Compactação agressiva perde detalhes importantes — Compacte seletivamente — mantenha a última troca significativa

Rastrear múltiplos subagentes trabalhando em paralelo

👤 Devs inicializando subagentes ⏱ ~15 min intermediate

Quando usar: Você lançou 3 subagentes e perdeu o controle de quem está fazendo o quê.

Fluxo
  1. Listar
    Mostre-me todos os subagentes ativos e suas tarefas atuais.✓ Copiado
    → Tile por subagente
  2. Detalhar
    Mostre as chamadas de ferramenta recentes e o progresso de tarefas do subagente 'tester'.✓ Copiado
    → Linha do tempo por subagente

Resultado: Visibilidade em uma configuração multi-agente que de outra forma seria uma caixa preta.

Armadilhas
  • Muitos subagentes — o próprio HUD fica confuso — Filtre / recolha os não ativos
Combine com: mcp-agent-mail

Combinações

Combine com outros MCPs para 10× de alavancagem

claude-hud-skill + mcp-agent-mail

Coordenar + monitorar configurações multi-agente

Use mail para coordenação, HUD para status ao vivo.✓ Copiado
claude-hud-skill + claude-best-practice-skill

Planos disciplinados + rastreamento ao vivo

Planeje com best-practice, acompanhe o progresso no HUD.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
show_context (nenhum) Sempre que suspeitar de bloat free
tool_timeline since? Encontrar latência / outputs volumosos free
list_subagents (nenhum) Rastrear execuções multi-agente free
todo_status (nenhum) Checkpoints de sessão free

Custo e limites

O que custa rodar

Cota de API
N/A
Tokens por chamada
Mínimo — o HUD é telemetria somente leitura
Monetário
Gratuito
Dica
O próprio HUD é barato; use-o para encontrar coisas caras para cortar

Segurança

Permissões, segredos, alcance

Escopos mínimos: Acesso de leitura ao estado da sessão do Claude Code
Armazenamento de credenciais: Nenhum
Saída de dados: Nenhuma

Solução de problemas

Erros comuns e correções

HUD não mostra nada

Plugin não carregado; verifique o caminho de instalação e reinicie o Claude Code

Números de contexto não correspondem às configurações

O HUD lê o estado preciso da sessão; a discrepância geralmente é sobre tokens reservados do sistema

Alternativas

Claude HUD vs. outros

AlternativaQuando usarTroca
cc-lensVocê quer uma janela de dashboard separadaUX diferente; não inline
/context embutido do Claude CodeUma verificação rápida é suficienteSem linha do tempo, sem visualização de subagente

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills