Herdr vs tmux: varios agentes de IA en la terminal

Tienes tres agentes abiertos. Uno refactoriza, otro escribe tests, un tercero persigue un bug. Y tú, con cuatro pestañas de terminal, jugando a
las adivinanzas: ¿cuál está bloqueado esperando tu permiso? ¿Cuál terminó hace diez minutos y no te has enterado? ¿Cuál sigue pensando?

El cuello de botella ya no es la máquina. Eres tú.

Esa es la razón exacta por la que existe herdr: un multiplexor de terminal escrito en Rust que no solo divide tu pantalla en paneles como
haría tmux, sino que entiende qué está pasando dentro de cada uno. Sabe si un agente trabaja, si espera tu input o si ha terminado. Y lo pinta
en una barra lateral para que lo veas de un vistazo.

En este artículo vamos a ver:

• Qué es herdr y por qué un multiplexor “normal” se queda corto con agentes de IA
• Cómo instalarlo y montar tu primer espacio de trabajo en dos minutos
• Los estados de agente (bloqueado, trabajando, hecho) y cómo se propagan
• El truco que lo cambia todo: agentes que controlan herdr a través de su API de socket
• Sesiones persistentes, trabajo remoto y supervisión desde el móvil
• Cuándo usarlo, cuándo no, y qué limitaciones tiene hoy

Lo que leerás aquí sale de la documentación oficial, del repositorio en GitHub y de las demos que circulan estos días. Vamos al grano.

Qué es herdr y qué problema resuelve ¶

herdr es un multiplexor de terminal con conciencia de agentes. Corre como un único binario de Rust (unos 10 MB, sin Electron, sin Node.js, sin
telemetría ni cuentas) dentro del terminal que ya usas, sea iTerm2, Alacritty, Kitty o el que tengas a mano (fuente: repositorio oficial en
GitHub).

El nombre es un juego con herder, “pastor”. Estás pastoreando agentes. Y si alguna vez has intentado coordinar cinco agentes trabajando a la vez
sobre partes distintas de tu código, la metáfora te va a encajar sin esfuerzo.

El problema es reciente. Antes de los agentes de código, usábamos tmux o screen para gestionar varias sesiones de terminal. Herramientas
excelentes en lo suyo: persistencia y división de paneles. Pero no tienen ni idea de qué ocurre dentro de cada panel. Para tmux, un panel con
Claude Code esperando tu confirmación, otro con Codex compilando y un tercero con un agente que ya terminó son exactamente lo mismo: tres paneles
con texto. Tienes que mirarlos uno a uno para saber qué pasa.

Si vives en tmux y encadenas comandos con pipes, ese flujo funciona; lo recogíamos en la comparativa de Claude Code frente a
OpenCode. Y muchos developers montan sistemas serios combinando tmux con worktrees de
Git, un patrón que detallamos al explicar cómo migrar entre Claude Code, Codex y
OpenCode. El límite es siempre el mismo: tmux no distingue un agente a tope
de uno parado esperándote.

Y ese “mirar uno a uno” no escala. Boris Cherny, creador de Claude Code, cuenta que abre cinco sesiones numeradas del 1 al 5 con notificaciones
del sistema para saber cuándo alguna reclama su atención. Ese patrón, que ya vimos al desgranar los trucos de Claude Code de
Boris, es justo el hueco que herdr quiere ocupar de forma nativa.

🔑 La diferencia con tmux no está en dividir paneles ni en persistir sesiones. Eso ya lo hacían. Está en que herdr lee el estado del agente
dentro de cada panel y te lo muestra sin que tengas que entrar a comprobar.

No es la primera vez que la comunidad pelea con esto. En Agent Teams de Claude Code la
recomendación para trabajar cómodo pasa por habilitar paneles paralelos con tmux o iTerm2. Y herramientas como Agent
Orchestrator usan directamente tmux como runtime para gestionar las sesiones de los agentes.
La pieza que faltaba era un multiplexor que naciera pensando en agentes, no adaptado a posteriori.

Curso gratis · paso a paso

Orquestar agentes está bien; darles método, mejor

herdr te dice qué hace cada agente; el Spec Driven Development le dice a cada agente qué construir y cómo. En este curso recorres un ciclo completo de SDD con OpenSpec sobre un proyecto real y sales del vibecoding antes de coger tú el volante.

Entra en el curso gratis →

Cómo instalar herdr y arrancar tu primer espacio ¶

La instalación es un único comando. Nada de configuración previa ni dependencias externas.

# Instalación en Linux o macOS
curl -fsSL https://herdr.dev/install.sh | sh

Si vives en Homebrew o en mise, tienes atajos:

# Con Homebrew (macOS y Linux)
brew install herdr

# Con mise
mise use -g herdr

En Windows hay una beta preview que se instala con PowerShell, aunque conviene saber que el soporte nativo de Windows todavía es experimental y le
faltan piezas como el attach remoto. Para trabajar desde Windows con garantías, lo sensato hoy es conectarte por SSH a tu servidor y ejecutar
herdr allí.

Una vez instalado, lo arrancas donde vive el trabajo:

# Arranca o se engancha a tu sesión por defecto
herdr

Y ya está. herdr levanta (o se conecta a) un servidor en segundo plano. Ese servidor es el dueño de todos tus paneles, pestañas y espacios de
trabajo. Tu terminal es solo un cliente: una ventana hacia el estado que gestiona el servidor. Esta separación cliente-servidor es la que permite
el siguiente truco.

Qué son los workspaces, tabs y panes ¶

herdr organiza el trabajo en tres niveles, y entenderlos te ahorra líos (fuente: documentación oficial de conceptos).

Un workspace (espacio de trabajo) es el contenedor de más alto nivel. Piensa en uno por repositorio, tarea o investigación. Su estado se
calcula a partir de los agentes que contiene, así que con una mirada sabes qué proyecto reclama tu atención.

Un tab (pestaña) es una disposición dentro de un workspace. Sirve para separar vistas: agents, logs, server, review.

Un pane (panel) es un terminal real. herdr pinta la salida, envía la entrada al proceso y conserva el panel aunque el cliente se desconecte.

La diferencia con lo que conoces de tmux es que herdr es mouse-native. Puedes hacer clic en paneles, pestañas y agentes, arrastrar los bordes
para redimensionar y usar menús contextuales con el botón derecho. ¿Prefieres teclado? El prefijo por defecto es ctrl+b, idéntico a tmux, así
que tu memoria muscular sigue valiendo.

Estas son las teclas que cubren el 90% del día a día:

Pulsa prefix+? dentro de herdr y verás todos los atajos activos, incluidos los que hayas remapeado en tu configuración.

Cómo funciona la detección de estado de los agentes ¶

herdr detecta el estado de cada agente leyendo la salida de su panel y lo clasifica en tiempo real en uno de cinco estados, que pinta con color en
la barra lateral. Ese es el corazón del asunto.

Cuando lanzas un agente dentro de un panel (escribes claude, codex, pi o el que uses), herdr lo identifica y empieza a evaluarlo. Los
estados posibles son cinco:

• blocked (bloqueado): el agente necesita input, una aprobación o una decisión tuya.
• working (trabajando): el agente está ejecutándose de forma activa.
• done (hecho): terminó y todavía no lo has mirado.
• idle (en reposo): terminó o espera, y ya lo has visto.
• unknown (desconocido): herdr no puede clasificarlo con confianza.

Cada estado se representa en la barra lateral con colores. Y lo mejor: el estado se propaga hacia arriba. Un agente bloqueado hace que su
panel, su pestaña y su workspace se muestren como bloqueados. Un agente trabajando marca el workspace como activo. Un agente terminado permanece
visible hasta que entras a revisarlo.

Ese “roll-up” es lo que convierte a herdr en un panel de control. Con quince agentes repartidos entre proyectos, no necesitas pasearte por cada
terminal: la barra lateral te dice qué necesita una decisión, qué sigue corriendo y qué está listo para revisar.

💡 Si solo te llevas una idea de este artículo: la ventaja de herdr no es ver más terminales a la vez. Es dejar de mirarlos. El estado sube solo
a la barra lateral y tú vas donde hace falta.

La detección funciona sin configuración para más de quince agentes por defecto, entre ellos Claude Code, Codex, GitHub Copilot CLI, Devin CLI,
Cursor Agent CLI, Pi, OpenCode, Droid, Kimi Code CLI y Qoder CLI (fuente: documentación oficial de
agentes). Gemini CLI y Cline están detectados pero menos probados. Y cualquier agente que corra en terminal funciona como panel normal, aunque sin
las etiquetas de estado automáticas.

Da igual qué agente elijas: si sabes enseñarle una habilidad concreta con un fichero SKILL.md (algo que ya desmenuzamos en las mejores skills
para agentes de IA), herdr lo va a pastorear igual. Esa combinación de
skills más orquestación es la que hace interesante lo que viene a continuación.

Cómo mejorar la detección con integraciones ¶

La detección automática lee la pantalla del panel para clasificar el estado. Funciona, pero herdr distingue dos niveles de precisión según el
agente, y merece la pena conocer la diferencia.

Hay agentes con autoridad de ciclo de vida: cuando instalas su integración, el propio agente reporta su estado mediante hooks o plugins. herdr
usa esos reportes para idle, working y blocked, y no recurre a la lectura de pantalla. Es el caso de Pi, OMP, Kimi Code CLI, OpenCode, Kilo
Code CLI, Hermes Agent y MastraCode.

Hay otros que aportan identidad de sesión: la integración reporta una referencia de sesión nativa para poder restaurar la conversación tras
reiniciar el servidor, pero el estado sigue viniendo de la detección de pantalla. Aquí entran Claude Code, Codex, GitHub Copilot CLI, Devin CLI,
Droid, Qoder CLI y Cursor Agent CLI.

Instalar una integración es un comando:

# Instala la integración de Claude Code
herdr integration install claude

# Comprueba el estado de las integraciones instaladas
herdr integration status

La ventaja práctica de la identidad de sesión es enorme: si el servidor de herdr se reinicia, puede relanzar los paneles de agentes soportados
en su sesión de conversación nativa, no como una shell en blanco. Tu Claude Code vuelve donde lo dejaste.

El truco que lo cambia todo: agentes que controlan herdr ¶

herdr expone una API de socket local que permite a los propios agentes controlar el workspace: crear paneles, dividirlos, leer la salida de otros
paneles, esperar a que un agente termine y lanzar agentes auxiliares. Aquí es donde deja de ser “un tmux con superpoderes” y se convierte en otra
cosa.

Ese socket es un socket Unix en Linux y macOS, y un named pipe en Windows (fuente: documentación oficial de la Socket API). A través de él, no
solo tus scripts, sino los propios agentes pueden pilotar el multiplexor entero.

Para que un agente sepa hacerlo, herdr distribuye un fichero de skill reutilizable. Se instala con una línea:

# Instala la skill de herdr de forma global para los agentes soportados
npx skills add ogulcancelik/herdr --skill herdr -g

El concepto ya lo conoces: un SKILL.md es un paquete de conocimiento que le enseña al agente cómo operar una herramienta concreta. En este caso,
cómo hablar con el socket de herdr cuando la variable HERDR_ENV=1 está presente, es decir, cuando el agente corre dentro de un panel gestionado
por herdr.

¿Qué significa esto en la práctica? Que un agente principal puede abrir dos paneles nuevos, poner un agente en cada uno para investigar dos
enfoques distintos, esperar a que ambos terminen, leer sus conclusiones y darte el veredicto. Sin que toques el teclado.

Esto conecta con una idea que ya rondaba en la guía de Pi y en tantas demos de multiagente: el trabajo del
developer se parece cada vez menos a escribir líneas y cada vez más a dirigir. herdr le da a esa dirección una infraestructura de verdad. El
propio proyecto lo dice sin rodeos en su repositorio: el objetivo a largo plazo es convertirse en “un runtime de agentes real”.

⚠️ Cuidado con la euforia. Que un agente pueda lanzar sub-agentes no significa que debas dejarlo suelto. La skill arranca con una salvaguarda:
si HERDR_ENV=1 no está presente, el agente debe parar y avisar de que no corre dentro de un panel gestionado por herdr. Es una barrera sana, no
un adorno.

Sesiones persistentes, remoto y móvil ¶

Los agentes de herdr siguen corriendo aunque cierres el terminal: el trabajo vive en un servidor en segundo plano, no en tu ventana. Cierras el
portátil, matas el terminal, se cae el SSH… y todo continúa.

El mecanismo es el mismo que ya intuías con la separación cliente-servidor. Cuando te desconectas con ctrl+b q, el servidor y sus procesos
siguen vivos. Para volver, ejecutas herdr de nuevo y recuperas todo. Y si usas integraciones con restauración de sesión, ese estado sobrevive
incluso a un reinicio del servidor (fuente: documentación oficial de estado de sesión). Si quieres terminar de verdad la sesión y sus paneles,
paras el servidor:

# Se desconecta pero deja todo corriendo
ctrl+b q

# Vuelve a engancharse a la sesión
herdr

# Termina la sesión y sus paneles
herdr server stop

Para trabajo remoto tienes dos caminos. El clásico: SSH al servidor y ejecutar herdr allí, como harías con tmux. Y el modo cliente ligero:

# Se conecta por SSH y trae la interfaz a tu terminal local
herdr --remote workbox

En este segundo modo tu herdr local actúa como cliente fino: se conecta por SSH, se engancha al servidor remoto y transmite la interfaz a tu
terminal, conservando tus atajos locales. Útil cuando quieres que la sesión remota se sienta local.

¿Y el móvil? No hay app ni dashboard web. Instalas un cliente SSH en el teléfono, te conectas a la máquina donde corren los agentes y lanzas
herdr. La interfaz se adapta a pantallas estrechas. Ese uso desde el teléfono, con notificaciones cuando un agente reclama input, ya lo habíamos
visto asomar en la comunidad de Agent Teams. Aquí es una capacidad de serie.

herdr frente a tmux: cuándo merece la pena ¶

Cambia de tmux a herdr si tu día a día gira alrededor de varios agentes de IA en paralelo; quédate con tmux si no. Esa es la respuesta corta, y
merece un matiz.

tmux es un multiplexor de propósito general, sólido y probado hasta el aburrimiento. Si encadenas comandos con pipes y ya tienes tu .tmux.conf
afinado, tienes un flujo que funciona y no hay drama en seguir con él. El matiz aparece cuando sumas agentes: ahí tmux te obliga a inspeccionar
panel por panel.

Aquí va una comparación honesta de dónde se separan:

La lectura es sencilla. Si tu día a día no gira alrededor de varios agentes en paralelo, tmux te sobra y no necesitas cambiar nada. Si te pasas el
día pastoreando agentes y tu problema real es saber cuál necesita algo de ti, herdr resuelve exactamente eso y de una forma que tmux nunca fue
diseñado para atacar.

Qué dicen los números y en qué punto está el proyecto ¶

herdr no es un experimento de fin de semana. El repositorio supera las 14.000 estrellas en GitHub y viene creciendo a un ritmo notable desde
que apareció en las listas de tendencias (fuente: repositorio oficial). El mantenimiento está vivo: hay reportes de una latencia mediana de
respuesta a issues y pull requests de menos de una hora (fuente: GitGenius, julio de 2026).

Está escrito en Rust por el desarrollador ogulcancelik (Oğulcan Çelik) y se distribuye con licencia AGPL-3.0-or-later, con la opción de
licencia comercial para organizaciones que no puedan cumplir la AGPL. Soporta Linux y macOS de forma completa, con Windows en beta.

Conviene poner esto en contexto. Según la Stack Overflow Developer Survey 2025, el 84% de los developers ya usa o planea usar herramientas de IA,
y un 51% las emplea a diario (Stack Overflow, 2025). Con esa adopción, herramientas que organicen el caos multiagente dejan de ser un lujo para
convertirse en infraestructura. La encuesta de JetBrains Developer Ecosystem 2025 apunta en la misma dirección: el 62% de los desarrolladores
depende de al menos un asistente o agente de código (JetBrains DevEco 2025).

🛡️ Antes de casarte con herdr, ten presente que es una herramienta de un solo mantenedor y sin SLA de soporte empresarial. Para uso individual y
de equipo pequeño es fantástico. Para un entorno corporativo con requisitos de SSO, RBAC o auditoría, evalúa con calma. La juventud del proyecto
es a la vez su gracia y su riesgo.

De pastorear a arquitectar

Ya pastoreas la flota; ahora aprende a construirla

herdr te da la capa de infraestructura para pastorear agentes. Esta masterclass te da la otra mitad: los seis niveles de arquitectura (tools, guardarraíles, memoria, skills, MCP y orquestación) para que tus agentes no se descontrolen cuando los sueltas en paralelo.

Ver la masterclass →

Acceso con suscripción Web Reactiva Premium · Sin permanencia

Un flujo de trabajo real de principio a fin ¶

Vamos a bajarlo a tierra con una secuencia concreta que puedes reproducir hoy.

1. Arrancas herdr desde la raíz de tu proyecto con herdr.
2. Creas un workspace por cada repositorio en el que estés trabajando.
3. En el primer workspace abres una pestaña y lanzas Claude Code para implementar una feature.
4. Divides el panel en vertical con prefix+v y en el nuevo panel ejecutas tu servidor de desarrollo para verlo en vivo.
5. En un segundo workspace pones a Codex a revisar un pull request y a Pi a investigar una migración.
6. Te vas a por un café. La barra lateral te avisa con colores y sonido cuando alguno se bloquea o termina.
7. Vuelves, miras qué reclama tu atención, resuelves esa aprobación pendiente y dejas que el resto siga.

Si además instalas la skill, puedes pedirle al agente principal que orqueste parte de ese trabajo por ti: que lance dos sub-agentes para comparar
dos enfoques de una refactorización y te traiga el más limpio. La delegación deja de ser un discurso y se vuelve un comando.

Ese salto (de “abro cinco terminales y rezo” a “el estado sube solo y delego lo repetitivo”) es el que justifica dedicarle una tarde a probarlo.
Con lo que hemos ido aprendiendo sobre agentes en terminal, herdr encaja como la capa que faltaba entre tú y tu flota de agentes.

Preguntas frecuentes sobre herdr ¶

¿Qué es herdr exactamente?

herdr es un multiplexor de terminal escrito en Rust y con conciencia de agentes de IA. Divide tu terminal en paneles y persiste sesiones como
tmux, pero además detecta si cada agente está bloqueado, trabajando o terminado y lo muestra en una barra lateral.

¿En qué se diferencia de tmux?

tmux es un multiplexor de propósito general que trata todos los paneles por igual, sin saber qué ocurre dentro. herdr lee el estado de los
agentes, ofrece soporte de ratón de serie, restaura sesiones de agente y permite que los agentes controlen el multiplexor por su API de socket.

¿Cómo se instala herdr?

En Linux y macOS, con curl -fsSL https://herdr.dev/install.sh | sh. También está disponible con brew install herdr, mise use -g herdr y Nix.
En Windows existe una beta preview mediante PowerShell.

¿Qué agentes soporta herdr?

Detecta de forma automática más de quince agentes, entre ellos Claude Code, Codex, GitHub Copilot CLI, Devin CLI, Cursor Agent CLI, Pi, OpenCode,
Droid, Kimi Code CLI y Qoder CLI. Cualquier agente que corra en terminal funciona como panel, aunque sin etiquetas de estado automáticas.

¿Los agentes siguen corriendo si cierro el terminal?

Sí. herdr corre como un servidor en segundo plano. Al desconectarte con ctrl+b q, los procesos siguen vivos y recuperas todo ejecutando herdr
de nuevo. Las sesiones sobreviven a reinicios del servidor si usas integraciones con restauración de sesión.

¿Puedo usar herdr en remoto o desde el móvil?

Sí. Puedes hacer SSH al servidor y ejecutar herdr allí, o usar herdr --remote <host> como cliente ligero. Desde el móvil basta un cliente SSH:
la interfaz se adapta a pantallas estrechas.

¿Qué es la API de socket de herdr?

Es un socket local que permite a scripts y a los propios agentes controlar herdr: crear workspaces y paneles, leer salidas, esperar a otros
agentes y lanzar auxiliares. Es lo que convierte a herdr en algo cercano a un runtime de agentes.

¿Necesito saber tmux para usar herdr?

No. herdr es mouse-native: puedes hacer clic, arrastrar y dividir sin memorizar atajos. Si vienes de tmux, el prefijo ctrl+b y el modelo de
paneles te resultarán familiares.

¿herdr es gratis?

Es open source bajo licencia AGPL-3.0-or-later, gratuito para uso personal y comercial. Existen licencias comerciales para organizaciones que no
puedan cumplir los términos de la AGPL.

¿Es herdr adecuado para un entorno empresarial?

Depende. Para uso individual y equipos pequeños es sólido y de instalación inmediata. Al ser un proyecto de un solo mantenedor sin SSO, RBAC, logs
de auditoría ni SLA de soporte, conviene evaluarlo con cuidado en entornos corporativos exigentes.

Fuentes ¶

• ogulcancelik, “herdr — agent multiplexer that lives in your terminal”
• Documentación oficial de herdr
• herdr, “Agents — detección y estados de agentes”
• herdr, “Concepts — workspaces, tabs y panes”
• herdr, “Agent skill file”
• herdr, “Socket API”
• Stack Overflow, “Developer Survey 2025”
• JetBrains, “The State of Developer Ecosystem 2025”

🧨 Última oprtunidad para recibir la dinamita que mereces sobre programación con IA el próximo domingo: Suscríbete gratis a Web Reactiva en https://webreactiva.com/newsletter