¿Cómo gestionar múltiples agentes de codificación de IA en Linux? Probando HERDR

Si ejecutas varios agentes de codificación con IA al mismo tiempo, probablemente te has enfrentado a este problema: demasiadas pestañas de terminal, sin una forma clara de saber qué agente está esperando tu entrada, y cambiando constantemente entre pestañas solo para comprobar su estado.

Hace unos meses, empecé a usar Claude Code en una terminal y Codex en otra, y en una semana ya tenía cinco pestañas abiertas. Algunas estaban inactivas esperándome, pero no podía distinguir cuáles sin abrir cada pestaña individualmente.

Probé a usar barras de estado de tmux con scripts personalizados para rastrear paneles inactivos, y funcionó hasta cierto punto, pero requería tiempo de configuración y aún no podía saber si un agente estaba bloqueado o trabajando activamente. Ese es exactamente el problema que herdr está diseñado para resolver.

herdr es un multiplexor de terminal creado específicamente para ejecutar agentes de codificación con IA, no solo sesiones de shell normales. Es un binario único en Rust, desarrollado por Ogulcan Celik, y ha sido uno de los proyectos más populares en GitHub desde finales de junio de 2026, superando las 10.000 estrellas en poco tiempo.

Si has usado tmux antes, herdr te resultará familiar, con la diferencia de que herdr monitorea lo que hacen tus agentes de IA y muestra de un vistazo cuáles están trabajando, bloqueados o han terminado.

¿Qué hace herdr exactamente?

En esencia, herdr es un gestor de sesiones que se ejecuta en tu terminal y mantiene tus procesos en ejecución incluso si te desconectas, de forma similar a tmux o screen.

Puedes crear espacios de trabajo, dividirlos en paneles, ejecutar diferentes comandos en cada panel y desconectarte de la sesión cuando quieras. El servidor continúa ejecutándose en segundo plano, por lo que cerrar tu portátil no detendrá tus sesiones.

Lo que hace diferente a herdr es su conciencia integrada de los agentes de codificación con IA: detecta herramientas como Claude Code, Codex, Amp, Devin CLI y otros agentes examinando los nombres de los procesos y los patrones de salida de la terminal, y luego agrupa cada panel en uno de cuatro estados que se muestran en la barra lateral: bloqueado, trabajando, terminado o inactivo.

No necesitas configurar hooks ni escribir scripts personalizados. Simplemente inicias un agente en un panel y herdr detecta automáticamente su estado actual.

Cada panel es también una terminal real, no simulada. Esto es más importante de lo que parece. Muchos gestores gráficos de agentes redibujan la salida de la terminal dentro de su propia interfaz, y las aplicaciones de terminal a pantalla completa a menudo no se muestran correctamente en esos entornos. herdr evita este problema porque no es una aplicación que envuelve una terminal: es la terminal.

Comparativa rápida: herdr vs tmux

Requisitos previos

Antes de instalar herdr, asegúrate de tener lo siguiente:

• Un sistema Linux con una distribución razonablemente reciente. Ubuntu, Debian, Fedora, RHEL, Rocky Linux y Arch Linux funcionan bien porque herdr se distribuye como un binario estático.
• Un emulador de terminal que ya uses. herdr se ejecuta dentro de tu terminal existente y no la reemplaza.
• curl instalado, necesario para descargar y ejecutar el script de instalación.
• Al menos un agente de codificación con IA, como Claude Code, Codex o Amp, si quieres usar las funciones de detección de herdr.
• Opcional: acceso SSH a un servidor remoto si planeas ejecutar agentes en máquinas remotas.

No necesitas privilegios de root o administrador para una instalación estándar. El script de instalación coloca el binario de herdr en tu ruta de usuario en lugar de directorios del sistema.

Paso 1: ¿Cómo instalar herdr?

La forma más rápida de instalar herdr en Linux es usando el script de instalación oficial:

curl -fsSL https://herdr.dev/install.sh | sh

Verás una salida similar a la siguiente (el texto exacto puede variar):

Installing herdr...
Downloading latest release...
Installing to ~/.local/bin/herdr
Done!

Esto es lo que hace el comando:

• curl -fsSL descarga el script de instalación silenciosamente, sigue redirecciones y se detiene si la descarga falla.
• | sh envía el script descargado directamente al shell y lo ejecuta.

