Plugin herdr-file-viewer para Herdr

O visualizador de arquivos do smarzban abre em um painel do Herdr, ao lado do agente. Quando o arquivo mudou, você vê a diferença. Quando é documentação, vê o Markdown renderizado. Quando é código-fonte, vê o destaque de sintaxe. A árvore fica à esquerda e o conteúdo à direita, na mesma tela.

O ponto que economiza tempo é não precisar de cat, de troca de modo nem de comando intermediário. Você abre o painel, escolhe o arquivo e lê. Quando o agente escreve “abre src/app.rs:42”, você chega nessa linha pelo plugin e volta para a conversa com a referência copiada.

Requisitos

O plugin exige Herdr 0.7.5 ou mais recente. No Linux e no macOS o funcionamento é estável; no Windows o suporte é declarado como prévia, com identificadores de ação próprios. O WSL funciona sem ajuste extra.

O visualizador é somente leitura. Ele não grava no arquivo aberto: quando você solicita a edição, entrega o arquivo ao editor configurado e volta ao sair dele.

Os renderizadores externos são opcionais. Com glow, delta e bat instalados, Markdown, diferenças e código saem com estilo. Sem eles, o plugin mostra texto simples, sem impedir a leitura.

Instale e abra

1
herdr plugin install smarzban/herdr-file-viewer

A instalação baixa o binário da versão publicada e compila a partir do código quando não encontra binário pronto. As ações de abertura são registradas na instalação; falta apenas o atalho.

Para abrir em um painel dividido, acrescente ao ~/.config/herdr/config.toml:

1
[[keys.command]]
2
key = "prefix+f"
3
type = "plugin_action"
4
command = "herdr-file-viewer.open-file-viewer"
5
description = "abrir visualizador em painel dividido"

Depois rode herdr server reload-config e use o atalho. Existem variantes para abrir em uma aba (open-file-viewer-tab) e para perguntar o diretório antes de abrir (open-file-viewer-at).

Leia o arquivo certo

Dentro do visualizador, s busca no conteúdo do projeto. O atalho com o prefixo do Herdr abre a configuração do próprio Herdr, então a busca de conteúdo usa a tecla sem prefixo.

A árvore marca M, A, D e ? em cada linha conforme o estado no git. O filtro c mostra apenas arquivos alterados, útil quando o agente mexeu em muitos arquivos e você quer revisar só o que interessa.

Anote e devolva ao agente

Com a você anota um arquivo e com A anota um intervalo de linhas. A tecla A seguida de y copia as notas em Markdown, prontas para colar na conversa com o agente.

O projeto inclui uma skill para o agente, em skills/herdr-file-viewer/SKILL.md, que ensina a solicitar a abertura de um caminho com linha. É o caminho mais curto entre a resposta do agente e o trecho de código que ela cita.

Configure e conheça os limites

O arquivo config.toml do plugin é opcional e somente leitura. Nele você troca o editor, o renderizador, o programa que abre arquivos, os toggles de início, o layout da árvore e os atalhos. Copie o config.example.toml para o diretório devolvido por:

1
herdr plugin config-dir herdr-file-viewer

A tecla ? abre a seção Settings com a configuração em vigor.

O plugin não é um cliente de git completo. Ele lê o estado da árvore e as diferenças, sem fazer commit, troca de branch ou envio ao remoto. Para essas operações, use o git no terminal ou o plugin de barra lateral.

Remova

1
herdr plugin uninstall herdr-file-viewer

A remoção apaga o checkout e as ações registradas. Os atalhos que você acrescentou ao config.toml continuam no arquivo e podem ser retirados à mão.

Ficha do plugin

• Autor: Saeed Marzban
• Repositório: https://github.com/smarzban/herdr-file-viewer
• Licença: MIT
• Compatibilidade: Herdr 0.7.5 ou mais recente, no Linux, no macOS ou no Windows em prévia.
• Teste registrado: herdr 0.9.5, Linux x86_64, 25/10/2026, com registro em content/herdr/controle/plugins/herdr-file-viewer/teste.log

O que foi testado

O teste registrado usou Herdr 0.9.5 no Linux x86_64, com configuração e socket isolados em laboratório. A instalação compilou o binário, a Herdr TUI abriu e mostrou a árvore de arquivos com a prévia do arquivo selecionado. Não foram testados o arquivo fixado, a anotação de intervalo e a renderização com glow, delta e bat.