Ir al contenido

Referencia de configuración

Consulta en una lista plana y filtrable todas las claves canónicas que Herdr lee de config.toml. Para la puesta en marcha y el porqué de cada opción, mira Configuración.

Imprime en cualquier momento la configuración por defecto completa, con comentarios:

Ventana de terminal
herdr --default-config

Los atajos de comandos personalizados ([[keys.command]]) son tablas definidas por el usuario y no se listan clave a clave; mira Atajos de comandos personalizados.

209 claves

General

onboardingbooleanpor defecto sin valor

Muestra la configuración inicial al arrancar. Si falta o es true se muestra; continuar desde ella escribe onboarding = false.

Servidor

server.headless_colsintegerpor defecto 120

Ancho de la terminal virtual usada para la disposición y los paneles nuevos cuando no hay ningún cliente conectado. Debe ser mayor que cero.

server.headless_rowsintegerpor defecto 40

Alto de la terminal virtual usada para la disposición y los paneles nuevos cuando no hay ningún cliente conectado. Debe ser mayor que cero.

Tema

theme.namestringpor defecto "catppuccin"

Nombre del tema integrado.

theme.auto_switchbooleanpor defecto false

Sigue la apariencia clara u oscura de la terminal y cambia entre nombres de tema.

theme.dark_namestringpor defecto sin valor

Tema usado cuando auto_switch detecta apariencia oscura.

theme.light_namestringpor defecto sin valor

Tema usado cuando auto_switch detecta apariencia clara.

theme.custom.accentcolorpor defecto sin valor

Sustituye el color accent sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.panel_bgcolorpor defecto sin valor

Sustituye el color panel_bg sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.sidebar_bgcolorpor defecto sin valor

Fondo de la barra lateral de escritorio, sin cambiar las demás superficies de panel. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.active_row_bgcolorpor defecto sin valor

Fondo del espacio activo y de la fila de agente enfocada, sin cambiar separadores ni barras de desplazamiento. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.selection_bgcolorpor defecto sin valor

Fondo de la fila del cursor del modo navegación en la barra lateral, sin cambiar otras superficies de selección. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.surface0colorpor defecto sin valor

Sustituye el color surface0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.surface1colorpor defecto sin valor

Sustituye el color surface1 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.surface_dimcolorpor defecto sin valor

Sustituye el color surface_dim sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.overlay0colorpor defecto sin valor

Sustituye el color overlay0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.overlay1colorpor defecto sin valor

Sustituye el color overlay1 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.textcolorpor defecto sin valor

Sustituye el color text sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.subtext0colorpor defecto sin valor

Sustituye el color subtext0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.mauvecolorpor defecto sin valor

Sustituye el color mauve sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.greencolorpor defecto sin valor

Sustituye el color green sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.yellowcolorpor defecto sin valor

Sustituye el color yellow sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.redcolorpor defecto sin valor

Sustituye el color red sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.bluecolorpor defecto sin valor

Sustituye el color blue sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.tealcolorpor defecto sin valor

Sustituye el color teal sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.peachcolorpor defecto sin valor

Sustituye el color peach sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.accentcolorpor defecto sin valor

Sustituye el color accent cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.panel_bgcolorpor defecto sin valor

Sustituye el color panel_bg cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.sidebar_bgcolorpor defecto sin valor

Sustituye el color sidebar_bg cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.active_row_bgcolorpor defecto sin valor

Sustituye el color active_row_bg cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.selection_bgcolorpor defecto sin valor

Sustituye el color selection_bg cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.surface0colorpor defecto sin valor

Sustituye el color surface0 cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.surface1colorpor defecto sin valor

Sustituye el color surface1 cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.surface_dimcolorpor defecto sin valor

Sustituye el color surface_dim cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.overlay0colorpor defecto sin valor

Sustituye el color overlay0 cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.overlay1colorpor defecto sin valor

Sustituye el color overlay1 cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.textcolorpor defecto sin valor

