Usos de Herdr: 7 recetas reales para tus agentes de IA
Usos de Herdr para agentes de IA: 7 recetas con comandos reales, desde revisar PRs en paralelo hasta avisos y servidores remotos, y cuándo no merecen la pena.

Imagina que llevas un mes con Herdr y solo conoces uno de sus usos: lo abres, lanzas un Claude Code en un panel y trabajas igual que antes, solo que con una barra lateral más bonita.
Es lo que pasa con las navajas suizas: usas la hoja grande y nunca abres el resto. Y en Herdr las piezas que no usas son las que ahorran tiempo.
Aquí van los usos de Herdr para agentes de IA que casi nadie abre: siete recetas con los comandos exactos y el aviso de cuándo no compensan.
En corto: los usos de Herdr que más rinden están en su CLI y su configuración, no en la barra lateral: agentes en un servidor que revisas por SSH, un worktree con un agente por cada PR, avisos cuando acaba una suite y recuperar el layout tras un reinicio. Son siete recetas, cada una con su comando y el caso en el que no compensa. Todo está comprobado contra Herdr v0.9.5.
¿Qué hace posibles estos usos de Herdr?
Herdr es un multiplexor de terminal open source para agentes de IA que mantiene vivas las sesiones en un servidor en segundo plano, detecta si cada agente está trabajando, bloqueado o ha terminado, y expone una CLI con salida JSON para controlarlo todo por código.
La instalación y la comparativa con tmux están en qué es Herdr. Aquí van los usos, comprobados contra la documentación de la v0.9.5, del 14 de octubre de 2026. Varias recetas usan jq para leer la salida JSON.
Los 7 usos de Herdr de un vistazo
Estos son los siete usos de Herdr con el problema que resuelve cada uno, el comando clave y el caso en el que no compensa:
| # | Problema | Comando o ajuste clave | Cuándo no merece la pena |
|---|---|---|---|
| 1 | Los agentes mueren al cerrar el portátil | ssh + herdr en el servidor, ctrl+b q |
Si todo corre en tu portátil |
| 2 | Proyectos mezclados en la misma barra lateral | herdr --session <nombre> |
Si solo tienes un proyecto activo |
| 3 | Revisar varios PRs uno detrás de otro | herdr worktree create + herdr agent start |
Con PRs de diez líneas |
| 4 | Vigilar una suite larga | herdr notification show |
Con tests que tardan segundos |
| 5 | No ves que un agente te espera | tab_bar_right + herdr agent list |
Con uno o dos agentes |
| 6 | Salir del layout para ver el diff | [[keys.command]] con type = "popup" |
Si ya revisas en el IDE |
| 7 | Perder el layout tras un reinicio | session-snapshots/ + pane_history |
Si nunca paras el servidor |
Receta 1: dejar agentes en un servidor y revisarlos desde el móvil
Si los agentes corren en tu portátil y lo suspendes, se paran con él. La solución es que Herdr viva en la máquina donde está el código y tú solo te conectes, según la guía de trabajo de Herdr:
ssh tu-usuario@servidor
herdr
# lanza tus agentes; para irte sin matar nada:
# ctrl+b q
Desde el móvil sirve cualquier cliente SSH: te conectas y ejecutas herdr. No hace falta app ni panel web, y la interfaz se adapta a pantallas estrechas.
Cuándo no: si el código y las credenciales viven en tu portátil, mudarlo todo a un servidor cuesta más que dejar la tapa abierta. Y ojo con engancharte desde varios clientes: según el issue #4787, en macOS cada cliente reproduce su propio sonido por el mismo evento, y con ocho clientes el reportero vio coreaudiod por encima del 200 % de CPU.
Receta 2: una sesión con nombre por proyecto
Con dos proyectos en el mismo servidor, la barra lateral mezcla agentes que no tienen nada que ver. Una sesión con nombre es un servidor independiente, con sus propios paneles y workspaces (página de persistencia):
herdr --session trabajo # abre o se engancha a la sesión "trabajo"
herdr --session personal
herdr session list # qué sesiones están vivas
herdr session stop personal # para esa sesión y sus paneles
Para que un script hable con una sesión concreta, exporta HERDR_SESSION=trabajo antes de llamar a la CLI.
Cuándo no: las sesiones comparten el mismo config.toml, y los plugins instalados son globales para tu usuario. Si buscas aislamiento real entre proyectos, una sesión con nombre no te lo da.
Receta 3: revisar varios PRs en paralelo, un agente por worktree
Para mí, este es el uso de Herdr que más tiempo ahorra: tres PRs, tres worktrees, tres agentes revisando a la vez.
herdr worktree create, de la CLI de Herdr, hace checkout de una rama local si ya existe y devuelve en JSON el panel raíz del workspace nuevo. Con eso, el bucle sale solo (referencia de la CLI):
repo=~/proyectos/api
git -C "$repo" fetch origin main
for pr in 412 415 418; do
git -C "$repo" fetch origin "pull/$pr/head:pr-$pr"
ws=$(herdr worktree create --cwd "$repo" --branch "pr-$pr" --label "pr-$pr" --no-focus)
pane=$(printf 39;%s\n39; "$ws" | jq -r 39;.result.root_pane.pane_id39;)
herdr agent start "pr-$pr" --kind claude --pane "$pane" -- --permission-mode plan
herdr agent prompt "pr-$pr" "Revisa git diff origin/main...HEAD. Lista bugs y riesgos con fichero y línea."
done
for pr in 412 415 418; do
herdr agent wait "pr-$pr" --timeout 900000
herdr agent read "pr-$pr" --source recent-unwrapped --lines 120
done
--permission-mode plan deja a Claude Code en solo lectura, y --kind codex pone a otro modelo a revisar (ese flag es de Claude Code: con Codex usa su propio modo de solo lectura). Al terminar, herdr worktree remove --workspace <id> borra el checkout, nunca la rama.
Un aviso: Herdr crea cada worktree en una carpeta nueva (por defecto, bajo ~/.herdr/worktrees), y Claude Code puede preguntarte si confías en ella antes de aceptar nada. Si el agente aparece como blocked, el prompt no se ha enviado: acepta el diálogo en su panel y repite el agent prompt.
Cómo repartir trabajo sin que los agentes se pisen está en dirigir agentes de IA en paralelo, y la parte de Git en worktrees con Claude Code.
Cuándo no: con PRs pequeños, abrir tres sesiones completas cuesta más tokens que leer el diff tú. Y agent wait no tiene timeout por defecto: sin --timeout, puede esperar para siempre. Y si el servidor se reinicia, el agente vuelve sin --permission-mode plan (lo explica la receta 7): ya no es una revisión de solo lectura.
Receta 4: que Herdr te avise cuando termina la suite
Herdr avisa cuando un agente termina, pero tu suite e2e no es un agente. Para eso está herdr notification show, que funciona desde cualquier panel:
npm run test:e2e; herdr notification show "Suite e2e terminada" --sound done
Para disparar el aviso según la salida, combina pane run con pane wait-output:
herdr pane run w1:p3 "npm run test:e2e"
herdr pane wait-output w1:p3 --regex "[0-9]+ (passed|failed)" --timeout 1800000 \
&& herdr notification show "e2e" --body "Ya hay resultado" --sound request
Lánzalo en un panel limpio: wait-output también mira lo que ya hay en pantalla, y un "failed" antiguo dispararía el aviso antes de tiempo.
Cuándo no: notification show usa la entrega configurada en [ui.toast], y su valor por defecto es "off": sin cambiarlo, no verás ningún aviso emergente. Además, el issue #5238 documenta que con delivery = "terminal" en el terminal foot la CLI responde shown: true y no aparece nada.
Receta 5: contar agentes bloqueados en la barra de estado
Con seis agentes, el que te espera se pierde entre los que trabajan. La barra de pestañas admite entradas command que se ejecutan cada pocos segundos (configuración):
[ui]
tab_bar_right = [
{ type = "command", command = "~/.config/herdr/blocked.sh", interval_seconds = 5, timeout_seconds = 2 },
]
Y el script, con los campos del esquema de la API (agents[].agent_status):
#!/bin/sh
n=$("$HERDR_BIN_PATH" agent list | jq 39;[.result.agents[] | select(.agent_status == "blocked")] | length39;)
[ "$n" -gt 0 ] && echo "$n bloqueados"
Dale permisos de ejecución con chmod +x ~/.config/herdr/blocked.sh. Si no hay ninguno bloqueado, el script no imprime nada y Herdr vacía la entrada. Para saltar al bloqueado, prefix+g abre el selector y la tecla b filtra los blocked.
Cuándo no: con uno o dos agentes, la barra lateral ya te lo dice. Y en Windows estos comandos se ejecutan con cmd.exe /d /c, así que el script de arriba no te sirve tal cual.
Receta 6: revisar el diff del agente en un popup
Un agente termina y quieres ver qué ha tocado sin romper el layout. Un comando personalizado de tipo popup abre una ventana flotante y desaparece al salir. Es el ejemplo de lazygit de la documentación, con -p para abrir el repo del panel activo:
[[keys.command]]
key = "prefix+alt+g"
type = "popup"
command = "lazygit -p \"$HERDR_ACTIVE_PANE_CWD\""
description = "diff del panel activo"
width = "80%"
height = "80%"
Herdr pasa HERDR_ACTIVE_PANE_CWD a los comandos personalizados, así que en un worktree ves el diff de ese worktree.
Cuándo no: si revisas los cambios en el IDE, esto es una ventana más. Y en Windows la sintaxis de variables cambia a %HERDR_ACTIVE_PANE_CWD%.
Receta 7: recuperar el layout tras reiniciar el servidor
Desengancharte con ctrl+b q no pierde nada. Parar el servidor sí: los procesos mueren y Herdr solo restaura la forma de la sesión. La página de estado de sesión da tres piezas para recuperar más:
[experimental]
pane_history = true # vuelve el contenido reciente de cada panel tras reiniciar
La reanudación de agentes viene activada (session.resume_agents_on_restore = true) y funciona si instalaste la integración del agente. Y si un reinicio te deja un layout roto, Herdr guarda hasta 48 copias en session-snapshots/, junto a session.json: localizas el directorio con herdr session list --json, paras el servidor, copias el snapshot elegido sobre session.json y arrancas.
Cuándo no: pane_history viene apagado porque la salida de los paneles puede incluir tokens y secretos, y se guarda en disco en session-history.json.
Además, la reanudación no conserva los flags con los que arrancaste el agente: en el PR #3302, un usuario con Herdr 0.9.4 cuenta que lanzó Claude Code con --name, --autocompact y --append-system-prompt-file, y tras el reinicio volvió como claude --resume <id>, sin ellos. El PR sigue abierto.
Cuándo NO usar estas recetas de Herdr
El estado es una deducción. Herdr lee la pantalla de cada panel para decidir si un agente está blocked. Si no reconoce un diálogo, cae a idle. La receta 5 cuenta lo que Herdr cree, no lo que pasa: un agente esperando en un selector raro no sumará.
Es un proyecto 0.x. Los comandos son de la v0.9.5, y la propia documentación marca como experimentales piezas como pane_history o herdr update --handoff. Antes de actualizar un servidor donde automatizas, prueba tus scripts con la versión nueva.
Windows tiene huecos. El attach directo a un solo terminal no existe en Windows nativo, los plugins están en preview y las recetas 5 y 6 necesitan otra sintaxis.
Por dónde empezar con estos usos de Herdr
Elige una receta, no siete. Si ya tienes un servidor, empieza por la 1: es la que más cambia con menos configuración. Si trabajas en local, prueba la 3 con dos PRs reales esta semana y compara lo que encontró cada agente con lo que habrías visto tú.
Si quieres entender qué pasa dentro de cada agente mientras Herdr lo vigila (el loop, las tools, la memoria), está explicado en el ebook gratuito El Developer Agéntico.
Y si quieres llevar ese flujo a un producto real con Claude Code, es lo que hacemos en Construye con IA. Decidir quién revisa qué, y contra qué contrato, es el núcleo del workshop SDD + Agentic Engineering.
Preguntas frecuentes
¿Puedo usar Herdr desde el móvil?
Sí, sin app. Te conectas por SSH al servidor donde corre Herdr con cualquier cliente SSH y ejecutas herdr. La interfaz se adapta a pantallas estrechas. Tus agentes tienen que estar en ese servidor, no en tu portátil.
¿Herdr puede revisar varios pull requests a la vez?
Herdr no revisa nada: arranca agentes que revisan. Con herdr worktree create abres un checkout por rama y con herdr agent start lanzas un agente en cada uno. Antes tienes que traer cada PR como rama local, por ejemplo con git fetch origin pull/<n>/head:pr-<n>.
¿Puede Herdr avisarme cuando termina un proceso que no es un agente?
Sí. herdr notification show lanza un aviso desde cualquier panel, así que puedes encadenarlo al final de un comando, como npm run test:e2e; herdr notification show "Suite terminada", o dispararlo con herdr pane wait-output cuando la salida coincide con una expresión regular. Antes tienes que cambiar ui.toast.delivery, que por defecto vale "off".
¿Se pierden los agentes si reinicio el servidor de Herdr?
Los procesos sí se pierden. Herdr restaura el layout y, si instalaste la integración del agente, reanuda su conversación. No conserva los flags con los que lo arrancaste, y el contenido de los paneles solo vuelve si activas pane_history.
Por Bezael Pérez — Developer senior con más de 15 años de experiencia y fundador de Dominicode.
¿Quieres construir con agentes en serio?
Curso «Construye con IA» con Claude Code, de la idea al producto.
Developer con más de 15 años en frontend y creador de Dominicode. Escribe sobre IA aplicada al desarrollo de software.
¿Te resultó útil este artículo?
Compártelo con tu comunidad y ayuda a otros desarrolladores.