Cómo usar Herdr: deja tus agentes de código trabajando y cierra el portátil

Qué es Herdr y qué problema resuelve

Le pides a un agente de código que haga un rediseño grande, o que procese un lote de datos que va a tardar horas. Sales a comer, cierras el portátil, y cuando vuelves la sesión de terminal ha desaparecido y el agente se ha parado a medias. Herdr resuelve exactamente eso: es un servidor en segundo plano que se queda con las sesiones de terminal de tus agentes de código, para que sigan trabajando aunque tú te desconectes, reinicies el ordenador o cambies de red.

No sustituye a Claude Code, Cursor ni a ningún otro agente — no los envuelve ni cambia cómo funcionan, simplemente es dueño de su terminal. Cuando reconectas, Herdr te devuelve exactamente la misma disposición de paneles y sesiones que tenías antes.

También te deja conectar varias máquinas por SSH y ver los agentes de todas ellas en una sola pantalla, junto a los que corren en tu propio ordenador.

Para quién tiene sentido

• Para ti, si lanzas tareas largas con agentes de código (refactors grandes, procesado de datos, investigación) y no quieres tener el portátil abierto todo ese tiempo.
• Para ti, si trabajas con varios agentes a la vez y pierdes de vista cuál está parado esperando tu permiso y cuál sigue trabajando solo.
• Para equipos que combinan máquinas locales y remotas (por SSH) y quieren ver todos los agentes desde un único sitio.
• Menos indicado si solo lanzas tareas cortas de segundos o minutos, donde perder la sesión al cerrar el terminal nunca ha sido un problema real.

Cómo empezar

1. 1. Instala el binario

   En macOS/Linux: curl -fsSL https://herdr.dev/install.sh | sh. En Windows (PowerShell): powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex". También disponible vía Homebrew, mise o Nix.

2. 2. Arráncalo desde tu proyecto

   Ejecuta herdr en el directorio de tu proyecto — si es la primera vez, abre un workspace nuevo automáticamente; si ya tenías uno, te reconecta a él.

3. 3. Lanza un agente dentro de un panel

   Escribe claude, codex, o el comando del agente que uses normalmente, dentro de Herdr.

4. 4. Desconéctate sin miedo

   Con el atajo prefix+q, o simplemente cerrando la ventana de terminal — el agente sigue corriendo en el servidor de Herdr, no en tu terminal.

Caso de uso: una tarea que tarda horas

Situación: lanzas un job de backfill de datos que va a tardar seis horas. Qué hace Herdr: mantiene la sesión corriendo en segundo plano aunque cierres el portátil o te vayas a otra red — el propio fabricante muestra este caso literalmente en su web, con un job de seis horas que sigue en marcha tras desconectar el portátil. Resultado esperado: vuelves horas después, reconectas y ves exactamente el mismo panel, con el job terminado o avanzado. Advertencia: esto depende de que el propio agente no necesite tu intervención a mitad del proceso — si se queda 'blocked' esperando un permiso, se quedará esperando hasta que reconectes.

Caso de uso: saber qué agente necesita tu atención

Situación: tienes cuatro agentes abiertos a la vez y no quieres ir revisando panel por panel. Qué hace Herdr: clasifica cada agente en 'working', 'idle' o 'blocked' — 'blocked' solo se marca cuando la pantalla coincide de verdad con una interfaz conocida de aprobación o permiso, nunca por una heurística genérica — y te deja una cola de atención por estado. Resultado esperado: entras y ves de un vistazo cuáles están parados esperando tu 'sí', cuáles siguen trabajando y cuáles ya han terminado. Advertencia: la detección de estado es más fiable en los agentes con 'lifecycle hooks' completos instalados; en los que no los tienen, Herdr infiere el estado leyendo la pantalla, que es un método algo menos preciso.

Caso de uso: agentes en varias máquinas a la vez

Situación: tienes un agente corriendo en tu portátil y otro en un servidor remoto al que te conectas por SSH. Qué hace Herdr: conecta ambas máquinas y muestra los agentes de la remota junto a los locales, en la misma interfaz. Resultado esperado: no necesitas dos terminales ni dos ventanas — todo aparece junto. Advertencia: la conexión sigue dependiendo de que el acceso SSH a esa máquina remota ya esté configurado por tu cuenta; Herdr no configura el acceso por ti.

