Plugin tsk para Herdr

O tsk mantém uma fila de tarefas que você e o agente leem no mesmo lugar. Você usa o quadro na interface do terminal, o agente usa a linha de comando, e os dois veem o mesmo estado: o que está aberto, o que está em andamento, o que espera revisão e o que terminou.

O uso que dá sentido ao plugin é a passagem de tarefa para implementação. Você descreve a tarefa, atribui a um agente e inicia. O tsk cria um worktree e um workspace no Herdr para aquela tarefa e abre o agente ali, em um diretório separado do seu trabalho.

Requisitos

O plugin exige Herdr 0.9.0 ou mais recente. O despacho de tarefa precisa de um repositório git, porque o isolamento acontece por worktree. No Windows o despacho é declarado como prévia.

Para o agente ler e atualizar o quadro, instale a skill correspondente com tsk setup e escolha o agente. O comando reconhece claude, codex, opencode, cursor, grok, pi e omp.

Instale e conecte ao Herdr

1
herdr plugin install smarzban/tsk

O registro no Herdr é feito pelo próprio projeto:

1
tsk setup herdr
2
herdr server reload-config

Se o comando tsk ainda não existir no sistema, instale pela página oficial antes de ligar ao Herdr. O instalador do projeto acrescenta o binário ao PATH e oferece configurar o Herdr e os agentes que encontrar.

Use o quadro

O atalho prefix+t abre ou foca o quadro do workspace atual, inclusive a partir de outra aba. O prefix+a abre a captura rápida. Fora do Herdr, tsk abre o mesmo quadro no terminal.

Clicar no número T de uma tarefa copia a referência, que você cola na conversa com o agente. Em um painel largo, a tecla → abre os detalhes ao lado do quadro, com passos e notas.

Despache a tarefa

Com o agente definido no config.toml, a tecla @ atribui a tarefa e ctrl+s inicia. O tsk cria o worktree, abre o workspace no Herdr e inicia o agente nele.

Na conclusão, ctrl+d oferece a limpeza do despacho. A limpeza fecha o workspace, remove o worktree e apaga a branch apenas quando ela já foi mesclada. Alterações não commitadas ficam intactas.

Acompanhe o que espera você

O quadro separa o que está em andamento, o que espera revisão e o que está impedido. A revisão exige dois campos: o que foi feito e o que precisa ser conferido. O trabalho do agente volta para você com esse resumo, em vez de uma mensagem solta.

Remova

1
herdr plugin uninstall herdr-tsk

A remoção tira o quadro do Herdr. As tarefas ficam no armazenamento do tsk e continuam acessíveis pelo comando no terminal. Atalhos acrescentados ao config.toml permanecem no arquivo.

Ficha do plugin

• Autor: Saeed Marzban
• Repositório: https://github.com/smarzban/tsk
• Licença: MIT
• Compatibilidade: Herdr 0.9.0 ou mais recente, com git no repositório para o despacho.
• Teste registrado: herdr 0.9.5, Linux x86_64, 25/10/2026, com registro em content/herdr/controle/plugins/tsk/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 com cargo, o quadro abriu no projeto atual e exibiu a fila vazia com os controles de projeto e ordenação. Não foram testados o despacho com worktree, a captura rápida e a integração com as skills de agente.