herdr es un multiplexor de terminal pensado para agentes: como tmux, pero sabe qué agente corre en cada panel y en qué estado está. No sustituye a OpenCode ni a Claude Code: los ejecuta dentro de sus paneles y te avisa de cuál te necesita. Es de código abierto, un único binario y funciona en la terminal que ya uses.

Sirve para lo que pasa en cuanto trabajas con más de un agente a la vez: uno implementando, otro revisando la spec y un tercero pasando los tests, cada uno en su panel, y tú sin tener que ir mirándolos uno a uno. Por eso es importante que herdr enseña en la barra lateral la lista de agentes, para saber cuál requiere nuestra atención.

• Linux y macOS

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

• Windows

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Desde la carpeta del proyecto:

cd mi-proyecto
herdr

La primera vez sale un asistente que propone instalar las integraciones de los agentes que encuentra en el PATH: si tienes OpenCode y Claude Code, instala las dos. Di que sí: qué son está en la sección 5.

Se abre la interfaz: a la izquierda la barra lateral con los espacios de trabajo y los agentes, y a la derecha el panel con una shell. En esa shell se arranca el agente como siempre:

opencode

herdr lo detecta solo, sin configurar nada. Vale igual con claude, codex, cursor-agent o copilot.

herdr update

Los agentes que estén trabajando no se paran al actualizar: el servidor viejo sigue vivo hasta que lo reinicias. Al terminar, herdr update dice qué servidor sigue en la versión anterior y la orden para reiniciarlo.

La lista de agentes de la barra lateral enseña, de serie, el espacio de trabajo y el tipo de agente. Con dos agentes en el mismo espacio, las dos filas salen iguales (daw-proyecto / claude) y no sabes cuál es cuál.

Se arregla poniendo nombre a cada panel y haciendo que la lista lo muestre. En ~/.config/herdr/config.toml:

[ui.sidebar.agents]
rows = [
  ["state_icon", "machine", "pane", "tab"],
  ["workspace", "agent"],
]

Se recarga sin parar a los agentes con menu → reload config en la barra lateral. Desde la terminal, herdr server reload-config solo recarga el servidor, y esta parte la dibuja la ventana.

El nombre se le pone al panel con el botón derecho → Rename pane (en la sección 3 está con capturas).

El nombre sale en el borde del panel y en la primera línea de la lista; debajo, el espacio y el agente:

○ daw-proyecto
  daw-proyecto · claude
○ sdd
  daw-proyecto · claude

herdr arranca un servidor en segundo plano que es el dueño de los paneles, y la ventana que ves es solo un cliente conectado a él. Por eso:

• Cerrar la terminal no para nada: los agentes siguen trabajando.
• Para salir a propósito dejando todo en marcha, Ctrl+b q.
• Para volver, otra vez:

herdr

• Para acabar de verdad y parar todos los paneles:

herdr server stop

Como el servidor sigue vivo, puedes dejar a un agente implementando en el ordenador del instituto, entrar por ssh desde casa o desde el móvil, ejecutar herdr y ver por dónde va.

herdr no tiene una orden para guardar: guarda solo y continuamente la sesión entera (espacios de trabajo, pestañas, paneles, sus nombres y sus carpetas) en ~/.config/herdr/session.json, y la vuelve a montar al arrancar.

Para tener la distribución de cada proyecto guardada aparte y cargarla cuando toque, se usa una sesión con nombre: otro herdr independiente, con sus propios espacios y paneles.

• Crear la sesión, o volver a ella si ya existe:

herdr --session sdd

• Se montan en ella los espacios, pestañas y paneles del proyecto. No hay que guardar nada.
• Cerrarla parando sus paneles. Queda guardada:

herdr session stop sdd

• Cargarla otro día. Vuelve la misma distribución en las mismas carpetas, y los agentes con su conversación si tienen la integración (sección 5):

herdr --session sdd

• Ver las sesiones que hay y cuáles están en marcha:

herdr session list

• Borrar una que ya no se usa. Tiene que estar parada:

herdr session delete sdd

herdr organiza los terminales en tres niveles:

Es decir: el espacio de trabajo es el proyecto, la pestaña es una pantalla de ese proyecto y los paneles son los trozos en los que partes esa pantalla.

Todo se hace con el ratón: clic para cambiar de panel o de espacio, arrastrar el borde para redimensionar, botón derecho para dividir o crear pestañas, y seleccionar texto ya lo copia, sin Ctrl+C.

Los ejemplos son dos proyectos: reservas-api (una API REST) y tienda-web (su web). En cada pareja de capturas, la primera marca con un círculo rojo dónde se pincha y la segunda enseña cómo queda.

Se pulsa new, abajo en la lista de spaces.

El espacio nuevo se abre en la misma carpeta y toma el nombre de la carpeta en la que esté su shell: al hacer cd ../tienda-web, pasa a llamarse tienda-web.

Se pulsa el + que hay a la derecha de las pestañas.

Pide el nombre antes de crearla. Aquí, tests.

