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:
herdr --default-configLos 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
onboardingMuestra la configuración inicial al arrancar. Si falta o es true se muestra; continuar desde ella escribe onboarding = false.
Servidor
server.headless_colsAncho 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_rowsAlto 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.nameNombre del tema integrado.
theme.auto_switchSigue la apariencia clara u oscura de la terminal y cambia entre nombres de tema.
theme.dark_nameTema usado cuando
auto_switchdetecta apariencia oscura.theme.light_nameTema usado cuando
auto_switchdetecta apariencia clara.theme.custom.accentSustituye el color accent sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.panel_bgSustituye el color panel_bg sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.sidebar_bgFondo 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_bgFondo 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_bgFondo 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.surface0Sustituye el color surface0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.surface1Sustituye el color surface1 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.surface_dimSustituye el color surface_dim sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.overlay0Sustituye el color overlay0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.overlay1Sustituye el color overlay1 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.textSustituye el color text sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.subtext0Sustituye el color subtext0 sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.mauveSustituye el color mauve sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.greenSustituye el color green sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.yellowSustituye el color yellow sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.redSustituye el color red sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.blueSustituye el color blue sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.tealSustituye el color teal sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.peachSustituye el color peach sobre el tema base. Acepta hexadecimal, colores con nombre, rgb(r,g,b) o alias de restablecimiento.
theme.custom.light.accentSustituye 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_bgSustituye 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_bgSustituye 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_bgSustituye 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_bgSustituye 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.surface0Sustituye 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.surface1Sustituye 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_dimSustituye 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.overlay0Sustituye 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.overlay1Sustituye 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.textSustituye 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.subtext0Sustituye 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.mauveSustituye 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.greenSustituye 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.yellowSustituye 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.redSustituye 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.blueSustituye 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.tealSustituye 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.peachSustituye 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.accentSustituye 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_bgSustituye 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_bgSustituye 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_bgSustituye 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_bgSustituye 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.surface0Sustituye 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.surface1Sustituye 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_dimSustituye 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.overlay0Sustituye 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.overlay1Sustituye 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.textSustituye 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.subtext0Sustituye 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.mauveSustituye 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.greenSustituye 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.yellowSustituye 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.redSustituye 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.blueSustituye 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.tealSustituye 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.peachSustituye 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_shellEjecutable 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_modeModo de arranque de los shells de los paneles interactivos nuevos.
Valores:
auto,login,non_loginterminal.new_cwdPolítica de directorio de trabajo para paneles, pestañas y espacios de trabajo nuevos.
Valores:
follow,home,current,pathterminal.kitty_graphicsPinta 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.channelCanal 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,previewupdate.version_checkComprueba en herdr.dev, en segundo plano, si hay versiones nuevas de Herdr.
update.manifest_checkComprueba 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.prefixTecla de prefijo para entrar en el modo prefijo (p. ej. "ctrl+b", "f12", "esc").
keys.helpAbre la ayuda de atajos.
keys.settingsAbre los ajustes.
keys.new_workspaceCrea un espacio de trabajo nuevo.
keys.new_worktreeCrea un worktree de Git desde el espacio de trabajo seleccionado.
keys.open_worktreeAbre un worktree de Git existente desde el espacio de trabajo seleccionado. Sin atajo por defecto.
keys.remove_worktreeBorra, tras confirmar, la copia del worktree gestionado seleccionado. Sin atajo por defecto.
keys.rename_workspaceRenombra el espacio de trabajo seleccionado.
keys.close_workspaceCierra el espacio de trabajo seleccionado.
keys.workspace_pickerAbre la navegación de espacios de trabajo.
keys.gotoAbre el navegador de la sesión.
keys.navigate_workspace_upSube la selección de espacio de trabajo en el modo navegación.
keys.navigate_workspace_downBaja la selección de espacio de trabajo en el modo navegación.
keys.navigate_pane_leftEnfoca el panel de la izquierda en el modo navegación. La flecha izquierda es siempre un alias.
keys.navigate_pane_downEnfoca el panel de abajo en el modo navegación.
keys.navigate_pane_upEnfoca el panel de arriba en el modo navegación.
keys.navigate_pane_rightEnfoca el panel de la derecha en el modo navegación. La flecha derecha es siempre un alias.
keys.detachDesconecta el cliente actual de su servidor de Herdr.
keys.reload_configRecarga config.toml en la aplicación y el servidor en marcha.
keys.open_notification_targetEnfoca el destino de la notificación visible.
keys.previous_workspaceSelecciona el espacio de trabajo anterior. Sin atajo por defecto.
keys.next_workspaceSelecciona el espacio de trabajo siguiente. Sin atajo por defecto.
keys.previous_agentEnfoca el agente anterior del panel de agentes. Sin atajo por defecto.
keys.next_agentEnfoca el agente siguiente del panel de agentes. Sin atajo por defecto.
keys.focus_agentEnfoca un agente por índice 1-9. Sin atajo por defecto.
keys.remote_image_pasteAtajo del cliente local que envía una imagen del portapapeles a una sesión remota de Herdr.
keys.new_tabCrea una pestaña nueva en el espacio de trabajo activo.
keys.rename_tabRenombra la pestaña activa.
keys.previous_tabSelecciona la pestaña anterior.
keys.next_tabSelecciona la pestaña siguiente.
keys.move_tab_previousMueve la pestaña activa una posición hacia el principio. Sin atajo por defecto.
keys.move_tab_nextMueve la pestaña activa una posición hacia el final. Sin atajo por defecto.
keys.switch_tabCambia a la pestaña 1-9.
keys.switch_workspaceCambia al espacio de trabajo 1-9 desde el modo prefijo. Sin atajo por defecto.
keys.close_tabCierra la pestaña activa.
keys.rename_paneRenombra el panel enfocado.
keys.edit_scrollbackAbre el historial del panel enfocado en $EDITOR.
keys.clear_paneVací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_modeEntra en el modo copia con teclado del panel enfocado.
keys.focus_pane_leftEnfoca el panel de la izquierda.
keys.focus_pane_downEnfoca el panel de abajo.
keys.focus_pane_upEnfoca el panel de arriba.
keys.focus_pane_rightEnfoca el panel de la derecha.
keys.swap_pane_leftIntercambia el panel enfocado con el de la izquierda.
keys.swap_pane_downIntercambia el panel enfocado con el de abajo.
keys.swap_pane_upIntercambia el panel enfocado con el de arriba.
keys.swap_pane_rightIntercambia el panel enfocado con el de la derecha.
keys.cycle_pane_nextPasa al panel siguiente.
keys.cycle_pane_previousPasa al panel anterior.
keys.last_paneEnfoca el último panel enfocado, en cualquier espacio de trabajo o pestaña. Sin atajo por defecto.
keys.split_verticalDivide el panel en vertical (lado a lado).
keys.split_horizontalDivide el panel en horizontal (apilados).
keys.close_paneCierra el panel enfocado.
keys.zoomAmplía o restaura el panel enfocado. Se acepta el nombre antiguo
fullscreencomo alias.keys.resize_modeEntra en el modo redimensionado.
keys.resize_pane_leftRedimensiona el panel enfocado hacia la izquierda. Sin atajo por defecto.
keys.resize_pane_downRedimensiona el panel enfocado hacia abajo. Sin atajo por defecto.
keys.resize_pane_upRedimensiona el panel enfocado hacia arriba. Sin atajo por defecto.
keys.resize_pane_rightRedimensiona el panel enfocado hacia la derecha. Sin atajo por defecto.
keys.toggle_sidebarPliega o despliega la barra lateral.
keys.indexed.tabsCombinación de modificadores para los atajos de pestaña 1-9. Sin valor por defecto.
keys.indexed.workspacesCombinación de modificadores para los atajos de espacio de trabajo 1-9. Sin valor por defecto.
keys.indexed.agentsCombinación de modificadores para los atajos de agente 1-9. Sin valor por defecto.
Interfaz y barra lateral
ui.sidebar_widthAncho por defecto de la barra lateral desplegada, en columnas. Se ajusta según los nombres de los espacios de trabajo.
ui.sidebar_min_widthAncho mínimo de la barra lateral desplegada, en columnas.
ui.sidebar_max_widthAncho máximo de la barra lateral desplegada, en columnas.
ui.sidebar_start_collapsedArranca Herdr con la barra lateral plegada. Se aplica en el siguiente arranque.
ui.sidebar_collapsed_modePresentación de la barra lateral plegada.
Valores:
compact,hiddenui.mobile_width_thresholdAncho de terminal a partir del cual (inclusive) Herdr usa la disposición móvil de una columna.
ui.mouse_captureCaptura el ratón para la interfaz de Herdr.
ui.copy_on_selectCopia 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_cursorPolítica del cursor de la terminal exterior.
Valores:
auto,native,drawnui.right_click_passthrough_modifierModificador 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_gainedFuerza un repintado completo cuando la terminal exterior recupera el foco.
ui.mouse_scroll_linesLíneas que se desplazan por cada paso de la rueda del ratón.
ui.confirm_closePide confirmación antes de cerrar un espacio de trabajo.
ui.prompt_new_tab_namePide un nombre antes de crear una pestaña.
ui.prompt_new_workspace_namePide un nombre antes de crear un espacio de trabajo desde la interfaz.
ui.pane_bordersDibuja 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,offui.pane_outer_bordersDibuja 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_scrollbarsDibuja 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_gapsMantiene los paneles divididos separados visualmente en vez de compartir los bordes divisores.
ui.show_agent_labels_on_pane_bordersMuestra las etiquetas de agente en los bordes de los paneles divididos cuando no hay etiqueta manual.
ui.hide_tab_bar_when_single_tabOculta la fila de pestañas cuando el espacio de trabajo tiene una sola.
ui.tab_bar_positionColoca la fila de pestañas de escritorio encima o debajo de los paneles.
Valores:
top,bottomui.tab_bar_rightEntradas 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,commandui.tab_bar_right_separatorTexto que se inserta entre las entradas visibles del área derecha de la fila de pestañas.
ui.window_titleTí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_sortOrden del panel de agentes. Los valores guardados son "spaces" o "priority"; "workspaces" se acepta como alias de "spaces".
Valores:
spaces,priorityui.status_indicatorsPuntos de color compactos o símbolos estáticos distintos para los estados de los agentes.
Valores:
dots,symbolsui.sidebar.agents.row_gapFilas 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.rowsDisposició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_agentSustituciones 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_gapFilas 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.rowsDisposició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.accentColor 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.deliveryEntrega 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,systemui.toast.delay_secondsSegundos 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.positionPosición de los avisos dentro de la aplicación, respecto al marco completo de Herdr.
Valores:
top-left,top-right,bottom-left,bottom-rightui.toast.clipboard.enabledMuestra el aviso de copiado al portapapeles después de copiar con el ratón.
ui.toast.clipboard.positionPosición del aviso de copiado al portapapeles.
Valores:
top-left,top-center,top-right,bottom-left,bottom-center,bottom-right
Sonido
ui.sound.enabledReproduce sonidos cuando los agentes cambian de estado en espacios de trabajo en segundo plano.
ui.sound.pathRuta 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_pathRuta 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_pathRuta 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.piSonido para los agentes Pi detectados.
Valores:
default,on,offui.sound.agents.claudeSonido para los agentes Claude Code detectados.
Valores:
default,on,offui.sound.agents.codexSonido para los agentes Codex detectados.
Valores:
default,on,offui.sound.agents.geminiSonido para los agentes Gemini CLI detectados.
Valores:
default,on,offui.sound.agents.cursorSonido para los agentes Cursor Agent CLI detectados.
Valores:
default,on,offui.sound.agents.devinSonido para los agentes Devin detectados.
Valores:
default,on,offui.sound.agents.agySonido para los agentes Agy detectados.
Valores:
default,on,offui.sound.agents.clineSonido para los agentes Cline detectados.
Valores:
default,on,offui.sound.agents.open_codeSonido para los agentes OpenCode detectados.
Valores:
default,on,offui.sound.agents.github_copilotSonido para los agentes GitHub Copilot CLI detectados.
Valores:
default,on,offui.sound.agents.kimiSonido para los agentes Kimi Code CLI detectados.
Valores:
default,on,offui.sound.agents.kiroSonido para los agentes Kiro detectados.
Valores:
default,on,offui.sound.agents.droidSonido para los agentes Droid detectados.
Valores:
default,on,offui.sound.agents.ampSonido para los agentes Amp detectados.
Valores:
default,on,offui.sound.agents.grokSonido para los agentes Grok CLI detectados.
Valores:
default,on,offui.sound.agents.hermesSonido para los agentes Hermes Agent detectados.
Valores:
default,on,offui.sound.agents.kiloSonido para los agentes Kilo Code CLI detectados.
Valores:
default,on,offui.sound.agents.qodercliSonido para los agentes Qoder CLI detectados.
Valores:
default,on,offui.sound.agents.qwenSonido para los agentes Qwen Code detectados.
Valores:
default,on,offui.sound.agents.lettaSonido para los agentes Letta Code detectados.
Valores:
default,on,offui.sound.agents.makiSonido para los agentes Maki detectados.
Valores:
default,on,offui.sound.agents.museSonido para los agentes Muse detectados.
Valores:
default,on,off
Sesión
session.resume_agents_on_restoreReanuda los paneles de agentes compatibles en su conversación nativa al restaurar una sesión de Herdr.
Worktrees
worktrees.directoryDirectorio raíz bajo el que Herdr crea las copias <repo>/<slug-de-la-rama>.
Remoto
remote.manage_ssh_configAñ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_bytesTamaño máximo del historial en bytes que se conserva por terminal de panel. Se acepta el nombre antiguo
scrollback_linescomo alias.
Experimental
experimental.allow_nestedPermite lanzar herdr dentro de un panel de herdr.
experimental.kitty_graphicsClave 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_historyGuarda el historial de pantalla de los paneles en session-history.json.
experimental.reveal_hidden_cursor_for_cjk_imeExpone 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_agentsLimita
reveal_hidden_cursor_for_cjk_imea 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_shapeForma del cursor que se pinta como anclaje del IME cuando
reveal_hidden_cursor_for_cjk_imeestá activo.Valores:
block,steady_block,underline,steady_underline,bar,steady_barexperimental.switch_ascii_input_source_in_prefixMientras 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.
Ninguna clave coincide con el filtro.