Sustituye el color text cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.subtext0colorpor defecto sin valor

Sustituye el color subtext0 cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.mauvecolorpor defecto sin valor

Sustituye el color mauve cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.greencolorpor defecto sin valor

Sustituye el color green cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.yellowcolorpor defecto sin valor

Sustituye el color yellow cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.redcolorpor defecto sin valor

Sustituye el color red cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.bluecolorpor defecto sin valor

Sustituye el color blue cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.tealcolorpor defecto sin valor

Sustituye el color teal cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.light.peachcolorpor defecto sin valor

Sustituye el color peach cuando auto_switch detecta apariencia clara. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.accentcolorpor defecto sin valor

Sustituye el color accent cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.panel_bgcolorpor defecto sin valor

Sustituye el color panel_bg cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.sidebar_bgcolorpor defecto sin valor

Sustituye el color sidebar_bg cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.active_row_bgcolorpor defecto sin valor

Sustituye el color active_row_bg cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.selection_bgcolorpor defecto sin valor

Sustituye el color selection_bg cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.surface0colorpor defecto sin valor

Sustituye el color surface0 cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.surface1colorpor defecto sin valor

Sustituye el color surface1 cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.surface_dimcolorpor defecto sin valor

Sustituye el color surface_dim cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.overlay0colorpor defecto sin valor

Sustituye el color overlay0 cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.overlay1colorpor defecto sin valor

Sustituye el color overlay1 cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.textcolorpor defecto sin valor

Sustituye el color text cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.subtext0colorpor defecto sin valor

Sustituye el color subtext0 cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.mauvecolorpor defecto sin valor

Sustituye el color mauve cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.greencolorpor defecto sin valor

Sustituye el color green cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.yellowcolorpor defecto sin valor

Sustituye el color yellow cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.redcolorpor defecto sin valor

Sustituye el color red cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.bluecolorpor defecto sin valor

Sustituye el color blue cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.tealcolorpor defecto sin valor

Sustituye el color teal cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

theme.custom.dark.peachcolorpor defecto sin valor

Sustituye el color peach cuando auto_switch detecta apariencia oscura. Se aplica después de theme.custom. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.

Terminal

terminal.default_shellstringpor defecto ""

Ejecutable de los paneles interactivos nuevos. Vacío significa SHELL y después /bin/sh; en Windows, pwsh.exe si está en el PATH y si no, powershell.exe.

terminal.shell_modeenumpor defecto "auto"

Modo de arranque de los shells de los paneles interactivos nuevos.

Valores: auto, login, non_login

terminal.new_cwdenumpor defecto "follow"

Política de directorio de trabajo para paneles, pestañas y espacios de trabajo nuevos.

Valores: follow, home, current, path

terminal.kitty_graphicsbooleanpor defecto true

Pinta las imágenes de los paneles en terminales exteriores compatibles con los gráficos de Kitty. Con false se desactivan el pintado y la API de gráficos de los paneles. Reinicia el servidor o vuelve a conectar el cliente después de cambiarlo. En sesiones remotas, la configuración del servidor controla el análisis y la disponibilidad de la API, y la del cliente local controla la salida a la terminal exterior.

Actualizaciones

update.channelenumpor defecto "stable" ("preview" for Windows preview builds)

Canal de actualización de las comprobaciones de versión en segundo plano y de herdr update. Las compilaciones estables de Windows usan stable por defecto; las instalaciones preliminares de Windows existentes siguen en preview hasta que se cambian expresamente. Las instalaciones de Homebrew, mise y Nix ignoran el canal preview.

Valores: stable, preview

update.version_checkbooleanpor defecto true

Comprueba en herdr.dev, en segundo plano, si hay versiones nuevas de Herdr.

update.manifest_checkbooleanpor defecto true

Comprueba en herdr.dev, en segundo plano, si hay manifiestos de detección de agentes actualizados. Los manifiestos incluidos y los ficheros locales se siguen aplicando.