Después de la instalación, verifica que herdr esté disponible en tu PATH:

herdr --version

Si ves un error de “comando no encontrado”, puede que tu shell no haya detectado ~/.local/bin todavía. Añádelo a tu PATH en ~/.bashrc o ~/.zshrc y recarga el shell.

Paso 2: ¿Cómo lanzar herdr y entender la interfaz?

Inicia herdr ejecutando:

herdr

La primera vez que lo ejecutas, herdr inicia un proceso de servidor en segundo plano y abre un espacio de trabajo con un solo panel. A partir de este momento, todo sucede dentro de esa ventana de terminal. Puedes usar tanto el teclado como el ratón para navegar.

Al igual que tmux, herdr utiliza un sistema de teclas con prefijo. Pulsa Ctrl+b, suéltalo y luego pulsa otra tecla para realizar una acción. Esto evita que herdr intercepte pulsaciones que tu shell o los agentes de IA puedan necesitar.

Algunos atajos de teclado útiles son:

• Ctrl+b, luego Shift+N – Crear un nuevo espacio de trabajo.
• Ctrl+b, luego c – Abrir una nueva pestaña en el espacio de trabajo actual.
• Ctrl+b, luego v o - – Dividir el panel actual vertical u horizontalmente.
• Ctrl+b, luego w – Cambiar entre espacios de trabajo.
• Ctrl+b, luego q – Desconectarse de la sesión manteniendo todo en ejecución.
• Ctrl+b, luego ? – Mostrar la lista completa de atajos de teclado.

También notarás una barra lateral en el lado izquierdo que enumera todos los paneles abiertos. Aquí es donde la función de conciencia de agente de herdr se vuelve útil: muestra el estado de tus agentes de IA una vez que están en sus propios paneles.

Paso 3: ¿Cómo ejecutar tu primer agente dentro de herdr?

Dentro de cualquier panel, inicia tu agente de codificación con IA tal como lo harías normalmente. Por ejemplo, para iniciar Claude Code, ejecuta:

claude

herdr detecta automáticamente el proceso observando su nombre y la salida de la terminal, y comienza a rastrear el estado del agente, mostrándolo en la barra lateral. A medida que cambia la actividad del agente, verás el indicador de estado actualizarse en tiempo real.

Por ejemplo:

🟡 pane-1  claude   working
🔴 pane-2  codex    blocked
🔵 pane-3  amp      done

Los indicadores de estado significan:

Esto es lo que hace útil a herdr. En lugar de cambiar entre múltiples pestañas de terminal para averiguar qué agente necesita tu atención, simplemente miras la barra lateral y ves el estado de todos los agentes a la vez.

Paso 4: ¿Cómo dividir paneles y construir un espacio de trabajo?

En el uso real, a menudo querrás varios paneles abiertos al mismo tiempo. Por ejemplo, podrías tener un agente de IA en un panel, un visor de registros en otro y un shell disponible para comandos rápidos.

Pulsa Ctrl+b, luego v para dividir el panel actual verticalmente. En el nuevo panel, puedes iniciar otro agente o ejecutar un comando de monitoreo como:

tail -f /var/log/syslog

Puedes redimensionar los paneles arrastrando el borde con el ratón. Si prefieres el teclado, pulsa Ctrl+b seguido de las teclas de flecha para ajustar el diseño.

Para mantener la organización:

• Pulsa Ctrl+b, luego c para crear una nueva pestaña para paneles relacionados en el mismo proyecto.
• Pulsa Ctrl+b, luego Shift+N para crear un espacio de trabajo separado para tareas completamente diferentes.

Un enfoque práctico es mantener un espacio de trabajo por proyecto, con su propio conjunto de agentes de IA y un panel de shell dedicado para comandos como operaciones Git o tareas de administración del sistema.

Paso 5: ¿Cómo desconectarse, reconectarse y mantener vivos a los agentes?

Cuando necesites cerrar tu terminal o alejarte de tu computadora, puedes desconectarte de tu sesión de herdr sin detener nada de lo que se ejecuta en su interior.

Para desconectarse, pulsa:

Ctrl+b, luego q

Todos tus paneles siguen ejecutándose en segundo plano. Cualquier agente de IA, sesión de shell o comando de monitoreo continúa exactamente como estaba.

Cuando estés listo para volver, simplemente inicia herdr de nuevo:

herdr

