Plugin herdr-reviewr para Herdr

O reviewr abre um painel de revisão de código ao lado da conversa com o agente. As mudanças aparecem com destaque de sintaxe, você seleciona linhas, escreve comentários e envia tudo de uma vez para a entrada do agente.

O plugin não edita arquivos, não envia mensagem sem a sua ação e não publica nada no pull request. O envio é sempre uma ação sua, com os comentários reunidos.

Requisitos

O reviewr exige Herdr 0.9.3 ou mais recente, porque usa as leituras de sessão e os eventos expostos por essa versão. Também precisa de git no repositório e de um terminal com cor de 24 bits.

Para a aba de pull request, é preciso ter gh, glab ou az com a extensão do Azure DevOps, já autenticado. Sem essa ferramenta, o restante do painel funciona normalmente.

O reviewr abre sozinho quando o Herdr cria um workspace para um worktree, o que encaixa o plugin no fluxo de tarefas isoladas. Fora do Herdr, o binário roda em qualquer repositório, com exceção do envio e do escopo do último turno.

Instale

1
herdr plugin install persiyanov/herdr-reviewr

A instalação baixa o binário da versão publicada. Para abrir o painel à mão:

1
herdr plugin action invoke open --plugin persiyanov.reviewr

Para alternar com uma tecla, acrescente ao ~/.config/herdr/config.toml:

1
[[keys.command]]
2
key = "cmd+r"
3
type = "plugin_action"
4
command = "persiyanov.reviewr.toggle"

Revise em cinco passos

1. Escolha o arquivo com j e k, ou salte de mudança em mudança com ].
2. Passe o foco para as mudanças com Tab.
3. Selecione as linhas com v e depois j e k, ou arraste sobre os números de linha.
4. Comente com c, escreva e confirme com Enter.
5. Envie com s, que coloca todos os comentários na entrada do agente.

O rodapé mostra o próximo passo disponível, e ? lista todas as teclas.

Escolha o escopo da comparação

As teclas B e G permitem escolher a branch base e os commits. O escopo do último turno é o que separa o reviewr de uma comparação comum: ele mostra apenas o que a última resposta do agente mudou, o que reduz a revisão ao trecho novo.

Navegue pelas abas

1, 2 e 3 alternam entre Mudanças, Todos os arquivos e Pull request. A aba de todos os arquivos usa busca por nome e por conteúdo. A aba de pull request mostra a descrição e o estado da revisão da branch em modo somente leitura.

| alterna entre a visão unificada e a visão lado a lado. m renderiza um arquivo Markdown dentro do painel, útil para revisar documentação escrita pelo agente.

Configure e conheça os limites

O arquivo de configuração cobre tema, visão de Markdown e de diferenças, lista de arquivos, branch base, editor, programa que abre URLs, prefixo de revisão, atalhos e integração com GitHub, GitLab e Azure DevOps. O README da versão 0.48.0 lista cada chave.

A revisão depende de um repositório git com alterações. Em um diretório sem histórico, o painel não tem o que comparar. A aba de pull request depende de ferramenta externa autenticada, e o envio depende de um agente em execução no Herdr.

Remova

1
herdr plugin uninstall persiyanov.reviewr

A remoção apaga o binário e o painel. A configuração fica no diretório do plugin e é descartada com ele. As teclas acrescentadas ao config.toml permanecem no arquivo.

Ficha do plugin

• Autor: Persiyanov
• Repositório: https://github.com/persiyanov/herdr-reviewr
• Licença: MIT
• Compatibilidade: Herdr 0.9.3 ou mais recente, com git e terminal de cor de 24 bits.
• Teste registrado: herdr 0.9.5, Linux x86_64, 25/10/2026, com registro em content/herdr/controle/plugins/herdr-reviewr/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 baixou o binário e a Herdr TUI abriu em um repositório git de teste, mostrando a diferença do arquivo alterado e a lista de arquivos. Não foram testados o envio de comentários ao agente, o escopo do último turno e a aba de pull request.