Atajos de teclado

keys.prefixstringpor defecto "ctrl+b"

Tecla de prefijo para entrar en el modo prefijo (p. ej. "ctrl+b", "f12", "esc").

keys.helpkeybindingpor defecto "prefix+?"

Abre la ayuda de atajos.

keys.settingskeybindingpor defecto "prefix+s"

Abre los ajustes.

keys.new_workspacekeybindingpor defecto "prefix+shift+n"

Crea un espacio de trabajo nuevo.

keys.new_worktreekeybindingpor defecto "prefix+shift+g"

Crea un worktree de Git desde el espacio de trabajo seleccionado.

keys.open_worktreekeybindingpor defecto sin valor

Abre un worktree de Git existente desde el espacio de trabajo seleccionado. Sin atajo por defecto.

keys.remove_worktreekeybindingpor defecto sin valor

Borra, tras confirmar, la copia del worktree gestionado seleccionado. Sin atajo por defecto.

keys.rename_workspacekeybindingpor defecto "prefix+shift+w"

Renombra el espacio de trabajo seleccionado.

keys.close_workspacekeybindingpor defecto "prefix+shift+d"

Cierra el espacio de trabajo seleccionado.

keys.workspace_pickerkeybindingpor defecto "prefix+w"

Abre la navegación de espacios de trabajo.

keys.gotokeybindingpor defecto "prefix+g"

Abre el navegador de la sesión.

keys.navigate_workspace_upkeybindingpor defecto "up"

Sube la selección de espacio de trabajo en el modo navegación.

keys.navigate_workspace_downkeybindingpor defecto "down"

Baja la selección de espacio de trabajo en el modo navegación.

keys.navigate_pane_leftkeybindingpor defecto "h"

Enfoca el panel de la izquierda en el modo navegación. La flecha izquierda es siempre un alias.

keys.navigate_pane_downkeybindingpor defecto "j"

Enfoca el panel de abajo en el modo navegación.

keys.navigate_pane_upkeybindingpor defecto "k"

Enfoca el panel de arriba en el modo navegación.

keys.navigate_pane_rightkeybindingpor defecto "l"

Enfoca el panel de la derecha en el modo navegación. La flecha derecha es siempre un alias.

keys.detachkeybindingpor defecto "prefix+q"

Desconecta el cliente actual de su servidor de Herdr.

keys.reload_configkeybindingpor defecto "prefix+shift+r"

Recarga config.toml en la aplicación y el servidor en marcha.

keys.open_notification_targetkeybindingpor defecto "prefix+o"

Enfoca el destino de la notificación visible.

keys.previous_workspacekeybindingpor defecto sin valor

Selecciona el espacio de trabajo anterior. Sin atajo por defecto.

keys.next_workspacekeybindingpor defecto sin valor

Selecciona el espacio de trabajo siguiente. Sin atajo por defecto.

keys.previous_agentkeybindingpor defecto sin valor

Enfoca el agente anterior del panel de agentes. Sin atajo por defecto.

keys.next_agentkeybindingpor defecto sin valor

Enfoca el agente siguiente del panel de agentes. Sin atajo por defecto.

keys.focus_agentkeybindingpor defecto sin valor

Enfoca un agente por índice 1-9. Sin atajo por defecto.

keys.remote_image_pastestringpor defecto "ctrl+v"

Atajo del cliente local que envía una imagen del portapapeles a una sesión remota de Herdr.

keys.new_tabkeybindingpor defecto "prefix+c"

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

keys.rename_tabkeybindingpor defecto "prefix+shift+t"

Renombra la pestaña activa.

keys.previous_tabkeybindingpor defecto "prefix+p"

Selecciona la pestaña anterior.

keys.next_tabkeybindingpor defecto "prefix+n"

Selecciona la pestaña siguiente.

keys.move_tab_previouskeybindingpor defecto sin valor

Mueve la pestaña activa una posición hacia el principio. Sin atajo por defecto.

