Teclado

Herdr está pensado para el ratón. Puedes hacer clic en paneles, pestañas, espacios de trabajo y agentes, arrastrar los bordes de las divisiones y usar los menús contextuales sin aprender un solo atajo. El control con el teclado es opcional.

Qué es el prefijo

Un multiplexor de terminal se sitúa entre tu terminal y los programas que corren dentro. Esos programas ya usan la mayoría de las combinaciones de teclas: ctrl+c interrumpe, ctrl+r busca en el historial, los editores se quedan casi todo lo demás. Si Herdr capturase directamente las teclas habituales, rompería los programas que aloja.

El prefijo resuelve esto. Pulsa la tecla de prefijo, ctrl+b por defecto, y la siguiente pulsación va a Herdr en vez de a tu terminal. prefix+c significa: pulsa ctrl+b, suelta, y pulsa c. Herdr se reserva una tecla en lugar de docenas.

Pulsa prefix+? en cualquier momento para ver todos los atajos activos. Pulsa / en la ayuda de atajos para filtrar acciones y teclas; usa Retroceso para editar el filtro o ctrl+u para vaciarlo.

Aprende estos cinco primero

Acción	Tecla
Pestaña nueva	`prefix+c`
Dividir a la derecha / hacia abajo	`prefix+v` / `prefix+minus`
Moverse entre paneles	`prefix+h/j/k/l`
Navegar por los espacios de trabajo	`prefix+w`
Desconectarse dejando todo en marcha	`prefix+q`

Con estos cubres casi todo el movimiento diario. El resto puede quedarse en el ratón.

El resto, por tarea

Paneles:

Acción	Tecla
Ampliar el panel enfocado	`prefix+z`
Cerrar panel	`prefix+x`
Intercambiar paneles	`prefix+shift+h/j/k/l`
Modo redimensionado	`prefix+r`
Modo copia	`prefix+[`

Pestañas:

Acción	Tecla
Pestaña siguiente / anterior	`prefix+n` / `prefix+p`
Ir a la pestaña 1–9	`prefix+1..9`
Renombrar pestaña	`prefix+shift+t`
Cerrar pestaña	`prefix+shift+x`

Espacios de trabajo y sesión:

Acción	Tecla
Espacio de trabajo nuevo	`prefix+shift+n`
Renombrar espacio de trabajo	`prefix+shift+w`
Cerrar espacio de trabajo	`prefix+shift+d`
Selector «ir a»	`prefix+g`
Mostrar u ocultar la barra lateral	`prefix+b`

El mapa de teclas completo y la sintaxis de los atajos están en la referencia de atajos.

El selector «ir a» (prefix+g) lista cada agente o terminal en su propia fila, agrupados por espacio de trabajo. Las pestañas divididas nunca esconden sus paneles detrás de otra fila. Haz clic en una fila o pulsa Intro para saltar directamente a ella. Pulsa / para buscar por nombre, tipo de agente, pestaña, espacio de trabajo, rama o ruta; usa arriba y abajo o j/k para moverte entre filas cuando no estés escribiendo una búsqueda. Izquierda y derecha saltan al primer agente o terminal de la sección de espacio de trabajo anterior o siguiente, sin dar la vuelta. Mientras editas una búsqueda, izquierda y derecha mueven el cursor del texto. Fuera de la búsqueda, b/w/i/d filtran los agentes bloqueados, trabajando, en espera o hechos, y a vuelve a mostrar todas las terminales. La ubicación y la ruta del destino seleccionado aparecen bajo la lista. Cuando la lista no cabe, usa la rueda del ratón, haz clic en la barra de desplazamiento o arrastra su indicador para desplazarte sin abrir un destino.

Editar campos de texto

Los diálogos de nombre de Herdr, los campos de rama de worktree, los filtros y la búsqueda del modo copia admiten edición en el cursor. Estos atajos se aplican a los campos propios de Herdr, no al shell ni al agente de un panel.

Acción	Teclas
Mover un carácter	Izquierda / Derecha, Ctrl+B / Ctrl+F
Ir al principio / al final	Inicio / Fin, Ctrl+A / Ctrl+E
Mover una palabra	Alt+B / Alt+F
Borrar el carácter anterior	Retroceso, Ctrl+H
Borrar el carácter siguiente	Suprimir, Ctrl+D
Cortar hasta el principio / el final	Ctrl+U / Ctrl+K
Cortar la palabra anterior	Ctrl+W, Alt+Retroceso, Ctrl+Retroceso
Cortar la palabra siguiente	Alt+D
Insertar el último texto cortado	Ctrl+Y

Escribir y pegar insertan en el cursor. El movimiento y el borrado respetan los límites de grafema Unicode, y los valores largos se desplazan horizontalmente. El texto cortado se queda en el campo actual; no usa el portapapeles del sistema. Los atajos con Alt requieren que la terminal informe de Alt/Meta. Intro y Esc conservan el comportamiento de confirmar y cancelar del diálogo.

