Repolode
jarrodwatts

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. 1

    Adicione o marketplace ao Claude Code

    /plugin marketplace add jarrodwatts/claude-hud
  2. 2

    Instale o plugin

    /plugin install claude-hud
  3. 3

    Recarregue os plugins

    /reload-plugins
  4. 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