Ir para o conteúdo
Promovaweb

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.

Capa da skill Herdrfy
Versão
0.2.0
Último commit
Licença
MIT
Mantenedor
Promovaweb
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

  1. 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.

  2. 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.

  3. 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 -g

Projeto 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 herdrfy

Atualizar

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 -g

Verificar atualizações

Consulte se há atualizações disponíveis para as skills instaladas antes de atualizar.

npx skills check

Agentes 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.

  1. 0.2.0

    Atual
    Ver no GitHub

    Esta versão troca nomes de scripts, opções, chaves do JSON e marcadores.

  2. 0.1.3

    Ver no GitHub

    ### Correções

  3. 0.1.2

    Ver no GitHub

    ### Documentação

  4. 0.1.1

    Ver no GitHub

    ### Correções

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.