keys.move_tab_nextkeybindingpor defecto sin valor

Mueve la pestaña activa una posición hacia el final. Sin atajo por defecto.

keys.switch_tabkeybindingpor defecto "prefix+1..9"

Cambia a la pestaña 1-9.

keys.switch_workspacekeybindingpor defecto sin valor

Cambia al espacio de trabajo 1-9 desde el modo prefijo. Sin atajo por defecto.

keys.close_tabkeybindingpor defecto "prefix+shift+x"

Cierra la pestaña activa.

keys.rename_panekeybindingpor defecto "prefix+shift+p"

Renombra el panel enfocado.

keys.edit_scrollbackkeybindingpor defecto "prefix+e"

Abre el historial del panel enfocado en $EDITOR.

keys.clear_panekeybindingpor defecto sin valor

Vacía la pantalla y el historial del panel enfocado, conservando la línea actual del cursor y sus filas visibles con ajuste de línea. No envía entrada al programa y no hace nada en la pantalla alternativa (por ejemplo, Vim). Sin atajo por defecto; por ejemplo, clear_pane = "prefix+ctrl+k".

keys.copy_modekeybindingpor defecto "prefix+["

Entra en el modo copia con teclado del panel enfocado.

keys.focus_pane_leftkeybindingpor defecto "prefix+h"

Enfoca el panel de la izquierda.

keys.focus_pane_downkeybindingpor defecto "prefix+j"

Enfoca el panel de abajo.

keys.focus_pane_upkeybindingpor defecto "prefix+k"

Enfoca el panel de arriba.

keys.focus_pane_rightkeybindingpor defecto "prefix+l"

Enfoca el panel de la derecha.

keys.swap_pane_leftkeybindingpor defecto "prefix+shift+h"

Intercambia el panel enfocado con el de la izquierda.

keys.swap_pane_downkeybindingpor defecto "prefix+shift+j"

Intercambia el panel enfocado con el de abajo.

keys.swap_pane_upkeybindingpor defecto "prefix+shift+k"

Intercambia el panel enfocado con el de arriba.

keys.swap_pane_rightkeybindingpor defecto "prefix+shift+l"

Intercambia el panel enfocado con el de la derecha.

keys.cycle_pane_nextkeybindingpor defecto "prefix+tab"

Pasa al panel siguiente.

keys.cycle_pane_previouskeybindingpor defecto "prefix+shift+tab"

Pasa al panel anterior.

keys.last_panekeybindingpor defecto sin valor

Enfoca el último panel enfocado, en cualquier espacio de trabajo o pestaña. Sin atajo por defecto.

keys.split_verticalkeybindingpor defecto "prefix+v"

Divide el panel en vertical (lado a lado).

keys.split_horizontalkeybindingpor defecto "prefix+minus"

Divide el panel en horizontal (apilados).

keys.close_panekeybindingpor defecto "prefix+x"

Cierra el panel enfocado.

keys.zoomkeybindingpor defecto "prefix+z"

Amplía o restaura el panel enfocado. Se acepta el nombre antiguo fullscreen como alias.

keys.resize_modekeybindingpor defecto "prefix+r"

Entra en el modo redimensionado.

keys.resize_pane_leftkeybindingpor defecto sin valor

Redimensiona el panel enfocado hacia la izquierda. Sin atajo por defecto.

keys.resize_pane_downkeybindingpor defecto sin valor

Redimensiona el panel enfocado hacia abajo. Sin atajo por defecto.

keys.resize_pane_upkeybindingpor defecto sin valor

Redimensiona el panel enfocado hacia arriba. Sin atajo por defecto.

keys.resize_pane_rightkeybindingpor defecto sin valor

Redimensiona el panel enfocado hacia la derecha. Sin atajo por defecto.

keys.toggle_sidebarkeybindingpor defecto "prefix+b"

Pliega o despliega la barra lateral.

