Claude HUD (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Medidor de uso do context window
Linha do tempo de chamadas de ferramenta (quais ferramentas MCP, quando, latência)
Lista de subagentes ativos
Rastreador de progresso de tarefas/todos
Leve — plugin puro, sem serviços extras

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-hud-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-hud-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jarrodwatts/claude-hud",
          "~/.claude/plugins/claude-hud"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add claude-hud-skill -- git clone https://github.com/jarrodwatts/claude-hud ~/.claude/plugins/claude-hud

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

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

Abrir HUD

Abra o HUD. Qual é meu uso de contexto agora?✓ Copiado

→ Percentual ao vivo com detalhamento
Identificar consumidores

Quais chamadas de ferramenta produziram os maiores resultados nos últimos 30 minutos?✓ Copiado

→ Lista Top-N de outputs volumosos de ferramentas
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

Listar

Mostre-me todos os subagentes ativos e suas tarefas atuais.✓ Copiado

→ Tile por subagente
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

Ferramenta	Entradas	Quando chamar	Custo
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

Alternativa	Quando usar	Troca
cc-lens	Você quer uma janela de dashboard separada	UX diferente; não inline
/context embutido do Claude Code	Uma verificação rápida é suficiente	Sem 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