Plugin herdr-annotate para Herdr

O Annotate transforma a seleção de texto do terminal em comentário endereçado ao agente. Você seleciona um trecho, escreve a observação e devolve o conjunto como uma mensagem única, na ordem de escrita, com o texto original citado e o comentário logo abaixo.

O plugin tem duas instalações com o mesmo identificador. A completa acrescenta a revisão de documentos e de respostas do agente, com a interface do Plannotator. A leve fica só no comentário de seleção, em uma janela pequena.

Requisitos

O plugin exige Herdr 0.8.0 ou mais recente. Não há runtime para instalar: as duas versões baixam um binário pequeno e verificam o checksum SHA-256.

No Linux, a área de transferência depende de wl-clipboard, xclip ou xsel. No Windows, o suporte nativo do Herdr a plugins é declarado como prévia, e a instalação completa exige Herdr 0.9.0.

Instale e vincule as teclas

Para a versão completa:

1
herdr plugin install plannotator/herdr-annotate

Para a versão leve:

1
herdr plugin install plannotator/herdr-annotate/lite

As teclas precisam ser declaradas no ~/.config/herdr/config.toml. O README traz o bloco pronto; o comando abaixo recarrega a configuração depois de colar:

1
herdr server reload-config

Comente a seleção

As anotações saem em ordem de escrita, uma seção ## Annotation N por nota, com o workspace e a aba de origem, o trecho selecionado e o comentário como citação. O agente lê o conjunto na mesma sequência da sua revisão.

Antes de colar ou enviar, o plugin consulta o Herdr para saber se o agente está pronto. Painel sem agente reconhecido, agente ainda iniciando ou agente esperando aprovação fazem o envio ser recusado, sem digitar nada e sem arquivar as anotações.

No gerenciador, e edita a anotação selecionada, y copia uma, c copia todas e Shift+C copia e arquiva. A aba de arquivo permite copiar, restaurar e apagar. Se outro painel gravar a mesma anotação antes de você, a gravação do seu texto antigo é recusada e o rascunho continua aberto.

Revise documentos e respostas

Na instalação completa, Ctrl+B O abre a pasta atual com a árvore de arquivos, Ctrl+B Shift+O abre as respostas recentes do agente e Ctrl+B Ctrl+O abre a resposta mais nova sem seletor. A revisão funciona com Claude Code, Codex, Copilot CLI, OpenCode e outros agentes que o projeto lista.

A ação annotate.terminal abre as últimas 200 linhas do painel em foco para revisão. Ela não tem tecla padrão e precisa ser vinculada no config.toml.

Copie em sessão remota

Cópias feitas dentro do painel do gerenciador emitem OSC 52, então alcançam a área de transferência da máquina que você está usando mesmo quando o plugin roda em um servidor remoto sem ferramenta de clipboard. Os atalhos que rodam fora de um painel, como Ctrl+B Shift+A, não conseguem escrever no terminal e ficam limitados ao ambiente local.

Remova

1
herdr plugin uninstall annotate

A remoção apaga o binário e o vínculo. As anotações arquivadas ficam no diretório de estado do plugin e podem ser copiadas antes de remover. As teclas declaradas no config.toml continuam no arquivo.

Ficha do plugin

• Autor: Plannotator
• Repositório: https://github.com/plannotator/herdr-annotate
• Licença: MIT
• Compatibilidade: Herdr 0.8.0 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-annotate/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 o comando respondeu com a lista de subcomandos. Não foram testados a captura de seleção dentro de um painel do Herdr, o envio ao agente e a revisão de documentos.