Modo copia

Pulsa prefix+[ para entrar en el modo copia del panel enfocado. Muévete con h/j/k/l, w/b/e al estilo tmux y W/B/E para palabras grandes, {/}, Re Pág/Av Pág, ctrl+b/ctrl+f y ctrl+u/ctrl+d. Pulsa / o ? para buscar texto literal hacia delante o hacia atrás, y n o N para repetir en la misma dirección o en la contraria. La búsqueda ignora mayúsculas salvo que la consulta contenga alguna. Usa v o Espacio para empezar una selección, y o Intro para copiarla, y q o Esc para salir sin copiar. Esc borra la selección o la búsqueda activas antes de salir. El modo copia no pausa el proceso del panel: la salida sigue viva, sigue al final, y se queda fija cuando navegas por el historial. El prefijo configurado conserva su significado normal en el modo copia; con el prefijo por defecto, ctrl+b entra en el modo prefijo en vez de retroceder una página, así que usa otro prefijo si quieres ctrl+b para retroceder en el modo copia. Seleccionar con el ratón copia sin entrar en el modo copia.

Las selecciones con el ratón y las iniciadas con v, Espacio o V siguen activas mientras hay salida y repintados, también cuando parte del rango seleccionado queda fuera de la zona visible. Copiar lee el texto actual de ese rango, no una instantánea congelada. Cambiar el tamaño del panel o alternar entre su pantalla normal y la alternativa sigue borrando la selección. Los resultados de búsqueda y las selecciones de palabra por doble clic conservan sus comprobaciones de cambio de contenido.

Cambia lo que quieras

Todos los atajos se pueden configurar, incluido el propio prefijo:

[keys]
prefix = "ctrl+a"

Prescindir del prefijo

Puedes asignar las acciones de Herdr a combinaciones directas que no necesitan prefijo. Lo difícil es saber qué combinaciones son seguras, porque las terminales, los shells y los entornos de escritorio ya son dueños de la mayor parte del teclado.

Cualquier combinación vale como atajo: ctrl+j, alt+k, lo que se ajuste a tus manos. Pero una combinación tiene que sobrevivir a tres capas antes de que Herdr la vea: tu sistema operativo, tu terminal exterior (Ghostty, iTerm2 y otras traen sus propios valores por defecto) y los programas que corren dentro del panel. ctrl+j llega bien a Herdr, pero los shells y los editores lo tratan como Intro. alt+k está libre en Linux, pero macOS lo compone como un carácter especial en la mayoría de las terminales. Si eliges combinaciones de estas familias, compruébalas contra los atajos de tu terminal y de tu sistema.

Hemos revisado los atajos por defecto de Ghostty, iTerm2, Terminal.app, kitty, WezTerm, Alacritty, Warp, Windows Terminal, GNOME Terminal y Konsole, más los atajos globales de GNOME y KDE. Hay una familia de modificadores casi intacta en todas partes: ctrl+alt. Las terminales la dejan libre, no le afecta la composición de la tecla Opción de macOS que bloquea las combinaciones con alt a secas, y se transmite incluso en terminales sin protocolo de teclado moderno. Es un valor por defecto seguro, pero la elección es tuya.

Esta configuración mantiene los atajos con prefijo y añade combinaciones directas encima:

[keys]
focus_pane_left = ["prefix+h", "ctrl+alt+h"]
focus_pane_down = ["prefix+j", "ctrl+alt+j"]
focus_pane_up = ["prefix+k", "ctrl+alt+k"]
focus_pane_right = ["prefix+l", "ctrl+alt+l"]
previous_tab = ["prefix+p", "ctrl+alt+["]
next_tab = ["prefix+n", "ctrl+alt+]"]
new_tab = ["prefix+c", "ctrl+alt+c"]
split_vertical = ["prefix+v", "ctrl+alt+d"]
split_horizontal = ["prefix+minus", "ctrl+alt+shift+d"]
zoom = ["prefix+z", "ctrl+alt+z"]

Unas pocas combinaciones con ctrl+alt ya están ocupadas. Evita estas:

Combinación	Quién la usa
`ctrl+alt+flechas`	Cambio de escritorio en GNOME, valores por defecto de Ghostty y Konsole
`ctrl+alt+t`	«Abrir terminal» en Ubuntu y Fedora
`ctrl+alt+l` / `ctrl+alt+a`	Bloquear pantalla / ventana que pide atención en KDE
`ctrl+alt+s` / `ctrl+alt+u`	Konsole
`ctrl+alt+f1..f12`	Cambio de consola virtual en Linux

Si una combinación directa no hace nada, tu terminal o tu entorno de escritorio la han consumido antes de que Herdr pudiera verla. Cambia una de las dos partes: libera la combinación en los ajustes de la terminal, o elige otra en Herdr.