keys.indexed.tabsstringpor defecto sin valor

Combinación de modificadores para los atajos de pestaña 1-9. Sin valor por defecto.

keys.indexed.workspacesstringpor defecto sin valor

Combinación de modificadores para los atajos de espacio de trabajo 1-9. Sin valor por defecto.

keys.indexed.agentsstringpor defecto sin valor

Combinación de modificadores para los atajos de agente 1-9. Sin valor por defecto.

Interfaz y barra lateral

ui.sidebar_widthintegerpor defecto 26

Ancho por defecto de la barra lateral desplegada, en columnas. Se ajusta según los nombres de los espacios de trabajo.

ui.sidebar_min_widthintegerpor defecto 18

Ancho mínimo de la barra lateral desplegada, en columnas.

ui.sidebar_max_widthintegerpor defecto 36

Ancho máximo de la barra lateral desplegada, en columnas.

ui.sidebar_start_collapsedbooleanpor defecto false

Arranca Herdr con la barra lateral plegada. Se aplica en el siguiente arranque.

ui.sidebar_collapsed_modeenumpor defecto compact

Presentación de la barra lateral plegada.

Valores: compact, hidden

ui.mobile_width_thresholdintegerpor defecto 64

Ancho de terminal a partir del cual (inclusive) Herdr usa la disposición móvil de una columna.

ui.mouse_capturebooleanpor defecto true

Captura el ratón para la interfaz de Herdr.

ui.copy_on_selectbooleanpor defecto true

Copia automáticamente el texto seleccionado con arrastre o doble clic. Desactivado, Ctrl+C o un Cmd+C reenviado por la terminal copia y borra la selección retenida.

ui.host_cursorenumpor defecto auto

Política del cursor de la terminal exterior.

Valores: auto, native, drawn

ui.right_click_passthrough_modifierstringpor defecto ""

Modificador que deja pasar los gestos de clic derecho a las aplicaciones del panel. Vacío lo desactiva. Acepta ctrl, alt, cmd, super, meta, hyper o una combinación separada por +; shift se rechaza porque muchas terminales reservan Mayús+ratón.

ui.redraw_on_focus_gainedbooleanpor defecto true

Fuerza un repintado completo cuando la terminal exterior recupera el foco.

ui.mouse_scroll_linesintegerpor defecto 3

Líneas que se desplazan por cada paso de la rueda del ratón.

ui.confirm_closebooleanpor defecto true

Pide confirmación antes de cerrar un espacio de trabajo.

ui.prompt_new_tab_namebooleanpor defecto true

Pide un nombre antes de crear una pestaña.

ui.prompt_new_workspace_namebooleanpor defecto false

Pide un nombre antes de crear un espacio de trabajo desde la interfaz.

ui.pane_bordersenumpor defecto "auto"

Dibuja bordes alrededor de los paneles divididos. auto los dibuja solo en paneles divididos, always enmarca también un panel único (solo con pane_outer_borders activo, ya que todos sus bordes son exteriores), off los desactiva. Los booleanos antiguos siguen valiendo: true equivale a auto y false a off.

Valores: auto, always, off

ui.pane_outer_bordersbooleanpor defecto true

Dibuja bordes en el contorno exterior del área de paneles. Desactívalo junto con pane_gaps para divisores internos al estilo tmux sin marco exterior.

ui.pane_scrollbarsbooleanpor defecto true

Dibuja barras de desplazamiento interactivas junto a los paneles. Desactívalo para recuperar esa columna y dejarla fuera de las selecciones nativas de la terminal.

ui.pane_gapsbooleanpor defecto true

Mantiene los paneles divididos separados visualmente en vez de compartir los bordes divisores.

ui.show_agent_labels_on_pane_bordersbooleanpor defecto false

Muestra las etiquetas de agente en los bordes de los paneles divididos cuando no hay etiqueta manual.

ui.hide_tab_bar_when_single_tabbooleanpor defecto false

