Herdr Cheat Sheet & Quick Reference

Esenciales

$herdr

Iniciar Herdr o conectarse a la sesión predeterminada.

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

Instalar Herdr en Linux o macOS con el script de instalación oficial.

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

Instalar Herdr en Windows desde PowerShell; los sistemas ARM64 ejecutan la compilación x86_64 en emulación.

$brew install herdr
$brew install herdr

Instalar Herdr con Homebrew.

$mise use -g herdr

Instalar Herdr con mise.

$herdr --remote workbox

Conectarse a una máquina remota por SSH usando sus atajos de teclado locales.

$herdr --session work

Abrir una sesión con nombre en lugar de la sesión predeterminada.

Ctrl + b q

Desconectarse de la TUI y dejar todos los paneles en ejecución.

Ctrl + b ?

Mostrar todos los atajos de teclado activos en el panel de ayuda.

Ctrl + b ? then /

Filtrar acciones y atajos en el panel de ayuda de atajos de teclado.

$herdr --default-config

Imprimir la configuración predeterminada completa en stdout.

$herdr update

Actualizar una compilación de Herdr gestionada por el instalador desde el canal configurado.

$brew upgrade herdr
$brew upgrade herdr

Actualizar Herdr instalado con Homebrew.

$mise upgrade herdr

Actualizar Herdr instalado con mise.

Paneles

Ctrl + b v

Dividir el panel enfocado hacia la derecha.

Ctrl + b -

Dividir el panel enfocado hacia abajo, abriendo un panel nuevo debajo.

Ctrl + b h / j / k / l

Mover el foco al panel izquierdo, inferior, superior o derecho.

Ctrl + b z

Ampliar el panel enfocado para llenar la pestaña.

Ctrl + b x

Cerrar el panel enfocado.

Ctrl + b shift + h / j / k / l

Intercambiar el panel enfocado con el panel en una dirección.

Ctrl + b r

Entrar en el modo de redimensionar para el panel enfocado.

Drag

Seleccionar texto arrastrando con el ratón para copiarlo sin entrar en el modo de copia.

Pestañas y Espacios de Trabajo

Ctrl + b c

Crear una nueva pestaña en el espacio de trabajo activo.

Ctrl + b n / p

Moverse a la pestaña siguiente o anterior.

Ctrl + b 1..9

Saltar directamente a la pestaña 1 a 9.

Ctrl + b shift + t

Renombrar la pestaña activa.

Ctrl + b shift + x

Cerrar la pestaña activa.

Ctrl + b shift + n

Crear un nuevo espacio de trabajo.

Ctrl + b shift + w

Renombrar el espacio de trabajo activo.

Ctrl + b shift + d

Cerrar el espacio de trabajo activo.

Ctrl + b w

