Qué es Herdr: el multiplexor de terminal para agentes de IA

Qué es Herdr — Dominicode

Written by

in

, ,

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

Comments

Leave a Reply

Your email address will not be published. Required fields are marked *