Primeros pasos

Si aún no tienes Herdr instalado, pasa por Instalar. Después, arranca Herdr desde el directorio de cualquier proyecto:

herdr

Herdr abre tu sesión en segundo plano por defecto, o se conecta a ella si ya existe. No tienes que gestionar sockets. Si te desconectas, los agentes siguen en marcha.

Crear un espacio de trabajo

Cuando una sesión no tiene espacios de trabajo, Herdr abre uno automáticamente. Un espacio de trabajo es un contenedor a nivel de proyecto para pestañas, paneles y agentes. Dale a cada proyecto activo su propio espacio de trabajo para que el estado de los agentes se lea bien en la barra lateral.

Usar el ratón

Herdr está pensado para el ratón, así que empieza haciendo clic en paneles, pestañas, espacios de trabajo y agentes para enfocarlos. Arrastra los bordes de los paneles para cambiar el tamaño. Haz clic derecho para abrir los menús contextuales, con opciones como dividir paneles y crear pestañas. Arrastra para seleccionar texto y copiarlo al portapapeles. Haz doble clic sobre una palabra para seleccionarla, o mantén pulsado el segundo clic y arrastra para ampliar la selección palabra a palabra. Los dos gestos copian al soltar el ratón. Copiar no requiere Ctrl+C.

Ctrl+clic abre los enlaces de un panel cuando la terminal envía a Herdr el clic con modificador. Funciona con hiperenlaces OSC 8 y con URL http:// o https://, incluidos los enlaces partidos cuyo principio o final queda fuera de la zona visible. Mantén Ctrl y mueve el puntero sobre un enlace para subrayar sus tramos visibles. El resaltado desaparece al retirar el puntero, cuando cambia el contenido del panel o cuando Herdr recibe un evento de Ctrl soltado; algunas terminales solo informan de cambios en los modificadores cuando se mueve el ratón.

Con ui.mouse_capture = true (el valor por defecto), Herdr se encarga de los Ctrl+clic. Primero se ejecutan los plugins activados que coincidan. Si un gestor no consigue arrancar, Herdr muestra un error y se detiene ahí. Los enlaces http:// y https:// sin coincidencia se abren en el navegador predeterminado de la máquina donde se ejecuta el cliente de Herdr. El resto de enlaces necesitan un plugin que coincida. En este modo, los hiperenlaces explícitos no se anuncian a la terminal exterior, así que no hay clics nativos de la terminal sobre enlaces con texto, ni siquiera Cmd+clic en macOS.

Con ui.mouse_capture = false, los hiperenlaces explícitos pasan a la terminal exterior. Usa sus atajos y avisos habituales para enlaces. Estos clics no invocan los plugins de Herdr. Desactivar la captura también desactiva los controles de ratón de Herdr, como hacer clic en las pestañas o arrastrar los bordes de los paneles.

Windows Terminal puede seguir interceptando las URL que detecta en el texto visible. Para que los plugins tengan prioridad de forma fiable sobre esas URL, pon "experimental.detectURLs": false en el settings.json de Windows Terminal. Este ajuste se aplica a todos los perfiles de Windows Terminal. Herdr no lo cambia.

Si configuras ui.right_click_passthrough_modifier, ese modificador más clic derecho envía los gestos de clic derecho, mantener y arrastrar a las aplicaciones del panel que gestionan el ratón. Para que el clic derecho normal llegue a la aplicación de un panel concreto, elige Send right-clicks to pane en el menú de ese panel o ejecuta dentro herdr pane input --current --right-click pane. Haz clic derecho en el marco del panel para volver a abrir el menú de Herdr.

Ejecutar un agente

Arranca tu agente de programación en un panel:

claude

O codex, pi, opencode o cualquier otro agente compatible. Herdr lo detecta automáticamente. En todos los espacios de trabajo, la barra lateral muestra si cada agente está working, blocked, done o idle (trabajando, bloqueado, hecho o en espera), así siempre sabes qué proyecto te necesita.

Control con el teclado

El teclado es opcional; con el ratón llegas a todo. Pulsa ctrl+b para entrar en el modo prefijo y luego una tecla de acción.

Acciones habituales:

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

Si la idea del prefijo te es nueva, Teclado explica qué es, por qué lo usan los multiplexores y cómo prescindir de él. Pulsa prefijo+? dentro de Herdr para ver todos los atajos activos, y prefijo+[ para copiar con el teclado en el modo copia.

Desconectarse y volver

Pulsa prefijo+q o simplemente cierra la ventana de la terminal. El servidor de Herdr y todos los agentes siguen en marcha. Ejecuta herdr otra vez para volver a conectarte a la misma sesión.

Para terminar la sesión y parar sus paneles:

herdr server stop

Por dónde seguir

• Conceptos: el modelo de espacios de trabajo, pestañas, paneles y agentes en dos minutos.
• Cómo trabajar con Herdr: en local, por SSH, desde el móvil y con herdr --remote.
• Agentes: agentes compatibles, detección e integraciones que mejoran la precisión del estado.
• Configuración: atajos, temas, notificaciones y todo lo demás.