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 pregunta si quieres instalar las integraciones de los agentes que encuentra en el PATH. Di que sí: sirven para que herdr sepa en qué estado está cada agente. Si no las instalaste o instalas un agente después, están en los ajustes (Ctrl+b s) → integrations; tras instalarla, sal del agente y vuelve a lanzarlo para que la cargue.

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 2 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 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

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.

Puedes cerrar herdr cuando quieras, aunque la terminal avise de que hay un proceso en ejecución: los agentes siguen trabajando y, al volver a ejecutar herdr, todo está como lo dejaste. Si reinicias el ordenador vuelven los espacios de trabajo, pestañas y paneles, pero los agentes solo recuperan su conversación si tienen la integración.

Abajo a la izquierda, bajo agents, herdr enseña todos los agentes que tienes en marcha, de todos los espacios de trabajo y pestañas, cada uno con un punto de color que dice en qué estado está:

Haciendo clic en un agente de la lista vas directamente a su panel, esté en el espacio de trabajo y la pestaña que esté. Con el teclado, Ctrl+b g abre la misma lista; dentro de ella, b deja solo los bloqueados.

Esa es la verdadera ventaja de herdr frente a tmux: lanzas varios agentes, no tienes que ir mirándolos uno a uno y te basta un vistazo a la lista para saber cuál requiere tu atención. Cuando un punto se pone rojo o azul, clic y a atenderlo.

El estado también sube a la lista de espacios de trabajo: un agente blocked marca como bloqueados su pestaña y su espacio, así que ves qué proyecto te necesita aunque tengas muchos.

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.