Botón derecho sobre la pestaña → Rename.

Se escribe el nombre y save. La pestaña 1 pasa a llamarse agentes.

Botón derecho dentro del panel → Split right.

El panel se parte en dos, uno al lado del otro.

Botón derecho dentro del panel → Rename pane.

El nombre sale en el borde de arriba del panel. Aquí, implementa y revisa.

Botón derecho dentro del panel → Split down.

El panel se parte en dos, uno encima del otro. Aquí, unitarios arriba y logs abajo.

Al arrancar, herdr abre un espacio de trabajo en la carpeta desde la que lo lanzas. Para trabajar en otro proyecto a la vez, se crea otro espacio:

• Crear un espacio de trabajo: clic en new, al pie de la lista de espacios de la barra lateral.
• Cambiarle el nombre: botón derecho sobre el espacio, Rename.
• Cerrarlo, con todas sus pestañas y paneles: botón derecho, Close.

herdr workspace create --cwd ~/proyectos/tienda --label tienda

Es lo que diferencia a herdr de tmux. Cada agente aparece en la barra lateral con su estado:

El estado sube: un agente blocked marca como bloqueados su pestaña y su espacio de trabajo, así que con un vistazo a la barra lateral sabes qué proyecto te necesita.

Para saltar directamente al agente que te interesa, Ctrl+b g abre una lista con todos los agentes y terminales; dentro de ella, b deja solo los bloqueados.

Sin integración, herdr ya ve los agentes: los reconoce por el proceso y lee su pantalla para saber si están trabajando o esperando. La integración es un pequeño añadido que herdr escribe en la configuración del propio agente para que el agente le cuente cosas directamente por su socket, sin que herdr tenga que adivinarlas.

Lo que se gana:

• Recuperar la conversación: el agente le dice a herdr en qué sesión está. Si el servidor se reinicia (reinicio del ordenador, herdr server stop), herdr vuelve a abrir el agente con esa misma conversación, en lugar de una shell vacía. Esto lo hacen todas las integraciones.
• Estado más fiable: en algunos agentes, OpenCode entre ellos, el agente informa él mismo de si está working o blocked. Leer la pantalla falla cuando sale una pregunta con un aspecto que herdr no conoce; el aviso del propio agente, no.

Qué escribe en cada agente:

Los plugins de OpenCode están en su tema y los hooks se verán en el tema 9; aquí basta con saber que herdr los instala y los quita solo.

Las órdenes, por si no las instalaste en el asistente o instalas un agente después:

• Instalar la integración de OpenCode:

herdr integration install opencode

• La de Claude Code:

herdr integration install claude

• Ver cuáles tienes instaladas y si están desactualizadas:

herdr integration status

• Quitarla, si ya no la quieres. Borra lo que instaló y deja el resto de tu configuración intacta:

herdr integration uninstall opencode

Si uno de nuestros workspaces es un worktree de Git , simplemente es como un nuevo workspace en Herdr. Podemos hacer que todos los worktree de git aparezcan agrupados si abrimos el worktree con el menú de Open worktree… del workspace de Herdr.

Para ello pulsamos con el botón derecho sobre el espacio del proyecto → Open worktree…, y se elige el worktree de la lista. La opción solo sale si la carpeta del espacio es un repositorio Git.

Cada worktree es un espacio de trabajo completo, con sus pestañas y paneles, que en la lista de espacios cuelga del proyecto. Aquí, login y pagos de reservas-api:

Lo siguiente que podemos hacer es que desde claude code o opencode podamos decirle que queremos hacer cosas en herdr. Lo único que hay que hacer es añadir a nuestro claude code o opencode el skill para manejar herdr.

npx skills add herdrdev/herdr --skill herdr -g

A partir de ahí, desde OpenCode o claude code dentro de herdr se le puede pedir que abra paneles, lance órdenes en ellos, lea su salida y espere a que terminen. Por ejemplo:

• Lanzar los tests en otro panel sin quitarte el foco:

en herdr, abre un panel abajo, lanza npm test y avísame cuando acabe

• Leer la salida de otro panel y actuar sobre ella:

lee en herdr la salida del panel de los tests y arregla lo que falle

• Arrancar otro agente que revise el trabajo:

en herdr, abre un panel a la derecha con otro opencode que revise specs/login/design.md contra requirements.md, espera a que termine y resúmeme lo que encuentre

Todo lo que hace queda en sus paneles, a la vista, y puedes intervenir en cualquier momento.

Ctrl+b pone herdr en modo prefijo: la siguiente tecla que pulses no va al panel, sino a herdr, que la toma como una orden. Se pulsa Ctrl+b, se suelta y se pulsa la tecla de la orden. Hecha la orden, se vuelve al panel.

Por ejemplo, c es «pestaña nueva»: pulsar Ctrl+b, soltar, y pulsar c.

• herdr.dev: web oficial.
• Documentación: guía y referencia de órdenes y configuración.
• Repositorio: código y versiones publicadas.