5. 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.

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.

Arriba a la derecha de la lista (la flecha roja) está cómo se ordenan los agentes. Clic encima y cambia entre los dos modos:

• grouped: agrupados por espacio de trabajo y pestaña, en el mismo orden que la lista de espacios. Es el modo por defecto.
• priority: primero los que te necesitan. Van blocked, luego done, working e idle y, dentro de cada estado, el que ha cambiado más recientemente arriba.

En cuanto tengas más de dos o tres agentes, pon priority: el que tienes que atender está siempre el primero.

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.

La configuración está en ~/.config/herdr/config.toml. Lo que merece la pena tocar es qué enseña la lista de agentes de la barra lateral: de serie, el espacio de trabajo y el tipo de agente. Con dos agentes en el mismo espacio, las dos filas salen iguales (reservas-api / claude) y no sabes cuál es cuál.

Cada array de rows es una línea de la entrada de cada agente, y cada elemento es un token que herdr sustituye por su valor. Para que se vea el nombre del panel:

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

El nombre se le pone al panel con el botón derecho → Rename pane (en la sección 2 está con capturas). 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

Los tokens de las filas de agentes:

• state_icon: icono de color con el estado del agente.
• state_text: el estado en texto (idle, working, blocked, done).
• machine: la máquina; solo sale si tienes varias conectadas.
• workspace: el espacio de trabajo.
• tab: la pestaña.
• pane: el nombre del panel.
• agent: el agente (claude, opencode…).
• terminal_title: el título que el agente pone a la terminal, tal cual.
• terminal_title_stripped: el mismo título sin el icono o spinner del principio. Es el que se usa: el título de Claude Code empieza por un spinner que cambia sin parar.
• $nombre: un valor propio que publica un script o un plugin.

Un valor que no existe desaparece con su separador ·, y una fila sin ningún valor no se dibuja.

rows_by_agent da otra disposición a un agente concreto, por ejemplo para ver el título que pone Claude Code a la terminal:

[ui.sidebar.agents.rows_by_agent]
claude = [
  ["state_icon", "pane", "tab"],
  ["terminal_title_stripped"],
  ["workspace", "agent"],
]

Un token también puede ir con estilo, en vez del nombre suelto: { token = "terminal_title_stripped", fg = "#89b4fa", dim = true }.

Las filas de la lista de espacios van en [ui.sidebar.spaces], con estos tokens:

• state_icon y state_text: el estado conjunto de los agentes del espacio.
• workspace: el espacio de trabajo.
• branch: la rama de Git.
• git_status: commits por delante y por detrás.
• $nombre: un valor propio.

ui.window_title es el título que herdr pone a la ventana de tu terminal. Aquí los tokens van entre llaves: {hostname}, {workspace}, {tab}, {pane} y {terminal_title}, que ya sale sin el spinner.

[ui]
window_title = "{workspace}: {pane}"
sidebar_width = 40        
sidebar_max_width = 60    

Por defecto sidebar_max_width=36 así que si quieres un valor de sidebar_width mayor de 36 debes poner ambos valores

• herdr config check: comprueba el fichero y dice qué está mal.
• menu → reload config en la barra lateral, o Ctrl+b R: recarga sin parar a los agentes.

• Config
• Config reference

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.

Orca hace lo mismo que herdr (varios agentes a la vista, un worktree de Git por agente y aviso de cuál te necesita), pero añade piezas de un IDE que herdr no tiene:

• Editor: un editor al estilo de VS Code para abrir y retocar ficheros sin salir.
• Revisión del diff: se ve lo que ha cambiado cada agente y se comenta cualquier línea; los comentarios le llegan al agente para que los corrija.
• Navegador integrado: para ver la web que está haciendo el agente y señalarle el elemento que hay que cambiar.
• GitHub: las PR y las issues del proyecto, y abrir un worktree directamente desde una issue.

Orca es probablemente por donde van a ir los IDEs: ya no son el sitio donde se escribe código, sino donde se ejecutan agentes y se revisan sus resultados. Por eso se parece a un IDE con menos cosas (sobra casi todo lo que sirve para teclear código) al que se le suma lo que tiene herdr.

De todas formas, la frontera no es fija: depende de los plugins de cada uno. Un IDE con plugins para agentes se acerca a Orca, y a herdr ya se le pueden instalar plugins que le añaden cosas de Orca. Por ejemplo, herdr-reviewr enseña en un panel el diff del agente y le manda los comentarios que pongas en cada línea, como la revisión del diff de Orca:

herdr plugin install persiyanov/herdr-reviewr

• herdr.dev: web oficial.
• Documentación: guía y referencia de órdenes y configuración.
• Repositorio: código y versiones publicadas.
• Orca: repositorio de Orca, con descargas para Linux, macOS y Windows.