Plugin herdr-sidebar para Herdr

A barra lateral do Herdr reúne três coisas que costumam exigir sair do terminal: a árvore de arquivos, a busca no projeto e o painel de controle de versão. Tudo acontece em um painel dockável, ao lado do agente, com o mesmo desenho de atividade de um editor de código.

O plugin serve a um fluxo de trabalho no qual você alterna entre a conversa com o agente e a conferência do que mudou no repositório. Em vez de abrir outra janela para ver a diferença ou o que está preparado para commit, você usa a barra lateral no mesmo workspace.

Requisitos

O plugin exige Herdr 0.8 ou mais recente. A instalação por release usa binários verificados por SHA-256 e recorre à compilação quando não encontra o binário da plataforma.

Compilar a partir do código exige Rust 1.89 ou mais recente. Uma Nerd Font deixa os ícones de material visíveis; o tema de emoji funciona em qualquer fonte.

Três ferramentas são opcionais e só ajustam detalhes: glow para renderizar Markdown, ffmpeg para gerar pôster de vídeo na prévia e claude para redigir mensagem de commit. Sem elas, o painel continua utilizável.

Instale e abra

1
herdr plugin install alexarthurs/herdr-sidebar/plugins/herdr-sidebar

O manifesto fica em uma subpasta do repositório, por isso o caminho inclui plugins/herdr-sidebar. Para abrir ou fechar a barra:

1
herdr plugin action invoke herdr-sidebar.open-sidebar

Existe a variante open-sidebar-windows para o Windows. As ações open-git, show-explorer, show-search, show-git e quick-open abrem uma atividade específica sem alternar a barra inteira, o que permite vinculá-las a teclas no config.toml:

1
[[keys.command]]
2
key = "cmd+p"
3
type = "shell"
4
command = "herdr plugin action invoke quick-open --plugin herdr-sidebar"

Alterne entre as três visões

A barra de atividades troca entre Explorador, Busca e Controle de versão. Use o mouse ou as teclas 1, 2 e 3.

No explorador, a árvore abre pastas com ← e → ou h e l, e Enter alterna ou mostra a prévia. Um clique abre a prévia em uma aba temporária; o clique duplo fixa a aba. A prévia mostra texto, Markdown, imagem e, com ffmpeg, um quadro do vídeo.

Ctrl+P busca arquivos por nome, e Ctrl+F ou Ctrl+Shift+F busca no conteúdo, com opções de caixa, palavra inteira, expressão regular e filtros de inclusão e exclusão. A letra e abre o editor embutido em uma prévia de texto, com seleção, busca, cópia e gravação explícita.

No controle de versão, Enter prepara ou retira um arquivo, a e u preparam ou limpam todos, c escreve a mensagem de commit e S sincroniza com o remoto. A letra A solicita uma sugestão de mensagem ao claude, com alternativa baseada no nome dos arquivos quando o programa não está disponível. Clicar no nome da branch abre a troca de branch, a criação de uma nova e o acompanhamento de um remoto.

Configure a barra

As configurações ficam no próprio painel, na tecla s, e valem para todas as abas e reinicializações. Entre elas: painel único ou separado para explorador e controle de versão, encaixe à esquerda ou à direita, largura, ícones, cores, modo de prévia, arquivos ocultos, decorações do git e rodapé de branch.

A barra acompanha o diretório de trabalho do painel vizinho por padrão. Quando você escolhe uma pasta à mão, ela fica fixa até aquele painel mudar de diretório outra vez.

Conheça os limites

O modo de prévia com tomada de painel é experimental. Depois de reiniciar o Herdr ou de uma restauração incompleta, pode ser necessário devolver os painéis de trabalho ao lugar à mão. O modo tab é o padrão e evita essa situação.

A barra atualiza o estado com o painel em foco. Para manter um painel de controle de versão como monitor passivo, inicie o plugin com HERDR_SIDEBAR_BACKGROUND_REFRESH=1 no ambiente.

Remova

1
herdr plugin uninstall herdr-sidebar

A remoção apaga o checkout e o painel. As configurações ficam no diretório do plugin e são descartadas com ele. Atalhos que você acrescentou ao config.toml permanecem no arquivo.

Ficha do plugin

• Autor: Alex Arthurs
• Repositório: https://github.com/alexarthurs/herdr-sidebar
• Licença: MIT
• Compatibilidade: Herdr 0.8 ou mais recente, no Linux, no macOS ou no Windows.
• Teste registrado: herdr 0.9.5, Linux x86_64, 25/10/2026, com registro em content/herdr/controle/plugins/herdr-sidebar/teste.log

O que foi testado

O teste registrado usou Herdr 0.9.5 no Linux x86_64, com configuração e socket isolados. A instalação compilou o binário Rust, a Herdr TUI abriu no checkout e mostrou a árvore de arquivos e os controles de git. Não foram testados commit, troca de branch e a redação de mensagem com o claude.