Repolode
Enviar
GaoSSR

GaoSSR/best-claude-hud

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.

Ver no GitHub
Estrelas
1,074
Forks
34
Issues abertas
0
Último commit
há 2 meses

O que é?

best-claude-hud é um HUD de statusline para o Claude Code, assistente de programação no terminal. Ele fica na parte inferior da interface do Claude Code e mostra o modelo ativo e seu nível de esforço de raciocínio, o diretório de inicialização, a branch do Git com o estado limpo, modificado ou com conflitos e as contagens de commits à frente e atrás, além de quanto da janela de contexto está em uso.

A ferramenta é escrita em Rust e instalada via npm como binários nativos pré-compilados, então não é necessário ter Rust na máquina do usuário. Um único comando, `best-claude-hud --setup`, adiciona a entrada `statusLine` necessária a ~/.claude/settings.json, preservando as configurações existentes. As plataformas compatíveis incluem macOS (arm64 e x64), Linux x64 (musl) e Windows x64.

O HUD pode ser configurado por meio de uma TUI, de um arquivo config.toml e de temas integrados ou personalizados, incluindo estilos Nerd Font e Powerline. Segmentos opcionais mostram uso e limites de taxa, custo, sessão e estilo de saída. Os nomes de exibição dos modelos e os limites de contexto podem ser personalizados para modelos de terceiros.

Recursos principais

  • 01Mostra o modelo atual e o nível de esforço de raciocínio em tempo real
  • 02Exibe a branch do Git, o estado limpo, modificado ou com conflitos e as contagens de commits à frente e atrás
  • 03Informa o uso da janela de contexto com base nos dados de statusLine do Claude Code
  • 04Instala via npm com binários pré-compilados, sem necessidade de toolchain do Rust
  • 05Oferece temas integrados e uma TUI para configuração

Casos de uso

  • Acompanhar o uso da janela de contexto durante sessões longas no Claude Code
  • Conferir a branch do Git e o estado da árvore de trabalho sem sair do terminal
  • Personalizar a exibição da statusline para vários modelos, inclusive modelos de terceiros

Início rápido

  1. 1

    Instale e configure o Claude Code em uma única linha

    npm install -g best-claude-hud@latest && best-claude-hud --setup
  2. 2

    Reinicie o Claude Code para que ele carregue as novas configurações

Antes de usar

  • É necessário ter o Claude Code com suporte a statusLine e o Git para exibir a branch.
  • Para usar Nerd Font ou temas Powerline, é preciso instalar o Nerd Font no terminal.
  • Linux arm64 e Windows arm64 ainda não são compatíveis.

Tópicos

#claude-code#statusline#terminal#cli#git#rust#developer-tools#hud#linux#macos

Perguntas frequentes

O que é best-claude-hud?
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. best-claude-hud é um HUD de statusline para o Claude Code, assistente de programação no terminal. Ele fica na parte inferior da interface do Claude Code e mostra o modelo ativo e seu nível de esforço de raciocínio, o diretório de inicialização, a branch do Git com o estado limpo, modificado ou com conflitos e as contagens de commits à frente e atrás, além de quanto da janela de contexto está em uso.
best-claude-hud é gratuito? Qual é a licença?
best-claude-hud é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
best-claude-hud ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de best-claude-hud foi em 13 de ago. de 2026.
Para que posso usar best-claude-hud?
Acompanhar o uso da janela de contexto durante sessões longas no Claude Code Conferir a branch do Git e o estado da árvore de trabalho sem sair do terminal Personalizar a exibição da statusline para vários modelos, inclusive modelos de terceiros
Como instalar best-claude-hud?
Instale e configure o Claude Code em uma única linha: npm install -g best-claude-hud@latest && best-claude-hud --setup Reinicie o Claude Code para que ele carregue as novas configurações
Onde consigo best-claude-hud?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/GaoSSR/best-claude-hud

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados