Plugin herdr-auto-title para Herdr

O Auto Title lê a sessão do Herdr duas vezes por segundo e nomeia abas e painéis com o trabalho que está acontecendo neles. O nome combina o número da aba, a pasta ou o programa e, quando existe, o título do agente.

O resultado aparece na prática: uma aba na pasta dashboard vira 1 · dashboard; a mesma pasta em uma branch de trabalho vira 2 · dashboard › MC-13200; um agente trabalhando em escopos de OAuth vira 4 · dashboard › Implement OAuth scopes. A branch principal é omitida, e branches longas são reduzidas ao trecho que identifica o trabalho.

Requisitos

O plugin exige Herdr 0.8.2 ou mais recente. A instalação compila a partir do código, então a máquina precisa de Go 1.24 ou mais recente. Com o Go 1.22 comum em distribuições, a compilação falha antes de instalar.

No Windows, o Herdr informa apenas o shell ou o agente em execução no painel. Editor, ssh e mosh não nomeiam a aba nesse sistema.

Instale e inicie

1
herdr plugin install kryptamine/herdr-auto-title --ref v0.15.0
2
herdr plugin action invoke herdr.auto-title.restart

A segunda linha inicia o plugin na hora. Sem ela, o Herdr só carrega o plugin na próxima vez que o servidor iniciar.

Para atualizar, repita as duas linhas com a tag da versão nova. A configuração é preservada.

Ajuste o ambiente recomendado

Três ajustes opcionais fazem o plugin render o que promete.

O primeiro impede que o Herdr peça um nome ao criar a aba. Um nome digitado ali vale como escolha sua, e o plugin deixa a aba intacta:

1
[ui]
2
prompt_new_tab_name = false

O segundo instala a integração do Herdr com cada agente usado. Ela informa qual sessão está no painel, e é o que permite nomear a aba pelo trabalho do agente:

1
herdr integration install claude
2
herdr integration install codex
3
herdr integration install opencode

O terceiro mostra o tópico na barra lateral. O plugin publica o assunto da aba ativa como $topic, e o Herdr desenha esse valor apenas onde uma linha da barra lateral solicita:

1
[ui.sidebar.spaces]
2
rows = [
3
  ["state_icon", "workspace", "branch", "git_status"],
4
  [{ token = "$topic", bold = true, dim = false }],
5
]

Cada cliente lê o próprio config.toml, então a linha precisa existir em todas as máquinas que você usa para acessar.

Entenda o que muda na primeira execução

A primeira inicialização renomeia todos os painéis, inclusive os que você já tinha nomeado à mão. Depois disso, um painel renomeado por você fica fora do alcance do plugin. Para devolver o painel ao controle automático, apague o nome.

Uma aba com vários painéis recebe o nome do painel em foco, do painel com agente ocupado ou do último painel que mudou. Cada painel ganha nome próprio, e a lista do seletor de painéis do Herdr deixa de repetir o nome do programa em todos os itens.

Configure o comportamento

Todas as opções são opcionais e ficam em ~/.config/herdr-auto-title/config.env. Copie o config.env.example do repositório e descomente o que precisar. O README da versão 0.15.0 lista as chaves e os valores aceitos.

Remova

1
herdr plugin uninstall herdr.auto-title

A remoção encerra o processo e apaga o checkout. Os nomes já gravados nas abas e nos painéis permanecem até você renomear ou limpar. Os ajustes de config.toml que você acrescentou continuam no arquivo.

Ficha do plugin

• Autor: kryptamine
• Repositório: https://github.com/kryptamine/herdr-auto-title
• Licença: MIT
• Compatibilidade: Herdr 0.8.2 ou mais recente, com Go 1.24 ou mais recente para compilar.
• Teste registrado: herdr 0.9.5, Linux x86_64, 25/10/2026, com registro em content/herdr/controle/plugins/herdr-auto-title/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 exigiu Go 1.24, compilou e iniciou o processo. O processo leu o servidor em execução e renomeou abas no formato número, pasta e título, o que foi observado e registrado. Não foram testados os ajustes de integração por agente nem a linha de tópico na barra lateral.