Esta es una de las mayores ventajas de herdr sobre las pestañas de terminal normales. Dado que la sesión se ejecuta en el servidor de herdr en segundo plano, tus agentes y procesos de terminal permanecen vivos incluso después de cerrar la ventana de terminal, y se pueden restaurar al reconectarte.

Paso 6: ¿Cómo ejecutar herdr en un servidor remoto?

Si ejecutas agentes de codificación con IA en un VPS o servidor remoto, herdr puede conectarse a ese servidor manteniendo tu terminal local como cliente. Los propios agentes continúan ejecutándose en la máquina remota.

Conéctate a un servidor remoto con:

herdr --remote ssh://tu@tuservidor:2222

Esto es particularmente útil si tu flujo de trabajo implica pegar capturas de pantalla o imágenes en un agente de IA. Las sesiones SSH tradicionales combinadas con tmux a menudo tienen problemas para manejar el pegado de imágenes correctamente, mientras que el modo remoto de herdr está diseñado para preservar esa funcionalidad.

Si tu servidor SSH usa un puerto no estándar, es posible que necesites abrir ese puerto en el firewall del servidor.

En sistemas Ubuntu o Debian:

sudo ufw allow 2222/tcp

En sistemas RHEL o Rocky Linux:

sudo firewall-cmd --add-port=2222/tcp --permanent
sudo firewall-cmd --reload

Estos comandos hacen lo siguiente:

• sudo ejecuta el comando con privilegios de administrador, necesarios para modificar reglas de firewall.
• ufw allow 2222/tcp o firewall-cmd --add-port=2222/tcp abre el puerto TCP 2222, permitiendo conexiones SSH entrantes en ese puerto.

También puedes dar un nombre a una sesión remota y reconectarte a ella más tarde sin escribir la URL SSH completa cada vez:

herdr --remote workbox

¿Cómo mantener herdr actualizado?

Si instalaste herdr usando el script de instalación oficial, puedes actualizarlo con el actualizador integrado:

herdr update

Si instalaste herdr usando un gestor de paquetes, actualízalo a través de ese gestor, ya que herdr update solo funciona para instalaciones basadas en script.

En Ubuntu o Debian con Homebrew:

brew upgrade herdr

En RHEL o Rocky Linux con mise:

mise upgrade herdr

Solución de problemas comunes

herdr no detecta mi agente de IA

Verifica que el agente esté en la lista de herramientas compatibles. Si es un agente personalizado, es posible que herdr no lo reconozca automáticamente. También asegúrate de que el proceso se esté ejecutando en el panel (no en un subshell anidado).

La barra lateral no se actualiza

Reinicia la sesión de herdr (sal y vuelve a entrar). A veces, después de una actualización, puede ser necesario reiniciar el servidor en segundo plano con herdr kill-server y luego iniciar de nuevo.

No puedo pegar imágenes en modo remoto

Asegúrate de que tu terminal local soporte el protocolo de pegado de imágenes (por ejemplo, iTerm2, kitty o WezTerm). También verifica que la conexión SSH esté usando la versión correcta del protocolo.

El comando herdr no se encuentra después de la instalación

Revisa si ~/.local/bin está en tu PATH. Si no, añade export PATH="$HOME/.local/bin:$PATH" a tu ~/.bashrc o ~/.zshrc y recarga con source ~/.bashrc.

Conclusión

En este punto, tienes herdr instalado, ejecutando tu primer agente con seguimiento de estado en vivo en la barra lateral, paneles divididos en un espacio de trabajo real, y una forma de desconectarte y reconectarte sin perder nada, ya sea en tu propia máquina o en un servidor remoto a través de SSH. Eso cubre el núcleo de lo que la mayoría de la gente necesita a diario.

Prueba ahora mismo a dividir un panel y ejecutar dos agentes diferentes lado a lado: uno trabajando en una rama de características y otro revisando una pull request. Observa la barra lateral a medida que cambian entre working y blocked. Ese es el momento en que el valor de herdr hace clic: cuando dejas de cuidar pestañas de terminal y empiezas a leer el estado de un vistazo.

Me interesa saber cómo encaja esto en configuraciones donde los agentes ya se ejecutan dentro de pipelines de CI o en instancias efímeras en la nube en lugar de un VPS persistente. Si has intentado conectar la API de sockets de herdr a algo así, me gustaría saber cómo funcionó.