Proxy de CLI que filtra e compacta a saída de comandos do shell antes que ela chegue ao contexto de um agente de programação com IA, reduzindo o uso de tokens.
jarrodwatts/claude-hud
Plugin do Claude Code que adiciona uma linha de status em tempo real com uso de contexto, limites de uso, ferramentas ativas, agentes em execução e progresso das tarefas.
- Estrelas
- 28,657
- Forks
- 1,417
- Issues abertas
- 0
- Último commit
- ontem
O que é?
Claude HUD é um plugin para Claude Code que exibe um painel abaixo do prompt de entrada. A visualização padrão mostra o modelo ativo, o caminho do projeto, a branch do git, o quanto da janela de contexto está preenchida e os limites de uso da assinatura. Linhas opcionais podem incluir chamadas recentes de ferramentas, subagentes em execução e o progresso das tarefas, extraído da transcrição da sessão.
Ele funciona como o comando de linha de status do Claude Code. O Claude Code envia dados da sessão, como modelo, janela de contexto, custo e limites de uso, pela entrada padrão, e o plugin imprime o conteúdo formatado. Não precisa de uma janela separada nem do tmux e funciona em qualquer terminal no macOS, Linux e Windows.
Quase todos os elementos podem ser configurados por um fluxo guiado em /claude-hud:configure ou por um arquivo config.json. As opções incluem layout, cores, idioma (inglês, chinês simplificado ou tradicional), status do git e do jj, exibição de custos, ritmo de uso e detalhamento de tokens.
Recursos principais
- 01Mostra o uso da janela de contexto em uma barra e em porcentagem, com cores que mudam conforme ela se preenche.
- 02Exibe os limites de uso da assinatura, incluindo a janela de 7 dias, com contagens regressivas até a redefinição.
- 03Lista chamadas recentes de ferramentas, subagentes em execução e progresso das tarefas em linhas opcionais.
- 04Mostra a branch e as alterações pendentes do git, ou o status do jj em repositórios Jujutsu.
- 05Oferece layouts compacto e expandido, com ordem dos elementos e cores configuráveis.
Casos de uso
- Acompanhar o quanto a janela de contexto está preenchida durante sessões longas de programação.
- Ver quais ferramentas e subagentes o Claude Code está executando sem rolar a transcrição.
- Monitorar os limites de uso da assinatura para saber quando serão redefinidos.
- Acompanhar o progresso das tarefas em atividades com várias etapas.
Início rápido
- 1
Adicione o marketplace ao Claude Code
/plugin marketplace add jarrodwatts/claude-hud - 2
Instale o plugin
/plugin install claude-hud - 3
Recarregue os plugins
/reload-plugins - 4
Aponte a linha de status para o HUD
/claude-hud:setup
Antes de usar
- No Windows, é necessário ter o Node.js. Se a configuração informar que não há um runtime JavaScript, instale primeiro o Node.js LTS.
- Alguns elementos opcionais, como as linhas de tools, agents e todos, leem a transcrição da sessão.
- Por padrão, o Claude Code não atualiza plugins de terceiros automaticamente; portanto, talvez seja necessário executar as atualizações manualmente.
Tópicos
Perguntas frequentes
- O que é claude-hud?
- Plugin do Claude Code que adiciona uma linha de status em tempo real com uso de contexto, limites de uso, ferramentas ativas, agentes em execução e progresso das tarefas. Claude HUD é um plugin para Claude Code que exibe um painel abaixo do prompt de entrada. A visualização padrão mostra o modelo ativo, o caminho do projeto, a branch do git, o quanto da janela de contexto está preenchida e os limites de uso da assinatura. Linhas opcionais podem incluir chamadas recentes de ferramentas, subagentes em execução e o progresso das tarefas, extraído da transcrição da sessão.
- claude-hud é gratuito? Qual é a licença?
- claude-hud é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- claude-hud ainda é mantido?
- Manutenção ativa. O último commit de claude-hud foi em 19 de out. de 2026.
- Para que posso usar claude-hud?
- Acompanhar o quanto a janela de contexto está preenchida durante sessões longas de programação. Ver quais ferramentas e subagentes o Claude Code está executando sem rolar a transcrição. Monitorar os limites de uso da assinatura para saber quando serão redefinidos. Acompanhar o progresso das tarefas em atividades com várias etapas.
- Como instalar claude-hud?
- Adicione o marketplace ao Claude Code: /plugin marketplace add jarrodwatts/claude-hud Instale o plugin: /plugin install claude-hud Recarregue os plugins: /reload-plugins Aponte a linha de status para o HUD: /claude-hud:setup
- Onde consigo claude-hud?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/jarrodwatts/claude-hud
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
CLI e catálogo de templates prontos para configurar o Claude Code com agents, comandos, configurações, hooks e integrações MCP.
Barra de status personalizável para o Claude Code CLI, com modelo, branch do Git, uso de tokens, limites de uso e mais, além de suporte a Powerline e temas.
Statusline minimalista feito em Rust para Claude Code, que mostra o modelo, o estado do Git, o workspace e o uso da janela de contexto no terminal.
Plugin do Claude Code que exibe respostas curtas por padrão e permite expandir trechos no próprio texto com um clique.
Um mod para Claude Code que mostra miniaturas das imagens coladas acima do prompt, em vez de apenas tags como [Image #n].