Imagina la escena. Claude Code termina un endpoint, abre un panel al lado, arranca a Codex y le pide que revise el diff. Codex contesta: "dos comentarios menores, el resto bien". Claude Code arregla los dos comentarios y vuelve a preguntar. Codex aprueba.
Dos modelos de dos empresas distintas se han puesto de acuerdo. Todo verde. Nadie ha ejecutado los tests de integración, porque ninguno de los dos tenía esa instrucción.
Herdr permite orquestar agentes de IA desde la terminal con una skill y una CLI. Lo espectacular es que los agentes se hablen entre sí. Lo peligroso es exactamente lo mismo.
En corto: con la skill de Herdr, un agente como Claude Code puede abrir paneles, arrancar a Codex, Gemini o Grok en ellos, mandarles prompts, esperar a que terminen y leer su respuesta, incluso en otra máquina por SSH. Trátalo como un harness: roles fijos, un tope de rondas y una persona que aprueba, porque dos agentes que se responden entre sí pueden darse la razón o entrar en bucle.
¿Qué es orquestar agentes de IA con Herdr?
Orquestar agentes de IA con Herdr es dejar que un agente, desde su propio panel, use la CLI de Herdr para crear paneles, lanzar otros agentes de código, darles trabajo y recoger su resultado, sin que tú hagas de mensajero.
Herdr es un multiplexor de terminal para agentes que mantiene las sesiones vivas y sabe si cada agente trabaja, está bloqueado o ha terminado. Todo lo que sigue está comprobado contra la documentación de Herdr v0.9.5. La instalación y la comparativa con tmux están en qué es Herdr. Aquí voy a otra cosa: agentes que dirigen a otros agentes.
La skill de Herdr: cómo un agente controla a los demás
La skill de Herdr es un archivo SKILL.md que enseña a un agente a usar la CLI herdr cuando corre dentro de un panel de Herdr. Se instala así, según la página oficial de la skill:
npx skills add herdrdev/herdr --skill herdr -g
Con ella, el agente ve los paneles vecinos, divide paneles sin robarte el foco, lee su salida, espera a que otro agente termine y arranca agentes ayudantes. La CLI también tiene herdr pane rename y herdr pane close, y la skill solo le deja cerrar los paneles que haya creado él.
Dos detalles del SKILL.md importan más que los comandos: sin HERDR_ENV=1 el agente debe pararse, y la skill solo se activa cuando el usuario menciona Herdr. El agente no delega por iniciativa propia. Se lo pides tú.
En la demo de NetworkChuck se ve el caso extremo, un Claude Code repartiendo trabajo a varios agentes a la vez, pero el patrón útil es mucho más pequeño.
Un agente implementa, otro revisa: el bucle mínimo
El patrón más rentable de agentes que hablan entre sí es un implementador y un revisor de otro proveedor. Un modelo distinto tiene sesgos distintos, y eso es justo lo que quieres en una revisión.
La receta base ya la viste en qué es Herdr. Aquí cambian dos cosas: el panel se abre junto al agente que orquesta (--current) y el prompt revisa contra un contrato. Los comandos salen de la guía de automatización de Herdr; el prompt es mío:
# Abre un panel hermano, en el mismo directorio, sin quitarte el foco
split=$(herdr pane split --current --direction right --cwd "$PWD" --no-focus)
pane=$(printf '%s\n' "$split" | jq -r '.result.pane.pane_id')
# Arranca a Codex como revisor, con un nombre estable
herdr agent start reviewer --kind codex --pane "$pane"
# Le da trabajo y espera a que termine (máximo 5 minutos)
herdr agent prompt reviewer "Revisa git diff main contra docs/spec.md. Lista solo incumplimientos de la spec, con fichero y línea. Si no hay ninguno, responde NINGUNO." --wait --timeout 300000
# Lee la respuesta del panel de al lado
herdr agent read reviewer --source recent-unwrapped --lines 120
Fíjate en el prompt. No dice "revisa el código": dice contra qué se revisa y qué formato tiene la respuesta. Eso evita la escena del principio, porque el revisor compara contra un contrato y no contra la opinión del que implementó. Es la idea de la Revisión por Contrato aplicada a un revisor que también es una IA.
Para que el principal se entere de que el otro tiene una pregunta, Herdr ofrece herdr agent wait reviewer --until blocked, y la API por socket permite suscribirse al evento pane.agent_status_changed. Y aquí la skill vuelve a ser sensata: cuando el agente vecino está bloqueado en una aprobación, le dice al principal que lo inspeccione y pregunte al usuario antes de responder. Si tu agente principal aprueba permisos de otro agente sin preguntarte, lo has configurado tú así.
Agentes en otra máquina con herdr --machine
Herdr guarda máquinas remotas por SSH con herdr machine add y deja enrutar comandos a ellas con el prefijo --machine, según la guía de conexión entre máquinas. Eso significa que un agente en tu portátil puede dar trabajo a un agente que corre en tu servidor de build:
herdr --machine "Build machine" agent list
# usa el ID o el nombre que devuelva agent list
herdr --machine "Build machine" agent prompt w1:p1 "Ejecuta la suite e2e y resume solo los fallos" --wait --timeout 1800000
herdr --machine "Build machine" agent read w1:p1 --source recent-unwrapped --lines 120
Dos letras pequeñas. Los IDs de paneles y los nombres de agentes son de cada servidor, así que --current no apunta a nada remoto y hay que usar IDs explícitos. Y el prefijo apunta a una máquina cada vez: no hay listados combinados. Yo lo usaría para lo que no cabe en el portátil, como la suite e2e o una build pesada, no para repartir una feature entre dos continentes.
Herdr frente a subagentes y a un solo agente
Herdr compensa cuando necesitas un revisor de otro proveedor o mover trabajo a otra máquina; si todo cabe en Claude Code, los subagentes salen más baratos. Esta es la comparativa con lo que tienes en Claude Code sin instalar nada:
| Criterio | Un solo agente | Subagentes de Claude Code | Cross-session messaging | Orquestador en paneles de Herdr |
|---|---|---|---|---|
| Mezcla proveedores (Codex, Gemini, Grok…) | No | No | No, solo sesiones de Claude Code | Sí, 24 tipos de agente en --kind |
| Ves el trabajo de cada agente | Sí | Solo el resultado | Cada sesión en su terminal | Sí, cada uno en su panel |
| Estado de cada agente | No aplica | Dentro de tu sesión | Solo un aviso cuando otra sesión queda libre | working, blocked, done, idle, unknown |
| Funciona entre máquinas | No | No | Sí, con Remote Control y cuenta de claude.ai | Sí, por SSH |
| Coste en tokens | El mínimo | Sube con cada subagente | Cada mensaje es un prompt | Una sesión completa por agente |
| Limitación o riesgo | Un solo sesgo revisando su propio trabajo | Contexto aislado, solo un proveedor | Sin buzón durable | Estado detectado leyendo la pantalla; bucles y acuerdos en falso si no pones reglas |
Si solo quieres que Codex revise un diff, el plugin oficial codex-plugin-cc lo hace sin paneles. Mi opinión: orquestar agentes de IA con Herdr compensa cuando además quieres ver qué hace cada uno en vivo.
Lo que se rompe cuando los agentes se hablan entre sí
Cuando dos agentes se hablan, fallan de cuatro formas: se dan la razón, entran en bucle, leen un estado falso o uno contesta por ti.
El acuerdo en falso. Dos agentes que leen el mismo diff sin un criterio externo tienden a aprobarse. La solución no es un tercer agente, es una spec o unos tests que ninguno de los dos pueda reinterpretar.
El bucle. El revisor pide un cambio, el implementador lo hace, el revisor pide otro. Sin un tope de rondas, eso no termina nunca, o termina cuando se acaba tu cuota. Pon el límite en el prompt del orquestador: dos rondas y, si sigue habiendo desacuerdo, me lo traes a mí.
El estado que miente. Herdr deduce el estado leyendo lo que el agente pinta en pantalla, y la propia documentación avisa de que Antigravity y Grok cuentan como idle en cuanto vuelven a su prompt, aunque tengan subagentes trabajando. El issue más grave abierto: una aprobación de un subagente de Antigravity que se detecta como idle en vez de blocked, sin notificación, y que caduca sola a los 60 segundos (hay casos parecidos en #2354 y #5004, este con Claude Code).
Si tu orquestador espera a idle para leer el resultado, puede leer un trabajo a medias.
El orquestador que contesta por ti. En Hacker News, un usuario cuenta que, con Rex (una alternativa a Herdr), deja una sesión que mira cómo van las demás y le presenta las decisiones que necesitan de él. Ese es el rol correcto del agente principal: juntar las preguntas, no responderlas. Si la pregunta es "¿borro estos registros?", la respuesta es de una persona. En el mismo foro hay quien no ve la ventaja frente a los subagentes con comunicación de ida y vuelta de Claude Code desktop. Es una objeción razonable si solo usas Claude.
Esto es diseño de harness, no de prompts: quién implementa, quién revisa, contra qué y cuándo para la máquina y entra una persona.
Cuándo NO orquestar agentes de IA con Herdr
Cuando la tarea es pequeña. Anthropic midió en su sistema de investigación multiagente (13 de junio de 2025) que un agente gasta unas 4 veces los tokens de un chat y un sistema multiagente unas 15 veces. Con cuatro agentes en cuatro paneles, cada uno con su sesión completa, pagas un multiplicador parecido por un cambio que uno solo resolvía. Lo comparé con más datos en harness multiagente vs un solo agente.
Cuando todos necesitan el mismo contexto. Cada agente lee el repo por su cuenta. Si las subtareas dependen unas de otras, pagas varias veces la misma lectura y además tienes que sincronizarlos.
Cuando no usas worktrees. La skill, por defecto, abre el panel ayudante en el mismo directorio y no crea worktrees salvo que lo pidas. Dos agentes escribiendo en la misma carpeta se pisan. Para que cada uno trabaje en su copia existe herdr worktree create; si no lo usas, deja que solo uno escriba y que el otro lea.
Y si lo que necesitas es orquestar agentes de IA dentro de tu propio código, con un plan y workers en paralelo, el camino es otro: cómo se construye un orquestador de agentes IA en TypeScript.
Lo que puedes hacer hoy
Monta solo el bucle mínimo:
- Instala la skill y abre Claude Code dentro de un panel de Herdr.
- Escribe en tu
AGENTS.mdtres reglas: Codex revisa contradocs/spec.md, máximo dos rondas, la decisión final es tuya. Si tienesCLAUDE.md, Claude Code no leeAGENTS.mdpor su cuenta: impórtalo desde ahí con@AGENTS.md. - Pide a Claude Code que lance el revisor con el bloque de comandos de arriba.
- Al cabo de una semana, cuenta cuántos hallazgos del revisor no habrías visto tú. Si son cero, no necesitas dos agentes.
Si quieres entender qué pasa por debajo cuando un agente coordina a otros (el loop, las tools, cómo se reparte la memoria), está explicado en el ebook gratuito El Developer Agéntico. Diseñar ese harness completo (quién implementa, quién revisa y contra qué) es lo que trabajo en el workshop SDD + Agentic Engineering. Y si quieres llevarlo a un producto de verdad, de la idea al despliegue, es lo que hacemos en Construye con IA.
Preguntas frecuentes
¿Puede Claude Code hablar con Codex directamente?
No de forma nativa: el cross-session messaging de Claude Code solo conecta sesiones de Claude Code. Para una revisión puntual, OpenAI publica un plugin oficial, codex-plugin-cc, que añade /codex:review a Claude Code. Herdr va más allá: Claude Code usa la CLI para mandar un prompt al panel donde corre Codex, ver su trabajo en vivo y leer su respuesta, así que la conversación pasa por la terminal.
¿Qué agentes puede arrancar la skill de Herdr?
Los que acepta herdr agent start --kind: la documentación de la v0.9.5 lista 24, entre ellos claude, codex, gemini, grok y agy (Antigravity). Gemini aparece como menos probado y solo con detección de estado.
¿Cómo evito que dos agentes se respondan en bucle?
Pon el límite en el prompt del agente que coordina: un número máximo de rondas y una salida clara cuando se agota, por ejemplo "si tras dos rondas hay desacuerdo, para y resume las dos posturas". Usa también --timeout en agent prompt --wait, porque las esperas de Herdr no tienen timeout por defecto.
¿La skill de Herdr funciona fuera de Herdr?
No. La skill comprueba que exista HERDR_ENV=1, que solo está en procesos lanzados dentro de un panel de Herdr. Si no está, el agente debe pararse y avisar. Así evita controlar una sesión que no es suya.
Por Bezael Pérez — Developer senior con más de 15 años de experiencia y fundador de Dominicode.

Leave a Reply