Cómo se usa Herdr

La idea cabe en una frase: ejecuta Herdr donde está el trabajo y conéctate desde donde estés. Esto es lo mínimo para empezar; el detalle está en la documentación enlazada en cada paso.

1. Instalar

En macOS o Linux:

Instalar en macOS o Linux

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

Si ya usas Homebrew, mise o Nix:

brew install herdr
mise use -g herdr
nix profile install github:herdrdev/herdr/v0.9.1

En Windows, desde PowerShell:

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

El instalador descarga el binario de tu plataforma y lo deja en el PATH. Todas las variantes, la actualización y la comprobación de la instalación están en Instalar.

2. Arrancar en tu proyecto

cd mi-proyecto
herdr

Herdr arranca su servidor en segundo plano (o se conecta al que ya haya) y abre la interfaz. Si la sesión no tiene espacios de trabajo, crea uno. No hay sockets que gestionar.

3. Lanzar un agente

En un panel, arranca el agente como lo harías en cualquier terminal:

claude

O codex, opencode, pi o cualquiera de los agentes compatibles. Herdr lo detecta y, desde ese momento, la barra lateral muestra si está trabajando, bloqueado, hecho o en espera. Con varios agentes en varios espacios de trabajo, esa lista es lo que miras para saber a quién atender.

4. Moverse por la interfaz

Con el ratón: clic en paneles, pestañas y agentes; arrastrar los bordes para cambiar el tamaño; clic derecho para dividir un panel o crear una pestaña; arrastrar para seleccionar texto (se copia al soltar). Con el teclado, pulsa ctrl+b y luego una acción:

Acción	Tecla
Dividir a la derecha	`prefijo` `v`
Dividir hacia abajo	`prefijo` `-`
Pestaña nueva	`prefijo` `c`
Pestaña siguiente / anterior	`prefijo` `n` / `p`
Navegar entre espacios de trabajo	`prefijo` `w`
Espacio de trabajo nuevo	`prefijo` `shift+n`
Ver todos los atajos	`prefijo` `?`
Desconectar el cliente	`prefijo` `q`

Los atajos se pueden cambiar todos, y también quitar el prefijo. Está en Teclado.

5. Desconectarse y volver

ctrl+b q, o simplemente cierra la ventana. El servidor y todos los agentes siguen en marcha. Para volver:

herdr

Para terminar de verdad la sesión y parar sus paneles:

herdr server stop

Tres formas de trabajar en remoto

Por SSH, como con tmux

ssh yo@servidor
herdr

Todo corre en el servidor: el shell, Herdr y los agentes. Desconectas, cierras el SSH, vuelves a entrar y herdr otra vez. Es la opción más simple y la que usarás desde un cliente SSH en el móvil o la tableta: la interfaz se adapta a pantallas estrechas.

Desde tu terminal local, con --remote

herdr --remote workbox
herdr --remote ssh://yo@servidor:2222

El servidor remoto conserva los paneles y manda su contenido por SSH; tu Herdr local pinta la interfaz con tu tema y puede, por ejemplo, pegar imágenes del portapapeles local. Si el destino está en tu ~/.ssh/config, basta con su nombre.

Varias máquinas en una ventana

herdr machine add workbox --label "servidor de pruebas"

Guarda tus máquinas y Herdr las muestra junto a la local, con una lista combinada de agentes y reconexiones independientes. Detalle en Conectar máquinas.

Y después

Primeros pasos, la versión oficial de esta página.
Estado de la sesión: qué se conserva al desconectar, al reiniciar y al reanudar un agente.
Configuración: temas, notificaciones, barra lateral, scrollback.
Plugins: ampliar Herdr con scripts propios o del catálogo.