herdr

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: la barra lateral te dice cuál te necesita.

• 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 o con Ctrl+b R. 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:

○ implementa
  reservas-api · claude
○ revisa
  reservas-api · 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.

• 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-web --label tienda-web

Un worktree de Git es una carpeta más, así que en herdr es un espacio de trabajo más. Si se crea desde herdr, además cuelga del espacio del proyecto y los worktrees del repositorio salen agrupados. Es lo normal para tener un agente por spec, cada uno en su rama.

Botón derecho sobre el espacio del proyecto (la opción solo sale si su carpeta es un repositorio Git):

• New worktree: se escribe el nombre de la rama y herdr crea la rama, el worktree y su espacio de trabajo de una vez.
• Open worktree…: para un worktree que ya existe; se elige de la lista.

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:

Con el skill de herdr, el agente (OpenCode, Claude Code…) puede manejar herdr por ti. Se instala así:

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.

Lo que hace útil a herdr es la lista de agentes, abajo a la izquierda bajo agents: están todos los agentes que tienes en marcha, de todos los espacios de trabajo y pestañas, y de un vistazo sabes cuál necesita tu atención. Para llegar hasta él no hay que buscar su espacio ni su pestaña: clic en el agente y estás en su panel.

Cada agente está en un estado, marcado con un punto de color, que dice si te necesita:

Cuando un punto se pone rojo o verde azulado, 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.

Los agentes no corren dentro de la ventana de herdr, sino en un proceso aparte (el servidor de herdr), así que 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.

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.