Qué es Herdr: el multiplexor de terminal para agentes de IA
DominicodeSon las once de la noche. Tienes cuatro pestañas de terminal abiertas: Claude Code refactorizando el módulo de pagos, Codex escribiendo tests, un tercer agente migrando el esquema y un cuarto que ya ni recuerdas qué hacía.
Dos están trabajando. Una lleva veinte minutos parada esperando que le digas "sí" a un permiso. La cuarta terminó hace rato y nadie la miró. Cierras la tapa del portátil para irte a casa y la conexión SSH con el servidor de build se corta. Adiós sesiones.
Ese es el problema que resuelve Herdr, y saber qué es Herdr importa porque no es "otro tmux": es una apuesta concreta sobre cómo deberíamos trabajar cuando el que teclea en la terminal ya no eres tú.
En corto: Herdr es un multiplexor de terminal para agentes de IA, open source (Apache 2.0, escrito en Rust), que mantiene vivos a tus agentes de código en un servidor en segundo plano y te muestra si cada uno está trabajando, bloqueado o terminado. Además expone una CLI y una API por socket para que scripts u otros agentes creen paneles, lancen agentes y lean su salida. Funciona en Linux, macOS y Windows.
¿Qué es Herdr?
Herdr es un multiplexor de terminal pensado para agentes de IA: mantiene sesiones persistentes como tmux, pero además reconoce qué paneles ejecutan un agente, en qué estado está cada uno y permite controlarlos por código.
La documentación oficial lo describe como un "terminal workspace manager for AI coding agents", y el repositorio herdrdev/herdr como "the runtime your coding agents live on". La palabra importante es runtime. Herdr no reemplaza tu terminal (sigues usando Windows Terminal, iTerm o WezTerm). Se mete dentro y gestiona los procesos que corren en ella.
Su modelo tiene cuatro piezas, según la página de conceptos:
- Workspace: un contenedor por proyecto o repo.
- Tab: un layout dentro del workspace (
agents,logs,review…). - Pane: una terminal real.
- Agent: un proceso que Herdr reconoce dentro de un pane.
Por debajo hay un servidor que es dueño de los procesos y uno o varios clientes que se enganchan a él. Cierras la ventana y el servidor sigue. Vuelves a ejecutar herdr y estás donde lo dejaste.
Herdr en cifras: estado del proyecto
Datos comprobados a 21 de octubre de 2026:
| Dato | Valor | Fuente |
|---|---|---|
| Estrellas en GitHub | 45.115 | API de GitHub, 21/10/2026 |
| Repositorio público desde | 27 de marzo de 2026 (commit "initial release") | API de GitHub |
| Última versión estable | v0.9.5 (14/10/2026) | Releases |
| Licencia | Apache-2.0 (antes AGPL) | LICENSE y blog oficial |
| Financiación | Y Combinator, batch F26 (anunciado el 06/08/2026) | Blog oficial |
| Agentes con detección de estado | Más de 20 CLIs (Claude Code, Codex, Cursor, Copilot, OpenCode, Pi, Hermes Agent, Droid…) | Docs: Agents |
Fíjate en dos cosas. Pasar de cero a 45.000 estrellas en siete meses dice mucho del dolor que resuelve. Y seguir en 0.x dice que la API todavía se mueve.
Cómo funciona la detección de estado de los agentes
Herdr localiza el proceso del agente en cada pane, lee la parte viva de la pantalla y aplica reglas de un manifiesto para decidir su estado. Algunas integraciones (OpenCode, Pi, Kimi, Kilo…) también informan del estado directamente, y entonces Herdr usa esos informes en lugar de leer la pantalla.
Los estados que muestra en la barra lateral son estos:
| Estado | Qué significa |
|---|---|
blocked |
El agente necesita una respuesta, una aprobación o una decisión |
working |
Está ejecutando |
done |
Terminó y todavía no lo has mirado |
idle |
Terminó o espera, y ya lo has visto |
unknown |
Herdr no puede clasificarlo con seguridad |
Ya no vas de pestaña en pestaña preguntando "¿y tú qué?". Ves un blocked en la barra lateral y vas directo a ese pane. Es lo mismo que hago con worktrees cuando dirijo varios agentes en paralelo sin que se pisen, pero con la capa de atención resuelta por la herramienta.
Herdr vs tmux, claude-squad y pestañas de terminal
La pregunta obvia es si esto no lo hace ya tmux. La respuesta corta: tmux mantiene terminales vivas, Herdr además sabe cuáles son agentes y qué les pasa. La propia página de comparativas de Herdr lo resume con un "tmux sees panes".
| Criterio | Pestañas de terminal | tmux | claude-squad | Herdr |
|---|---|---|---|---|
| Sesión persistente si cierras la ventana | No | Sí | Sí (usa tmux) | Sí |
| Sabe qué pane es un agente | No | No | Sí | Sí |
| Estado por agente (bloqueado, terminado…) | No | No nativo (se puede montar con hooks) | Básico (en su TUI) | Sí, en barra lateral |
| API para que scripts o agentes lo controlen | No | Comandos de tmux | No (es una TUI, cs) |
CLI + socket con salida JSON |
| Worktrees de git | Manual | Manual | Integrados | herdr worktree create |
| Windows nativo | Sí | No (WSL) | Depende de tmux | Sí, con limitaciones documentadas |
| Licencia | — | ISC | AGPL-3.0 | Apache-2.0 |
| Limitación principal | Pierdes todo al cerrar | No entiende de agentes | Atado a tmux y a su TUI | Proyecto 0.x y plugins sin sandbox |
claude-squad es la alternativa más parecida: monta cada agente en una sesión de tmux con su propio worktree. Si ya trabajas así y te va bien, no tienes motivo para migrar mañana.
La discusión pública no es unánime. En el hilo de Hacker News de julio de 2026 (más de 400 puntos y 178 comentarios), varios usuarios preguntan qué aporta frente a tmux o zellij más allá del ratón y el estado de los agentes. Otro cuenta que lo usa para sus agentes y se engancha a la misma sesión desde varias máquinas, pero que en WezTerm no puede copiar con el teclado porque la pantalla se redibuja constantemente y pierde la selección. Y un tercero enseña cómo lo resuelve en tmux con los hooks de Claude Code: un indicador por ventana para trabajando, necesita atención y terminado. Es la objeción más seria, y la respuesta de Herdr es que eso viene hecho para más de 20 CLIs. Vale la pena leer el hilo antes de decidir.
Cómo instalar Herdr y lanzar tu primer agente
Se instala con un script de una línea y se arranca con el comando herdr desde la carpeta de tu proyecto. Todos los comandos de esta sección salen de la guía de instalación y del quick start de la v0.9.5.
En Linux o macOS:
curl -fsSL https://herdr.dev/install.sh | sh
En Windows, desde PowerShell:
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
También tienes brew install herdr y mise use -g herdr si prefieres gestor de paquetes.
Después, desde el directorio del proyecto:
herdr
Dentro, lanza tu agente como siempre (claude, codex, opencode…) y Herdr lo detecta solo. Para que la sesión del agente vuelva tras reiniciar el servidor, instala su integración:
herdr integration install claude
Herdr funciona con ratón, pero si vienes de tmux el prefijo es ctrl+b: prefix+v divide a la derecha, prefix+q te desengancha sin matar nada y herdr server stop cierra la sesión de verdad.
Orquestar agentes por código con la CLI de Herdr
La parte más interesante de Herdr no es la interfaz: es que un script, o un agente, puede crear paneles, arrancar otros agentes, mandarles prompts y esperar a que terminen. Los comandos de creación devuelven JSON, así que encadenarlos es directo. Este ejemplo sale de la guía de automatización:
created=$(herdr workspace create --cwd ~/project --label api --no-focus)
pane_id=$(printf '%s\n' "$created" | jq -r '.result.root_pane.pane_id')
split=$(herdr pane split "$pane_id" --direction right --no-focus)
review_pane=$(printf '%s\n' "$split" | jq -r '.result.pane.pane_id')
herdr agent start reviewer --kind codex --pane "$review_pane"
herdr agent prompt reviewer "Review the current diff" --wait --timeout 120000
herdr agent read reviewer --source recent-unwrapped --lines 120
Un script (o tu agente principal) levanta un revisor con Codex, le pide revisar el diff, espera a que termine y lee la respuesta. Solo necesitas jq instalado. Revisión cruzada sin escribir un orquestador desde cero.
Aquí está mi opinión: esta API es la razón para probar Herdr, no la barra lateral. La barra lateral es fácil de copiar, y otras terminales ya lo están haciendo. Una capa estable y scriptable para coordinar agentes CLI heterogéneos es más difícil de replicar. Es la misma idea que trabajamos en el curso Construye con IA: el agente no es el producto, el sistema que lo rodea sí.
Y si te preocupa perder el hilo cuando no estás delante, Herdr también permite conectarse por SSH con herdr --remote o registrar máquinas con herdr machine add. Es un enfoque distinto al de Claude Code Remote Control: aquel conecta tu móvil a una sesión de Claude, Herdr mantiene todas las sesiones de todos tus agentes vivas en el servidor.
Cuándo NO usar Herdr
No uses Herdr si solo ejecutas un agente, si necesitas una herramienta con API estable o si vas a instalar plugins de terceros en una máquina con credenciales sensibles. Estos son los límites que documenta el propio proyecto:
1. Los plugins no tienen sandbox. La documentación de plugins lo dice claro: un plugin es código normal que corre con tu usuario, hereda tu entorno y puede llamar a toda la CLI de Herdr. Herdr valida el manifiesto, pero no revisa ni aísla el código. El marketplace tampoco es un catálogo revisado. Si trabajas con credenciales de cliente en esa máquina, instala solo plugins cuyo código hayas leído.
2. Es un proyecto 0.x. La última estable es la v0.9.5. El canal preview "puede tener regresiones", según su propia guía, y la actualización con traspaso en caliente del servidor (herdr update --handoff) está marcada como experimental. Si tu equipo necesita una herramienta que no cambie cada mes, espera a la 1.0.
3. En Windows hay diferencias. Los plugins están en preview y hay menos integraciones que en Unix (página de Windows).
4. Contribuir no es abierto. Su CONTRIBUTING.md cierra automáticamente los pull requests de cualquiera que no esté en una lista de colaboradores aprobados. Lo justifican por la avalancha de PRs generados por agentes, pero significa que dependes de las prioridades de su equipo.
5. Si solo usas un agente, no lo necesitas. Con un único Claude Code en una terminal, tmux o una pestaña te sobran. Herdr empieza a compensar cuando necesitas ejecutar varios agentes de IA en paralelo y ya no puedes vigilarlos de un vistazo, o cuando trabajas contra un servidor remoto.
Lo que puedes hacer hoy
Instala Herdr en la máquina donde más agentes lanzas, abre un workspace por repo y deja que la barra lateral te diga quién te necesita. Si al cabo de una semana sigues abriendo pestañas sueltas, desinstálalo. Si no, el siguiente paso es la API: escribe un script de diez líneas que arranque un agente revisor después de cada tarea.
Si quieres entender qué hay detrás de lo que Herdr orquesta (el loop, las tools, la memoria, cómo se coordinan varios agentes), lo tienes explicado paso a paso en el ebook gratuito El Developer Agéntico. Y si tu flujo ya incluye Hermes, mira cómo meter Hermes Agent en tu flujo de trabajo diario: Herdr lo detecta como un agente más.
Preguntas frecuentes
¿Herdr es gratis y open source?
Sí. El código está en GitHub bajo licencia Apache-2.0, después de cambiar desde AGPL. En el anuncio de su entrada en Y Combinator, el autor confirmó que el runtime que usas hoy seguirá siendo gratuito.
¿Herdr funciona en Windows?
Sí, de forma nativa y en el canal estable. Se instala con un comando de PowerShell y usa ConPTY. Hay limitaciones documentadas: los plugins están en preview y algunas integraciones de agentes no están disponibles en Windows.
¿Qué agentes de IA soporta Herdr?
Detecta el estado de más de veinte CLIs, entre ellos Claude Code, Codex, GitHub Copilot CLI, Cursor Agent CLI, OpenCode, Pi, Hermes Agent, Droid y Grok CLI. Cualquier otro programa también corre en un pane, pero aparece como una terminal normal, sin estado.
¿Cuál es la diferencia entre Herdr y tmux?
Los dos mantienen sesiones persistentes y usan ctrl+b como prefijo. La diferencia es que Herdr reconoce qué paneles ejecutan un agente, muestra si está bloqueado o terminado y ofrece comandos como herdr agent wait para esperar a que acabe. tmux solo ve terminales.
¿Los agentes siguen trabajando si cierro el portátil?
Si Herdr corre en tu portátil y lo suspendes, no: el proceso se detiene con la máquina. Si corre en un servidor y te conectas por SSH, sí. Puedes cerrar la conexión y el servidor de Herdr mantiene a los agentes trabajando hasta que vuelvas.
Por Bezael Pérez — Developer senior con más de 15 años de experiencia, autor del libro Spec-Driven Development y fundador de Dominicode, donde enseña a construir con agentes de IA.
¿Te resultó útil este artículo?
Compártelo con tu comunidad y ayuda a otros desarrolladores.