Instalar Herdr en macOS, Linux y Windows en cinco minutos

Cinco minutos es una exageración solo si tu conexión es lenta. Herdr es un binario único, sin dependencias, y el instalador lo deja en el PATH. Vamos paso a paso.

1. Instalar

En macOS o Linux:

curl -fsSL https://herdr.dev/install.sh | sh

En Windows, desde PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

Si prefieres tu gestor de paquetes, las tres opciones oficiales son estas:

brew install herdr        # Homebrew
mise use -g herdr         # mise
nix profile install github:herdrdev/herdr/v0.9.1   # Nix, con la etiqueta de versión

Una diferencia que conviene saber desde el principio: herdr update solo funciona en las instalaciones hechas con el instalador de Herdr. Si has usado Homebrew, mise o Nix, actualizas con ellos.

2. Comprobar

Abre una terminal nueva (para que cargue el PATH) y ejecuta:

herdr --version

Si el shell no lo encuentra, comprueba que ~/.local/bin está en tu PATH; ahí lo deja el instalador en Linux y macOS.

3. Arrancar en un proyecto

cd mi-proyecto
herdr

La primera vez aparece una configuración inicial breve, que entre otras cosas ofrece instalar las integraciones de los agentes que encuentre en tu PATH. Acepta las que uses: no cambian cómo funciona el agente, solo le permiten a Herdr saber la identidad de la sesión para poder reanudarla si el servidor se reinicia.

Después, Herdr abre un espacio de trabajo con un panel. El servidor ya está en marcha en segundo plano.

4. Lanzar el agente

En ese panel, como en cualquier terminal:

claude

O codex, opencode, pi, el que uses. En un par de segundos la barra lateral lo muestra con su estado. Divide el panel con el ratón (clic derecho) o con ctrl+b y luego v, y lanza otro. Ya tienes el rebaño.

5. Desconectar y volver

Pulsa ctrl+b y luego q, o cierra la ventana sin más. Los agentes siguen trabajando. Para volver:

herdr

Si de verdad quieres terminar la sesión y parar todos los paneles:

herdr server stop

Canales: estable y preliminar

Las instalaciones directas usan el canal estable. Herdr comprueba si hay versión nueva y te lo dice dentro de la aplicación; con herdr update la instalas. El binario nuevo no reemplaza un servidor compatible que ya esté en marcha: los agentes no se enteran. Solo hace falta parar el servidor cuando quieres cambios del lado del servidor de una versión nueva.

Si quieres las correcciones antes de que salgan en una versión estable:

herdr channel set preview

El canal preliminar se construye desde la rama de desarrollo y puede fallar. Para volver, herdr channel set stable.

Windows, con matices

El soporte de Windows es general, no beta, pero usa ConPTY en vez del modelo de PTY de Unix y eso deja huecos: no hay conexión directa a una terminal (herdr terminal attach), no hay traspaso en caliente del servidor, y el cursor se pinta por celda para evitar parpadeos, lo que descoloca la ventana de los IME coreano, japonés y chino. Todo está en la página de Windows de la documentación, con la tabla de lo que funciona y lo que no.

Por dónde seguir

Con Herdr instalado, lo siguiente son los primeros pasos de la documentación, que enseñan el ratón, los cinco atajos que merece la pena aprender y cómo trabajar por SSH. Y si tu agente es Claude Code, este artículo cuenta cómo dejarlo trabajando y volver desde otra máquina.