Herdrfy
Use a Herdrfy para abrir agentes na mesma aba do Herdr, distribuir tarefas e conferir resultados no TUI ou no Desktop. Veja como instalar e usar.

- Versão
- 0.2.0
- Último commit
- Licença
- MIT
- Mantenedor
- Promovaweb
- Categoria
- Agentes e automação
- Estrelas
- 0
A Herdrfy orienta seu agente de IA a abrir outros agentes no Herdr e acompanhar as tarefas até conferir os resultados. Você define o trabalho de cada agente e os arquivos que ele pode alterar. A skill localiza o terminal atual, abre os painéis na mesma aba e orienta a leitura das respostas antes de reunir o resultado para você.
No Herdr TUI, esse trabalho usa o comando herdr. No Desktop, o hc controla os terminais do herdr-core, com o herdr-app para organizar a janela quando estiver disponível. A skill identifica o ambiente antes de executar os comandos.
Como usar a skill Herdrfy
O que preparar
Você precisa do Node.js 18 ou superior e de uma instalação do Herdr TUI ou Desktop acessível ao agente. Abra a pasta do projeto e defina se a tarefa permite alterações. A Herdrfy inicia agentes com flags que dispensam aprovações de comandos, por isso os limites de edição precisam estar escritos na instrução.
Passo a passo
-
Defina uma revisão com arquivos delimitados.
Envie o exemplo abaixo ao agente, adaptando
src/pagamentos/à pasta do seu projeto. O caminho é ilustrativo. Para usar o TUI, substitua a indicação de Desktop no início.Use herdrfy no Herdr Desktop. Abra um Codex na mesma aba para revisar somente src/pagamentos/. Ele deve procurar erros de arredondamento, sem editar arquivos nem abrir outros agentes. Acompanhe a revisão, confira os trechos citados e apresente os achados com arquivo e linha. Ao terminar, encerre somente o agente aberto para essa revisão.
Resultado esperado: um painel com o Codex e um relato dos achados conferidos. Se o agente precisar de uma resposta sua para continuar, a Herdrfy traz a pergunta antes de prosseguir.
-
Confira a localização e o início da tarefa.
O agente consulta o localizador da Herdrfy antes de abrir o painel. No TUI, ele identifica o workspace, a aba e o painel atual. No Desktop, identifica o terminal e os rótulos da aba. Um terminal do core sem vínculo com uma aba exige um auxiliar sem esses rótulos. Essa condição aparece no relato.
A skill orienta o agente a ler a tela do Codex para confirmar que a instrução chegou. Uma espera encerrada por tempo esgotado não comprova que o envio falhou. O agente confere a tela antes de repetir a mensagem, para evitar que a revisão seja executada duas vezes.
Resultado esperado: a tarefa aparece no terminal aberto para a revisão, com a localização informada pelo agente.
-
Leia os achados e confira o encerramento.
Ao concluir a revisão, o agente principal lê a resposta do Codex e confere os trechos citados. Você recebe os achados com os caminhos dos arquivos e as linhas correspondentes. Uma tarefa interrompida por uma pergunta continua pendente até sua resposta.
A Herdrfy encerra somente o agente aberto para essa revisão e preserva seus outros terminais. O relato informa quais painéis continuam disponíveis para você acompanhar. Para conservar o revisor disponível para outra revisão, inclua essa orientação na instrução inicial.
Resultado esperado: achados conferidos e indicação do agente encerrado ou mantido aberto, sem atribuir conclusão a uma revisão incompleta.
Comandos no TUI e no Desktop
A tarefa escrita pode ser a mesma nos dois ambientes. A Herdrfy escolhe os comandos conforme a localização e consulta o manual do binário instalado para conferir a sintaxe. A tabela mostra os comandos usados pelo agente durante o acompanhamento.
| Ação | Herdr TUI | Herdr Desktop |
|---|---|---|
| Listar agentes ou terminais | herdr agent list |
hc ls |
| Ler a resposta | herdr agent read <agente> |
hc read <terminal> |
| Enviar outra instrução | herdr agent prompt <agente> "texto" |
hc send <terminal> "texto" |
| Aguardar o trabalho | herdr agent wait <agente> |
hc wait <terminal> |
Os valores entre sinais de menor e maior representam nomes ou endereços obtidos na consulta ao Herdr. Não copie esses marcadores como se fossem terminais existentes. No Desktop, o herdr-app complementa o hc para organizar a janela quando o aplicativo estiver disponível na máquina.
Instalar e atualizar
Instalar
Todos os projetos
Instale no seu usuário para usar a skill em diferentes projetos. O instalador permite escolher os agentes que receberão a instalação.
npx skills add promovaweb/herdrfy --skill herdrfy -gProjeto atual
Execute na pasta do projeto para instalar a skill nesse projeto. O instalador permite escolher os agentes que receberão a instalação.
npx skills add promovaweb/herdrfy --skill herdrfyAtualizar
Atualizar esta skill
Instale no seu usuário para usar a skill em diferentes projetos. O instalador permite escolher os agentes que receberão a instalação.
npx skills add promovaweb/herdrfy --skill herdrfy -gVerificar atualizações
Consulte se há atualizações disponíveis para as skills instaladas antes de atualizar.
npx skills checkAgentes compatíveis
Use esta skill no agente de sua preferência. Todos os agentes abaixo são compatíveis.
Claude CodeCompatível
Instalação e comandos documentados pelo autor. Exige Node.js 18+ e acesso ao Herdr. Os agentes iniciados recebem flags que dispensam aprovações de comandos.
CodexCompatível
Instalação e comandos documentados pelo autor. Exige Node.js 18+ e acesso ao Herdr. No herdr-core, o Codex iniciado usa --yolo e --no-daemon.
AntigravityCompatível
Portabilidade inferida das instruções para Codex e dos scripts Node.js 18+. Requer execução de comandos no ambiente do Herdr. Não inclui teste no Antigravity.
Hermes AgentCompatível
Portabilidade inferida das instruções para Codex e dos scripts Node.js 18+. Requer execução de comandos no ambiente do Herdr. Não inclui teste no Hermes Agent.
OpenCodeCompatível
Instalação e comandos documentados pelo autor. Exige Node.js 18+ e acesso ao Herdr. O OpenCode iniciado usa --auto.
CursorCompatível
Portabilidade inferida das instruções para Codex e dos scripts Node.js 18+. Requer execução de comandos no ambiente do Herdr. Não inclui teste no Cursor.
Versões e changelog
Versões publicadas como GitHub Releases do repositório. Consulta em 11 de novembro de 2026.
- Ver no GitHub
0.2.0
AtualEsta versão troca nomes de scripts, opções, chaves do JSON e marcadores.
- Ver no GitHub
0.1.3
### Correções
- Ver no GitHub
0.1.2
### Documentação
- Ver no GitHub
0.1.1
### Correções


