Imagem em destaque para Agent Herder: o que é e como supervisionar agentes de IA

Agent Herder: o que é e como supervisionar agentes de IA

Publicado em:

Tempo de leitura: 6 min

Tema: Tecnologia

Autor: Leandro Valencia

#agent herder#herder ai#claude code#orquestração de agentes#wave terminal#ai harness

Agent Herder é o gerenciador de sessões que transforma abas do terminal em uma frota de agentes Claude Code: requisitos reais e por que hoje só funciona no macOS.

Índice

O problema específico que ele resolve

Com um único agente, o chat basta como supervisão: você vê o que ele faz, aprova ou corrige, e segue em frente. Esse modelo quebra no momento em que você roda trabalho em paralelo. Um agente refatora um módulo, outro escreve testes, um terceiro investiga um bug. Sem uma camada de coordenação, você acaba alternando entre terminais e perdendo de vista qual sessão está bloqueada e qual já terminou.

A resposta clássica é um multiplexador de terminal como o tmux. Funciona, mas te obriga a decorar atalhos e a ser você quem lembra o que vive em cada painel.

O Agent Herder inverte isso. Em vez de você gerenciar os painéis, o próprio Claude gerencia sua frota de sessões irmãs: abrindo-as, lendo a saída delas, enviando prompts e fazendo fork de uma conversa para explorar uma alternativa — sem você trocar de aba à mão. Você supervisiona; o agente coordena.

O que "Agent Herder" realmente é em 2026

Há uma confusão que vale a pena esclarecer aqui, porque ela muda o que você instala.

"Agent Herder" hoje não é um pacote único, mas um pequeno ecossistema com duas peças que você não deve confundir:

1. A ferramenta. O binário que de fato orquestra, distribuído como @generativereality/agentherder. Open source e gratuito.

2. A camada educacional. O agentherder.com funciona como comunidade e programa de treinamento em torno da prática de coordenar frotas de agentes: um currículo gratuito de autoestudo, um bootcamp de várias semanas com mentoria e uma certificação paga.

Essa segunda peça é distinta da ferramenta e mira equipes que querem padronizar como trabalham com múltiplas sessões, não apenas instalar uma CLI. Se você quer a ferramenta, não precisa pagar por nada.

Cuidado com o pacote descontinuado

O pacote original, @generativereality/herd, está marcado como deprecated no npm em favor do seu sucessor. Vale saber se o seu ponto de partida é um link antigo: instalar o antigo hoje redireciona para a versão ativa, mas é melhor ir direto ao @generativereality/agentherder e não ficar preso numa versão sem manutenção.

Requisitos reais (leia antes de instalar)

Esta é a parte que a maioria descobre tarde demais. O Agent Herder tem restrições de plataforma que não são um detalhe menor:

Requisito Detalhe
Terminal Wave Terminal obrigatório. Não roda em qualquer terminal.
Sistema operacional Apenas macOS, com permissões de acessibilidade concedidas ao Wave.
Runtime Node.js 20 ou superior.
Agente Projetado primariamente para Claude Code.
Interface Somente abas do terminal. Sem GUI, sem app móvel.

Se a sua equipe roda Linux em CI ou WSL no Windows, esta ferramenta simplesmente não se aplica hoje. Não é uma limitação que você contorna com configuração: é uma dependência de plataforma.

Como instalar

São três caminhos, todos equivalentes no resultado:

# 1. Global npm package
npm install -g @generativereality/agentherder

Os outros dois são instalar como plugin do marketplace do Claude Code ou como skill independente, dependendo de como você quer integrá-lo ao seu fluxo. Se você já gerencia seus plugins do Claude Code pelo marketplace, esse caminho mantém tudo num lugar só.

Antes de rodar qualquer um dos três, garanta que o Wave Terminal está instalado com permissões de acessibilidade e que o Node 20+ está disponível (node -v). A ordem importa: instalar o pacote sem o terminal hospedeiro deixa você com uma CLI que não tem onde abrir abas.

Quando o Agent Herder é a escolha certa

O cenário em que ele se encaixa é bem específico, e isso é uma virtude, não um defeito:

  • Você é desenvolvedor solo ou parte de uma equipe pequena.
  • Você já vive no macOS.
  • Você já usa Wave Terminal, ou está disposto a adotá-lo.
  • Você trabalha quase exclusivamente com Claude Code.
  • O seu fluxo real é "subir três ou quatro sessões que se coordenam para dividir uma tarefa grande".

Nesse caso, o modelo de abas nomeadas é mais leve do que montar um ambiente de desenvolvimento completo: sem worktrees para aprender, sem navegador embutido, sem conceitos de coordenador. Apenas abas que o próprio Claude abre e lê.