Oculta la fila de pestañas cuando el espacio de trabajo tiene una sola.

ui.tab_bar_positionenumpor defecto "top"

Coloca la fila de pestañas de escritorio encima o debajo de los paneles.

Valores: top, bottom

ui.tab_bar_rightarraypor defecto []

Entradas ordenadas del área derecha de la fila de pestañas. Los tipos admitidos son zoom, hostname, datetime, text y command.

Valores: zoom, hostname, datetime, text, command

ui.tab_bar_right_separatorstringpor defecto " "

Texto que se inserta entre las entradas visibles del área derecha de la fila de pestañas.

ui.window_titlestringpor defecto "{hostname}: {workspace}"

Título que Herdr escribe en la terminal donde corre. Tokens: {hostname}, {workspace}, {tab}, {pane}, {terminal_title}. Vacío no toca el título exterior.

ui.agent_panel_sortenumpor defecto "spaces"

Orden del panel de agentes. Los valores guardados son "spaces" o "priority"; "workspaces" se acepta como alias de "spaces".

Valores: spaces, priority

ui.status_indicatorsenumpor defecto "dots"

Puntos de color compactos o símbolos estáticos distintos para los estados de los agentes.

Valores: dots, symbols

ui.sidebar.agents.row_gapintegerpor defecto 0

Filas de terminal en blanco entre las entradas de agente de la barra lateral desplegada. Ponlo a 1 para recuperar el espaciado anterior.

ui.sidebar.agents.rowslist of token rowspor defecto [["state_icon", "machine", "workspace", "tab"], ["agent"]]

Disposición por defecto de las filas de agente en la barra lateral desplegada. Las entradas pueden ser cadenas de token o tablas de estilo en línea { token, fg, bold, dim, rules }. Los tokens integrados de texto y los metadatos $name aceptan hasta 16 reglas ordenadas con equals, contains, starts_with, gt o lt; la primera coincidencia sustituye los estilos indicados. Las condiciones de texto aceptan ignore_case para comparar en ASCII; las numéricas requieren números finitos completos. state_icon solo acepta estilos fijos. Como mucho 16 filas y 16 tokens por fila.

ui.sidebar.agents.rows_by_agenttable of token rowspor defecto {}

Sustituciones completas de las filas de agente, por id canónico estricto de agente. Los agentes sin sustitución usan ui.sidebar.agents.rows.

ui.sidebar.spaces.row_gapintegerpor defecto 0

Filas de terminal en blanco entre grupos de worktree y espacios de nivel superior no relacionados. Los padres de worktree y sus hijos indentados siguen juntos.

ui.sidebar.spaces.rowslist of token rowspor defecto [["state_icon", "workspace"], ["branch", "git_status"]]

Disposición de las filas de espacio en la barra lateral desplegada. Las entradas pueden ser cadenas de token o tablas de estilo en línea { token, fg, bold, dim, rules }. Los tokens integrados de texto y los metadatos $name aceptan hasta 16 reglas ordenadas con equals, contains, starts_with, gt o lt; la primera coincidencia sustituye los estilos indicados. Las condiciones de texto aceptan ignore_case para comparar en ASCII; las numéricas requieren números finitos completos. state_icon y git_status solo aceptan estilos fijos. Como mucho 16 filas y 16 tokens por fila.

ui.accentcolorpor defecto "cyan"