Entrar en la navegación de espacios de trabajo; salir de ella con Esc o Ctrl+[.

Ctrl + b g

Abrir el selector Ir a para saltar a un agente o terminal.

Ctrl + b b

Alternar el panel de la barra lateral.

Modo de Copia y Campos de Texto

Ctrl + b [

Entrar en el modo de copia para el panel enfocado.

h / j / k / l

Moverse por carácter o línea en el modo de copia.

w / b / e

Moverse por palabra en el modo de copia.

W / B / E

Moverse por palabra grande en el modo de copia.

{ / }

Saltar al párrafo anterior o siguiente en el modo de copia.

PageUp / PageDown

Avanzar o retroceder una página en el modo de copia.

Ctrl + U / Ctrl + D

Desplazarse media página hacia arriba o hacia abajo en el modo de copia.

/ or ? then n / N

Buscar en el historial del panel y repetir coincidencias.

v or Space

Iniciar una selección en el modo de copia.

y or Enter

Copiar la selección activa en el modo de copia.

q or Esc

Salir del modo de copia sin copiar.

Ctrl + A / Ctrl + E

Moverse al inicio o al final de un campo de texto de Herdr.

Ctrl + U / Ctrl + K

Cortar desde el cursor hasta el inicio o el final de un campo de texto de Herdr.

Ctrl + W / Alt + Backspace / Ctrl + Backspace

Cortar la palabra anterior en un campo de texto de Herdr.

Alt + D

Cortar la siguiente palabra en un campo de texto de Herdr.

Ctrl + Y

Insertar el último texto cortado en un campo de texto de Herdr.

Inicio, Estado y Máquinas

$herdr status

Imprimir el estado general de Herdr.

$herdr status server

Imprimir el estado del servidor.

$herdr --version

Imprimir la versión de Herdr instalada.

$herdr channel show

Mostrar el canal de actualización actual.

$herdr channel set preview

Optar por las compilaciones de vista previa.

$herdr completion zsh

Generar un script de autocompletado de shell.

$herdr machine add workbox --label "Build machine"

Guardar un perfil de máquina SSH con una etiqueta.

$herdr machine status "Build machine"

Comprobar la accesibilidad de una máquina guardada.

$herdr --machine "Build machine" agent list

Dirigir un comando de CLI a una máquina SSH guardada.

Sesiones, Espacios de Trabajo y Paneles

$herdr session list

Listar las sesiones de Herdr.

$herdr session attach work

Conectarse a una sesión con nombre.

$herdr workspace list

Listar espacios de trabajo.

$herdr workspace create --cwd ~/project --label api --no-focus

Crear un espacio de trabajo sin robar el foco.

$herdr tab create --workspace <workspace_id> --label logs

Crear una pestaña en un espacio de trabajo con una etiqueta.

$herdr tab close <tab_id>

Cerrar una pestaña por ID.

$herdr pane list

Listar paneles.

$herdr pane split <pane_id> --direction right --ratio 0.3

Dividir un panel hacia la derecha con una proporción.

$herdr pane focus --direction left

Enfocar el panel en una dirección.

$herdr pane read <pane_id> --source recent-unwrapped --lines 120

Leer la salida reciente del panel sin ajuste de línea.

$herdr pane run <pane_id> "npm test"

Ejecutar un comando en un panel y enviarlo con Enter.

$herdr pane close <pane_id>

Cerrar un panel por ID.

Agentes, Complementos e Integraciones

$herdr agent list

Listar los agentes detectados e iniciados.

$herdr agent start reviewer --kind claude --pane <pane_id>

Iniciar un agente con nombre en un panel de shell disponible.

$herdr agent prompt reviewer "review this diff" --wait

Enviar un prompt a un agente y esperar a un estado estable.

$herdr agent wait reviewer --until idle

Esperar a que un agente alcance un estado específico.

$herdr agent read reviewer --lines 80

Leer la salida de terminal de un agente.

$herdr agent send-keys reviewer esc

Enviar teclas lógicas a un agente.

$herdr agent focus reviewer

Enfocar un agente en la interfaz.

$herdr integration install claude

Instalar la integración del agente Claude.

$herdr integration status --outdated-only

Mostrar solo las integraciones con versiones desactualizadas.

$herdr plugin install ogulcancelik/herdr-plugin-examples/worktree-bootstrap --yes

Instalar un complemento desde la sintaxis abreviada de GitHub.

$herdr plugin list

Listar los complementos instalados.

$herdr plugin action invoke <action_id>

Invocar una acción de complemento instalada.

$herdr worktree create --cwd ~/project --branch review

Crear un git worktree como espacio de trabajo.

Configuración

[keys] prefix = "ctrl+a"

Cambiar la tecla de prefijo dentro de la tabla keys.

[keys] prefix = ["ctrl+space", "ctrl+s"]

Entrar en el modo de prefijo desde más de una tecla.

[keys] focus_pane_left = ["prefix+h", "ctrl+alt+h"]

Añadir un atajo directo junto al enlace de prefijo.

[keys] switch_tab = "prefix+1..9"

Vincular un salto indexado entre las pestañas 1 a 9.

[theme] name = "catppuccin"

Elegir un tema integrado en la tabla de temas.

[theme] auto_switch = true

Permitir que el tema siga la apariencia clara u oscura de la terminal.

[theme.custom] accent = "#a6e3a1"

Anular un solo color del tema.

[terminal] default_shell = "nu"

Establecer el ejecutable usado para los nuevos paneles interactivos.

[terminal] new_cwd = "follow"

Establecer la política de directorio de trabajo para nuevos paneles, pestañas y espacios de trabajo.

$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml
$notepad %APPDATA%\herdr\config.toml
$mkdir -p ~/.config/herdr && ${EDITOR:-vi} ~/.config/herdr/config.toml

Abrir el archivo de configuración de Herdr para editarlo.

$herdr server reload-config

Aplicar la configuración recargable sin reiniciar los paneles.

$herdr config reset-keys

Hacer una copia de seguridad de config.toml y descartar los atajos de teclado personalizados. Tiene efecto tras reiniciar o recargar.