Claude HUD: o plugin que tornou agentes de IA observaveis

“Nao da pra saber se o Claude esta trabalhando ou viajando na maionese.”

Se voce ja rodou uma tarefa complexa no Claude Code, conhece a sensacao. O terminal fica em silencio durante uma operacao longa, e nao tem como saber se o contexto esta prestes a estourar, se o agente esta preso num loop ou se esta acontecendo alguma coisa.

Um plugin open source atacou esse problema de frente. Depois de usar pessoalmente, quis compartilhar por que vale a pena instalar.

O que o Claude HUD mostra

O Claude HUD coloca uma barra de status estilo game na parte de baixo do terminal. Ele rastreia quatro coisas em tempo real:

• Uso de contexto - Uma barra de progresso visual com porcentagem mostrando quanto da janela de contexto da sessao foi consumido
• Ferramentas ativas - Quais ferramentas (Read, Edit, Bash, etc.) estao rodando no momento
• Status dos subagentes - Rastreamento dos agentes filhos criados via chamadas Task (Opus 4.5, Sonnet, etc.)
• Progresso de tarefas - Visualizacao do andamento da lista de tarefas interna do Claude

Como funciona por baixo dos panos

Para os curiosos, aqui vai uma olhada rapida no que acontece por tras da barra de status.

Processamento de entrada stdin

O Claude Code passa o estado da sessao diretamente como payload JSON. O plugin calcula a utilizacao do contexto somando input_tokens, cache_creation_input_tokens e cache_read_input_tokens, e dividindo por context_window_size.

Analise de transcricoes

Os logs de sessao sao processados como um fluxo linha por linha. O plugin detecta blocos tool_use e os combina com entradas tool_result para rastrear o status de cada ferramenta como running, completed ou error.

Exibicao de caminhos de arquivos

A exibicao de caminhos de arquivos e bem resolvida:

• Extrai file_path das chamadas Read, Write e Edit para mostrar em qual arquivo esta sendo trabalhado
• Trunca automaticamente caminhos longos para o formato .../filename.ts
• Atualiza a cada 300ms aproximadamente para feedback quase em tempo real

Por que os desenvolvedores estao empolgados

A resposta da comunidade foi forte, e o motivo e direto: esse plugin acerta em cheio no ponto de dor central de trabalhar com agentes de IA.

• Resolve o problema de opacidade - Tarefas longas nao te deixam mais adivinhando se o agente travou, entrou em loop ou esta chegando no limite de contexto
• Instalacao em tres linhas - Sem configuracao complexa, so instalar e usar
• Eficiencia no debugging - Em workflows multi-etapas, voce ve imediatamente onde deu errado
• Feedback visual - A barra de status estilo game se encaixa naturalmente na cultura do vibe-coding, tornando o desenvolvimento com IA mais interativo

Um comentario popular na comunidade resumiu bem: “Finalmente consigo saber se o Claude esta trabalhando ou sonhando acordado.”

Instalacao

Tres comandos e pronto:

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

GitHub: jarrodwatts/claude-hud

Por que isso importa

Se voce usa Claude Code com frequencia, vale a pena testar. Trabalhar sem a ansiedade do contexto - saber exatamente quando uma sessao pode acabar - traz mais tranquilidade do que voce imagina. Mas o valor real e mais simples: poder ver o que o Claude esta fazendo a qualquer momento muda a forma como voce trabalha com ele.

Observabilidade nao e so para servidores e pipelines. Agentes de IA tambem precisam.