Herdr Core

O Herdr Core mantém os terminais dos seus agentes em execução quando você fecha a janela do Herdr Desktop. Pelo comando hc, você pode voltar a esses terminais e acompanhar o trabalho. Um agente também pode iniciar auxiliares, enviar uma tarefa para cada um e consultar o que fizeram.

Instale o Herdr Core

O Herdr Core pode ser usado pelo terminal, mesmo sem abrir o Herdr Desktop. Há versões para Linux e macOS nas arquiteturas x86_64 e ARM64, além de Windows x86_64. No Linux ou no macOS, o instalador oficial é:

1
curl -fsSL https://releases.herdr.dev/core/install.sh | sh

No Windows, execute o instalador no PowerShell:

1
powershell -c "irm https://releases.herdr.dev/core/install.ps1 | iex"

Confira a instalação com hc --version. O instalador acompanha a versão disponível no servidor oficial, enquanto os exemplos desta página foram conferidos na documentação da versão 0.1.14. Para consultar uma opção na versão instalada, use a ajuda do comando, como hc run --help.

O Herdr Core executa os programas disponíveis na máquina. O Claude Code ou outro agente que você pretenda iniciar precisa estar instalado e autenticado separadamente. No Windows, templates e comandos de shell entre aspas também precisam de sh no PATH, disponível pelo Git for Windows.

Execute um programa e volte ao terminal

Com o Herdr Core instalado, você pode experimentar esse funcionamento iniciando um shell na máquina local:

1
hc run --bg --name exemplo-core
2
hc attach exemplo-core

O primeiro comando cria um terminal chamado exemplo-core e devolve o controle ao terminal de origem. O segundo conecta você ao shell criado. Pressione Ctrl+\ para sair da visualização e execute hc attach exemplo-core novamente para voltar ao mesmo shell.

Fechar a visualização preserva o processo enquanto a máquina e o serviço permanecem ativos. Reiniciar o computador encerra os processos. A recuperação de um shell não retoma automaticamente o trabalho de um agente.

Você pode consultar os terminais com hc ls. Quando terminar o exercício, saia da visualização e execute hc kill exemplo-core para encerrar apenas o shell criado neste exemplo. O comando hc rm exemplo-core remove seu registro depois do encerramento.

Inicie um agente auxiliar

Entre no diretório do projeto que pretende consultar. Com o Claude Code instalado e autenticado nessa máquina, inicie um terminal exclusivo para a revisão:

1
hc run --bg --name revisao-core claude
2
hc read revisao-core --lines 60

O agente inicia no diretório atual. Leia a saída para conferir se ele está pronto para receber a tarefa. Uma solicitação de autenticação ou de confiança no diretório exige sua interação. Use hc attach revisao-core para responder na interface do agente e Ctrl+\ para sair da visualização.

Quando o agente estiver pronto, envie uma tarefa de leitura:

1
hc send revisao-core "Leia o README.md deste projeto. Confira quais comandos de teste estão documentados e relate o que encontrou. Não altere arquivos nem execute os testes."
2
hc wait revisao-core
3
hc read revisao-core --lines 100

O comando hc send envia o texto ao terminal e aciona a tecla Enter. A espera acompanha o estado informado pelo programa, mas pode terminar por uma solicitação de atenção, um erro ou pelo tempo limite. Leia a saída para verificar o resultado. Se o agente ainda estiver trabalhando, acompanhe o mesmo terminal com outra espera, sem iniciar uma segunda revisão.

Para acrescentar uma orientação à conversa, use hc send revisao-core seguido do novo texto entre aspas. Ao terminar a consulta, execute hc kill revisao-core para encerrar o agente criado neste exercício.

Deixe um agente coordenar os auxiliares

Um agente iniciado dentro de um terminal do Herdr Core pode executar hc para criar outros terminais. Os auxiliares ficam vinculados ao terminal de origem e podem enviar suas respostas de volta. Para experimentar, inicie o agente principal no diretório do projeto:

1
hc run --bg --name principal-core claude
2
hc attach principal-core

Na conversa desse agente, envie a orientação abaixo. Ela usa a documentação instalada para adaptar os comandos à versão disponível:

1
Leia hc --skill. Inicie um agente auxiliar para consultar o README.md deste projeto e listar os comandos de teste documentados. Oriente o auxiliar a não alterar arquivos nem executar testes. Informe o endereço do seu terminal para que ele devolva o relatório por hc send. Acompanhe o auxiliar, leia o resultado e confira as referências no README.md. Ao terminar, encerre somente o auxiliar que você criou.

O comando hc --skill explica como iniciar auxiliares e receber os retornos. Dentro do Herdr Core, a variável HC_TERMINAL_ID identifica o terminal atual. O agente principal pode usar esse endereço para orientar o envio do relatório ao destino correto.

Por padrão, os auxiliares terminam quando o programa do terminal principal termina. A opção --outlive-parent permite manter um auxiliar ativo depois disso, quando essa continuidade for necessária. Sair da visualização com Ctrl+\ apenas desconecta a interface e preserva o agente principal.

O estado de execução depende do que cada programa informa pelo protocolo OSC 7501. Um programa que não informa esse estado pode continuar funcionando, mas você precisará conferir sua saída. Mesmo quando o agente sinalizar que terminou, leia o relatório e confira os arquivos citados.

Herdr Core, Herdr Desktop e Herdr TUI

O Herdr Desktop apresenta uma janela para os terminais mantidos pelo Herdr Core. Você também pode acessar esses terminais pelo comando hc. O Herdr TUI usa o comando herdr e um servidor próprio, com sessões separadas das sessões do Herdr Core.

Para orientar o agente em outras tarefas, consulte a skill do Herdr Core. Ela reúne exemplos para acompanhar processos e localizar os terminais nas abas do Herdr Desktop.

Para localizar a sintaxe e as opções de cada ação, consulte Comandos Herdr Core.