Quando não usar

Seja honesto consigo aqui, porque o instalador não vai avisar:

  • Você trabalha no Windows ou Linux → não disponível.
  • Você precisa supervisionar pelo celular → não existe app.
  • Sua frota abrange vários provedores (Codex, Gemini, Cursor) → ele é feito para o Claude Code.
  • Você quer integrações com GitHub ou Linear → ele não traz nenhuma nativa.

Nos quatro casos, a alternativa razoável é o Orca, que é multiplataforma, multiagente e tem um app móvel em beta.

Herder não é um harness — é uma camada sobre um

Uma nota conceitual que evita um mal-entendido comum: pesquisar "herder ai harness" mistura duas coisas. O harness é o ambiente que dá ao modelo as ferramentas, o contexto e as permissões — aqui, é o Claude Code. O Herder não substitui esse harness: ele o multiplica, permitindo que várias instâncias do mesmo harness se coordenem.

Se o que te interessa é por que essa camada importa mais do que a escolha do modelo, cobrimos isso à parte em por que o harness importa mais do que o modelo.

Conclusão

O Agent Herder é uma ferramenta deliberadamente estreita: abas de terminal no macOS para que o Claude Code coordene as próprias sessões. Dentro desse escopo, a curva de aprendizado é baixa e experimentar não custa nada. Fora dele — outro sistema, outro agente, supervisão remota — a compatibilidade não é parcial: é zero.

A pergunta útil antes de instalar não é se é uma boa ferramenta, mas se o seu fluxo já é 100% terminal e 100% Claude Code no macOS. Se sim, ele pesa menos que qualquer alternativa. Se não, não force.

Continue lendo

Step-by-step guide

  1. Confirme que está no macOS

    O Agent Herder depende do Wave Terminal rodando no macOS. Não existe build para Linux ou Windows hoje, então não gaste tempo tentando.

  2. Instale o Wave Terminal

    Este é o terminal hospedeiro obrigatório. Conceda a ele permissões de acessibilidade nos Ajustes do Sistema, ou o Herder não consegue controlar as abas.

  3. Verifique o Node.js 20 ou superior

    Rode `node -v`. Se estiver abaixo da versão 20, atualize antes de instalar o pacote global.

  4. Instale o pacote correto

    Rode `npm install -g @generativereality/agentherder`. Não instale `@generativereality/herd`: está deprecated.

  5. Abra sua primeira frota

    Inicie uma sessão de Claude Code numa aba nomeada e deixe o próprio agente abrir e ler as sessões irmãs de que precisar.

Frequently asked questions

O que é o Agent Herder?

É um gerenciador de sessões para agentes de código de IA. Usa abas nomeadas do terminal como interface em vez do tmux, para que o Claude Code possa gerenciar a própria frota de sessões irmãs: abrindo-as, lendo a saída, enviando prompts e fazendo fork de conversas.

O Agent Herder funciona no Linux ou no Windows?

Não, até o momento da escrita. Depende do Wave Terminal rodando no macOS com permissões de acessibilidade. Se você trabalha no Linux ou Windows, a alternativa viável é o Orca, que é multiplataforma.

Como instalo o Agent Herder?

Rode `npm install -g @generativereality/agentherder`, ou instale como plugin do marketplace do Claude Code, ou como skill independente. Requer Node.js 20 ou superior e o Wave Terminal já instalado.

Qual pacote npm é o certo?

`@generativereality/agentherder`. O pacote original, `@generativereality/herd`, está marcado como deprecated no npm. Se você chegou por um link antigo para o `herd`, instale o sucessor diretamente.

O Agent Herder é gratuito?

Sim, a ferramenta é open source e não cobra pela orquestração. Você ainda precisa da sua própria assinatura ou chave de API para os agentes que rodar. O bootcamp e a certificação no agentherder.com são um programa de treinamento pago separado, não o pacote.

O Agent Herder é uma IDE?

Não. Não tem GUI nem editor: tudo acontece nas abas do Wave Terminal. Se você quer um ambiente completo com navegador embutido e app móvel, isso é o Orca, não o Herder.

Posts Relacionados

Continue explorando conteúdo similar que pode te interessar

Alianças

Ferramentas que uso todos os dias, com melhores condições para a comunidade.

Links de afiliado. O preço para si não muda.Ver todas as alianças
Programa de formação

Pronto para transformar sua ideia em um projeto real?

Transforma é o programa onde você aprenderá a criar, executar e escalar seu projeto com clareza e método.

Conhecer o Programa Transforma