Color de acento para resaltados, bordes y navegación. Acepta hexadecimal (#89b4fa), colores con nombre (cyan, blue) o RGB (rgb(137,180,250)).

Notificaciones

ui.toast.deliveryenumpor defecto "off"

Entrega de las notificaciones emergentes. off las desactiva, herdr muestra avisos dentro de la aplicación, terminal pide a la terminal exterior una notificación de escritorio, system se la pide directamente al servicio de notificaciones del sistema.

Valores: off, herdr, terminal, system

ui.toast.delay_secondsintegerpor defecto 1

Segundos de espera antes de enviar las notificaciones de agente terminado o que necesita entrada. Herdr solo notifica si el panel sigue en el mismo estado al expirar la espera. 0 es inmediato; los valores válidos van de 0 a 3600.

ui.toast.herdr.positionenumpor defecto "bottom-right"

Posición de los avisos dentro de la aplicación, respecto al marco completo de Herdr.

Valores: top-left, top-right, bottom-left, bottom-right

ui.toast.clipboard.enabledbooleanpor defecto true

Muestra el aviso de copiado al portapapeles después de copiar con el ratón.

ui.toast.clipboard.positionenumpor defecto "bottom-center"

Posición del aviso de copiado al portapapeles.

Valores: top-left, top-center, top-right, bottom-left, bottom-center, bottom-right

Sonido

ui.sound.enabledbooleanpor defecto true

Reproduce sonidos cuando los agentes cambian de estado en espacios de trabajo en segundo plano.

ui.sound.pathpathpor defecto sin valor

Ruta opcional de un fichero mp3 para todos los sonidos de notificación. Las rutas relativas se resuelven desde el directorio del fichero de configuración.

ui.sound.done_pathpathpor defecto sin valor

Ruta opcional de un fichero mp3 para las notificaciones de «hecho». Las rutas relativas se resuelven desde el directorio del fichero de configuración.

ui.sound.request_pathpathpor defecto sin valor

Ruta opcional de un fichero mp3 para las notificaciones de «petición». Las rutas relativas se resuelven desde el directorio del fichero de configuración.

ui.sound.agents.pienumpor defecto "default"

Sonido para los agentes Pi detectados.

Valores: default, on, off

ui.sound.agents.claudeenumpor defecto "default"

Sonido para los agentes Claude Code detectados.

Valores: default, on, off

ui.sound.agents.codexenumpor defecto "default"

Sonido para los agentes Codex detectados.

Valores: default, on, off

ui.sound.agents.geminienumpor defecto "default"

Sonido para los agentes Gemini CLI detectados.

Valores: default, on, off

ui.sound.agents.cursorenumpor defecto "default"

Sonido para los agentes Cursor Agent CLI detectados.

Valores: default, on, off

ui.sound.agents.devinenumpor defecto "default"

Sonido para los agentes Devin detectados.

Valores: default, on, off

ui.sound.agents.agyenumpor defecto "default"

Sonido para los agentes Agy detectados.

Valores: default, on, off

ui.sound.agents.clineenumpor defecto "default"

Sonido para los agentes Cline detectados.

Valores: default, on, off

ui.sound.agents.open_codeenumpor defecto "default"

Sonido para los agentes OpenCode detectados.

Valores: default, on, off

ui.sound.agents.github_copilotenumpor defecto "default"

Sonido para los agentes GitHub Copilot CLI detectados.

Valores: default, on, off

ui.sound.agents.kimienumpor defecto "default"

Sonido para los agentes Kimi Code CLI detectados.

Valores: default, on, off

ui.sound.agents.kiroenumpor defecto "default"

Sonido para los agentes Kiro detectados.

Valores: default, on, off

ui.sound.agents.droidenumpor defecto "off"

Sonido para los agentes Droid detectados.

Valores: default, on, off

ui.sound.agents.ampenumpor defecto "default"

Sonido para los agentes Amp detectados.

Valores: default, on, off

ui.sound.agents.grokenumpor defecto "default"

Sonido para los agentes Grok CLI detectados.

Valores: default, on, off

ui.sound.agents.hermesenumpor defecto "default"

Sonido para los agentes Hermes Agent detectados.

Valores: default, on, off

ui.sound.agents.kiloenumpor defecto "default"

Sonido para los agentes Kilo Code CLI detectados.

Valores: default, on, off

ui.sound.agents.qoderclienumpor defecto "default"

Sonido para los agentes Qoder CLI detectados.

Valores: default, on, off

ui.sound.agents.qwenenumpor defecto "default"

Sonido para los agentes Qwen Code detectados.

Valores: default, on, off

ui.sound.agents.lettaenumpor defecto "default"

Sonido para los agentes Letta Code detectados.

Valores: default, on, off

ui.sound.agents.makienumpor defecto "default"

Sonido para los agentes Maki detectados.

Valores: default, on, off

ui.sound.agents.museenumpor defecto "default"

Sonido para los agentes Muse detectados.

Valores: default, on, off

Sesión

session.resume_agents_on_restorebooleanpor defecto true

Reanuda los paneles de agentes compatibles en su conversación nativa al restaurar una sesión de Herdr.

Worktrees

worktrees.directorystringpor defecto "~/.herdr/worktrees"

Directorio raíz bajo el que Herdr crea las copias <repo>/<slug-de-la-rama>.

Remoto

remote.manage_ssh_configbooleanpor defecto true

Añade keepalives de respaldo y reutilización privada de la conexión para herdr --remote. Con false se usa ssh a secas, sin cambios.

Avanzado

advanced.scrollback_limit_bytesintegerpor defecto 10000000

Tamaño máximo del historial en bytes que se conserva por terminal de panel. Se acepta el nombre antiguo scrollback_lines como alias.

Experimental

experimental.allow_nestedbooleanpor defecto false

Permite lanzar herdr dentro de un panel de herdr.

experimental.kitty_graphicsbooleanpor defecto sin valor

Clave obsoleta, por compatibilidad con terminal.kitty_graphics. Los valores true y false existentes siguen funcionando; terminal.kitty_graphics tiene prioridad cuando están los dos.

experimental.pane_historybooleanpor defecto false

Guarda el historial de pantalla de los paneles en session-history.json.

experimental.reveal_hidden_cursor_for_cjk_imebooleanpor defecto false

Expone a la terminal exterior el cursor de anclaje del panel enfocado aunque el panel haya pedido ?25l, para que los métodos de entrada nativos de macOS sigan colocando la ventana de candidatos cuando la interfaz pinta su propio cursor (Claude Code, pi, codex, etc.). Por defecto: false. Si el panel no informa de la posición del cursor, usa su esquina superior izquierda para que siempre haya un anclaje estable para el IME. Contrapartida: en las aplicaciones que ocultan el cursor sin pintar otro (modo normal de vim, etc.) se verá un cursor de hardware extra en la terminal exterior. Ver #149.

experimental.cjk_ime_agentslist of stringspor defecto []

Limita reveal_hidden_cursor_for_cjk_ime a los paneles enfocados cuyo agente detectado coincida con uno de estos nombres (sin distinguir mayúsculas). La lista vacía se aplica a cualquier panel enfocado. Los nombres desconocidos se ignoran; si la lista no contiene ningún nombre válido, no se aplica. Nombres aceptados: pi, claude, codex, gemini, cursor, devin, cline, opencode, copilot, kimi, kiro, droid, amp, grok, hermes, kilo, qodercli, qoder, qwen, qwen-code, letta, letta-code, maki.

experimental.cjk_ime_cursor_shapeenumpor defecto "steady_block"

Forma del cursor que se pinta como anclaje del IME cuando reveal_hidden_cursor_for_cjk_ime está activo.

Valores: block, steady_block, underline, steady_underline, bar, steady_bar

experimental.switch_ascii_input_source_in_prefixbooleanpor defecto false

Mientras el modo prefijo está activo, cambia temporalmente la fuente de entrada del sistema a un modo ASCII para que los comandos de prefijo se lean como ASCII aunque haya un IME activo, y restaura la anterior al salir del modo prefijo. En macOS selecciona la disposición de teclado ASCII; en Windows cambia el IME a entrada en inglés (ASCII). En Windows, por ahora, solo con el IME coreano; con un IME de otro idioma la fuente de entrada no cambia. Solo macOS y Windows; en el resto no hace nada, y tampoco si el cambio falla.