Caso de uso: ampliar Herdr con plugins de la comunidad

Situación: quieres una función que Herdr no trae de fábrica. Qué hace Herdr: tiene un marketplace de plugins locales/ejecutables construidos por la comunidad — más de mil a fecha de esta guía. Resultado esperado: puedes instalar uno ya hecho en vez de construir tu propia integración desde cero. Advertencia: son plugins de terceros, no verificados por Herdr en el sentido de una revisión de seguridad formal — revisa qué hace un plugin antes de instalarlo, igual que harías con cualquier paquete de terceros.

Ejemplo práctico completo: dos agentes, un reinicio de máquina de por medio

1. 1. Arrancas Herdr y lanzas dos agentes

   Desde tu proyecto, ejecutas herdr, abres dos paneles y lanzas claude en uno (para un refactor) y codex en otro (para escribir tests del mismo cambio).

2. 2. Uno de los agentes se queda 'blocked'

   El agente que refactoriza pide confirmación antes de borrar un archivo — Herdr lo marca como blocked, no como si hubiera fallado o se hubiera parado.

3. 3. Reinicias el ordenador para instalar una actualización

   Cierras todo, reinicias la máquina — las sesiones siguen registradas en Herdr, no en tu terminal.

4. 4. Vuelves a ejecutar herdr

   Recupera el layout completo: los dos paneles, el estado de cada agente (uno sigue blocked, el otro terminó los tests mientras tanto).

5. 5. Atiendes el que está bloqueado y sigues

   Confirmas el borrado del archivo pendiente, el agente retoma el refactor donde lo dejó.

Qué hacer cuando algo falla

• Un agente aparece siempre como 'working' aunque esté parado: revisa si tiene lifecycle hooks instalados — sin ellos, Herdr depende de leer la pantalla, que es menos fiable que la integración completa.
• No ves los agentes de una máquina remota: confirma que el acceso SSH a esa máquina ya funciona por tu cuenta fuera de Herdr — la herramienta no gestiona credenciales de acceso por ti.
• La memoria de un agente parece perderse entre sesiones: eso depende del propio agente, no de Herdr — Herdr conserva la sesión de terminal, no reescribe cómo cada agente gestiona su propio contexto.
• Quieres apagar todo de golpe: herdr server stop detiene el servidor completo, no solo un panel.

Qué hace bien

• Las sesiones sobreviven a desconexiones, cierres de portátil y reinicios de máquina — no solo a cerrar la ventana de terminal.
• Detecta si un agente está trabajando, parado esperando permiso, o inactivo, en vez de dejarte adivinarlo mirando la pantalla.
• Un único binario en Rust, sin depender de Electron ni de un runtime pesado.
• Es de código abierto (Apache 2.0) y gratuito para autoalojar, sin necesidad de cuenta para el uso local.

Qué no hace bien (o no hace todavía)

• No sustituye la gestión de contexto de cada agente — si un agente concreto olvida cosas entre mensajes, eso es cosa del agente, no de Herdr.
• Dos agentes soportados (Gemini CLI, Cline) están 'detectados pero menos probados' que el resto — su detección de estado es menos madura.
• Herdr Cloud, un servicio gestionado sin necesidad de configurar SSH tú mismo, todavía no está disponible — solo anunciado como 'coming soon', sin fecha ni precio publicados.
• No hay todavía una página de precios activa porque el runtime en sí es gratuito y de código abierto — si necesitas un plan gestionado con soporte, hoy no existe.

Alternativas

Herdr no nombra ningún multiplexor de terminal (tmux, screen, zellij) como comparación directa ni como alternativa — solo los menciona de pasada como parte del entorno donde ya viven los agentes de código, sin decir que sea mejor o peor que ellos. La diferencia real y verificable frente a un multiplexor genérico es que Herdr añade detección de estado específica para agentes de código (trabajando/bloqueado/inactivo) por encima de lo que un multiplexor tradicional ofrece — no es una comparativa de marketing, es una diferencia funcional documentada.