Saltar al contenido
PaneflowPaneflow

Ajustes

Entiende qué controla el panel Settings de Paneflow, qué escribe en paneflow.json y qué claves avanzadas siguen siendo solo de configuración.

El panel Settings de Paneflow es la interfaz humana para las preferencias comunes. No es la referencia completa de configuración. Úsalo para los ajustes que cambias a menudo: editor, shell, tema, atajos, notificaciones, visualización del terminal, templates de workspace, lanzadores de agentes, acceso IA y setup MCP.

TL;DR. La mayoría de filas de Settings escriben en paneflow.json y se recargan en caliente después de guardar el archivo. Plugins es distinto: instala o repara el bridge MCP de Paneflow en configs de agentes compatibles. Las claves avanzadas siguen disponibles en paneflow.json.

Mapa de ajustes

PáginaQué controlaEscribe enCuándo aplica
GeneralEditor externo por defecto y shell por defecto para nuevos paneles de terminal.external_editor, default_shellNuevos lanzamientos. Los terminales en ejecución mantienen su proceso actual.
AppearanceLight, Dark, System, el preset de tema, Comfortable density, Interface style, Workspace icon, Background style en Windows, macOS y Linux, App icon, más controles dedicados de material de sidebar para Windows, macOS y Linux.theme, comfortable_density, interface_style, workspace_icon, app_icon, windows_chrome_material, windows_terminal_material, macos_chrome_material, linux_chrome_material, linux_terminal_materialLos cambios de tema, densidad, estilo, icono y material se recargan en caliente.
Keyboard ShortcutsBindings de acciones y restablecimiento a valores por defecto.shortcutsSe recarga después de guardar la config.
NotificationsNotificaciones nativas del OS para agentes en espera y para las notificaciones que envían los programas de terminal.agent_panel.notify_when_agent_waitingRecarga en caliente.
TerminalForma y color del cursor, familia de fuente, tamaño, grosor, altura de línea, ancho de celda, glifos integrados, emoji en color, contraste mínimo y material de terminal para Windows y Linux.terminal.cursor_shape, terminal.cursor_color, font_family, font_size, font_weight, line_height, cell_width, terminal.integrated_glyphs, terminal.color_emoji, terminal.minimum_contrast, windows_terminal_material, linux_terminal_materialLos controles visuales se recargan en caliente. La forma del cursor aplica al siguiente terminal nuevo.
WorkspacesTemplates de workspace reutilizables con paneles, agentes, comandos shell, cwd, env y prompt prefijado.commands[].workspaceLos templates pasan por la misma ruta de lanzamiento de workspace que paneflow up.
SpacesLos espacios que agrupan los espacios de trabajo: Default primero y después cada espacio con su nombre, imagen, color, variables de entorno, el estado de los hooks y del MCP de Claude Code y Codex en los directorios de configuración que define, y una acción de eliminar que, tras una confirmación, mueve sus espacios de trabajo a Default. Hasta 9 espacios.spaces; las imágenes van a avatars/ en el home de PaneflowLos nombres, las imágenes y los colores se recargan en caliente. Un entorno se aplica a los terminales abiertos después del cambio.
WorktreesDirectorio raíz de los worktrees que crea Paneflow, eliminación automática con un límite de conservación, la lista de worktrees gestionados con acción de eliminar y los snapshots tomados antes de una eliminación con acciones de restaurar y eliminar.worktrees.dir, worktrees.auto_remove, worktrees.keep_limitRecarga en caliente. La raíz se aplica a los worktrees creados a partir de entonces.
AgentsQué agentes muestra el lanzador, con su versión instalada y su estado de hooks, un interruptor Paneflow hooks para Claude Code y Codex, perfiles de agente personalizados, acceso completo de Claude Code, acceso libre IA y injection fence.*_button_visible, agent_profiles, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence; el interruptor Paneflow hooks escribe la config de hooks del agenteLos cambios de lanzador y acceso se recargan en caliente.
PluginsInstala o repara el bridge paneflow-mcp incluido para Claude Code, Codex, Gemini y opencode.Archivos de config de agentes, no paneflow.jsonVuelve a ejecutarlo tras una actualización de Paneflow o cuando cambie una config de agente.

Estilo de interfaz

Settings > Appearance ofrece Interface style bajo el preset de tema, y la paleta de comandos ofrece la misma opción bajo Interface style. Elige la disposición y el lenguaje de esquinas de toda la aplicación y se guarda en interface_style.

EstiloQué dibuja
Classic (predeterminado)Una ventana de borde a borde: la sidebar, los paneles y el dock Changes llegan hasta los bordes de la ventana con líneas finas entre ellos, las pestañas de los paneles superiores y del dock se sitúan en la barra de título junto a los controles de la ventana, y la parte vacía de esa fila arrastra la ventana. Esquinas circulares en una escala ajustada: 12 px en diálogos y avisos, y 8 px en filas, botones y pestañas de panel. Comfortable density no tiene efecto.
RoundedEl aspecto de Paneflow 0.19 y anteriores: tarjetas de panel con esquinas continuas (squircles) y radios generosos, flotando bajo una barra de título de ancho completo. Comfortable density solo se aplica a este estilo.

En los dos estilos, cada menú y cada lista desplegable es un panel de 8 px con filas de 28 px, etiquetas de 14 px y atajos de 12 px. La paleta de comandos y el diálogo Clone repository se ven igual en los dos estilos. El cambio se aplica al instante a todas las ventanas abiertas. Paneflow abre en Classic a partir de 0.20.0; para conservar las tarjetas de panel flotantes, elige Rounded o define "interface_style": "rounded".

Estilo de fondo

En Windows, macOS y Linux, Settings > Appearance ofrece Background style bajo el estilo de interfaz, y la paleta de comandos ofrece la misma opción bajo Background style. Activa o desactiva a la vez todos los materiales de ventana de la plataforma. Hasta 0.19 este ajuste se llamaba Interface style; conserva sus valores y sus claves.

EstiloWindowsmacOSLinux
Themed (predeterminado)windows_chrome_material y windows_terminal_material en false: los colores sólidos del tema.macos_chrome_material en false: una sidebar opaca.linux_chrome_material y linux_terminal_material en false: una ventana opaca.
BlendedAmbos en true: Mica se transparenta a través de la sidebar y el terminal.macos_chrome_material en true: el material Sidebar nativo aparece detrás de la sidebar.Ambos en true: el escritorio se transparenta a través de un velo detrás de la sidebar y otro más denso detrás del terminal.

En Linux, con "window_backdrop": "blurred", Paneflow pide a un compositor Wayland que ofrezca ext-background-effect o el desenfoque de KDE que desenfoque lo que hay detrás de la ventana translúcida, siguiendo sus esquinas redondeadas. En los demás casos, X11 y GNOME incluidos, Paneflow no solicita desenfoque: puede aportarlo el compositor, por ejemplo la extensión Blur my Shell en GNOME. Sin ella, el fondo de pantalla se ve nítido a través del velo.

No existe una clave background_style: Paneflow deduce el estilo de esos ajustes. Cuando no coinciden, por ejemplo tras activar uno a mano, la fila muestra Custom.

Icono del espacio de trabajo

Settings > Appearance ofrece Workspace icon, y la paleta de comandos ofrece la misma opción bajo Workspace icon. Elige el glifo delante de cada espacio de trabajo en la sidebar y se guarda en workspace_icon. Default conserva la carpeta con contorno de Paneflow. Standard sustituye la carpeta por un chevrón de despliegue, hacia la derecha cuando el espacio de trabajo está plegado y hacia abajo cuando está abierto. Metal es una carpeta de cristal rellena, Windows una carpeta con degradado amarillo, Windows 95 la carpeta pixelada de 16 colores y Pixel una carpeta pixelada con contorno. Cada estilo tiene un glifo cerrado y uno abierto, y los dos estilos pixelados se ven más nítidos con una escala de pantalla del 100 % o del 200 %.

Icono de la aplicación

Settings > Appearance ofrece App icon al final de la tarjeta del tema. Elige el icono que Paneflow muestra para sus ventanas en ejecución y se guarda en app_icon. La fila muestra el icono actual y su nombre; haz clic en ella para desplegar una galería con todos los iconos y elige uno para aplicarlo al instante.

IconoQué dibuja
Glass (predeterminado)El icono instalado: tres paneles de cristal sobre una baldosa violeta.
BlackLa marca de Paneflow en barras horizontales blanco roto sobre una baldosa negra.
WhiteLas mismas barras en tinta oscura sobre una baldosa blanca.
Black solidLos tres paneles como formas sólidas blanco roto sobre una baldosa negra.
White solidLos mismos paneles sólidos en tinta oscura sobre una baldosa blanca.

Les siguen dieciséis iconos ilustrados. Cada uno muestra la misma marca en otro material.

Iconoapp_iconQué dibuja
AubergineauberginePaneles lila sobre una baldosa berenjena intensa.
PaperpaperPaneles en tinta berenjena sobre una baldosa de papel blanco roto.
Midnight mattemidnight-mattePaneles gris oscuro sobre una baldosa negra mate.
PolarpolarPaneles azules y cian sobre una baldosa blanco hielo.
MelonmelonPaneles coral y naranja sobre una baldosa crema.
HoneydewhoneydewPaneles verde oscuro sobre una baldosa menta y lima.
BerryberryPaneles ciruela sobre una baldosa violeta y rosa.
RainbowrainbowPaneles en seis franjas retro sobre una baldosa negra.
SolarwavesolarwaveBandas de atardecer cromadas sobre una baldosa púrpura intensa.
NeonneonContornos de neón cian y rosa sobre una baldosa violeta oscura.
PhosphorphosphorPaneles verdes luminosos sobre una baldosa de pantalla negra.
HoloholoPaneles oscuros sobre una baldosa de lámina iridiscente.
AmethystamethystPaneles lila sobre una gema violeta facetada.
BlueprintblueprintPaneles azul pálido sobre una baldosa de plano técnico.
ChipchipPaneles de metal cepillado sobre un chip, montado en una placa de circuito verde.
NostalgianostalgiaPaneles blanco cromado sobre una baldosa azul brillante.
PlataformaDónde aparece la elecciónCuándo
WindowsEl botón de la barra de tareas, Alt+Tab y los accesos directos de tu perfil que abren este Paneflow: el anclado a la barra de tareas, un acceso directo del escritorio, la entrada del menú Inicio.Alt+Tab al instante. El botón de la barra de tareas en el siguiente inicio de sesión o reinicio del Explorador de Windows. Un acceso directo conserva el icono mientras Paneflow está cerrado.
macOSEl Dock y el selector de aplicaciones, mientras Paneflow se ejecuta.Al instante.
Linux, X11El icono de ventana que leen el gestor de ventanas y el selector de tareas.Las ventanas abiertas después del cambio; reinicia Paneflow para aplicarlo a todas.
Linux, WaylandEn ninguna parte: el compositor toma el icono de la entrada de escritorio instalada.Nunca.

En Windows, un botón anclado a la barra de tareas muestra el icono de su acceso directo, no el de la ventana, así que Paneflow apunta ese acceso directo a un archivo de icono que escribe en icons/ dentro del home de Paneflow, y lo vuelve a comprobar en cada lanzamiento. Windows guarda en caché la imagen de un botón de la barra de tareas y solo vuelve a leer el acceso directo cuando recarga la barra de tareas, así que el botón cambia en el siguiente inicio de sesión, o cuando se reinicia el Explorador de Windows. Elegir Glass restaura el icono propio del acceso directo.

El acceso directo del menú Inicio de una instalación para toda la máquina no te pertenece. Para cualquier icono distinto de Glass, Paneflow lo copia en el mismo lugar de tu propia carpeta del menú Inicio, que Windows prefiere, y le da el icono a esa copia; elegir Glass borra la copia. Si desinstalas Paneflow con otro icono seleccionado, la copia se queda: bórrala de %APPDATA%\Microsoft\Windows\Start Menu\Programs.

En macOS y Linux, el lanzador instalado y el icono del Dock de un Paneflow que no se está ejecutando conservan el icono Glass.

Contraste del terminal

Paneflow aumenta el contraste del texto cuyo color ha elegido un programa cuando se parece demasiado al fondo. Settings > Terminal muestra este ajuste como Minimum contrast. La paleta de comandos ofrece los mismos valores bajo Minimum contrast.

Valor mostradoterminal.minimum_contrastEfecto
Autoclave ausenteAPCA Lc 60 para todos los temas, claros y oscuros.
Off0Sin corrección. Los programas mantienen los colores solicitados.
45, 60, 75, 90ese númeroUn objetivo APCA Lc explícito.

Los valores superiores a 90 se limitan a 90. Los valores negativos o no válidos vuelven a Auto.

Solo se corrigen los colores elegidos por un programa: truecolor y los índices de paleta del 16 al 255. Los dieciséis colores ANSI del tema, su color de texto y su fondo se mantienen. La corrección ajusta primero la luminosidad conservando el tono. Si necesita reducir demasiado la saturación, se aproxima al color del tema más cercano.

Los cambios se recargan en caliente en los terminales abiertos. Para desactivar la corrección en todos ellos, establece "minimum_contrast": 0 bajo terminal en paneflow.json.

Espacios

Spaces se abre con un botón New space junto a su introducción y, debajo, una tarjeta que lista Default en primer lugar. Default contiene todos los espacios de trabajo que no tienen espacio, indica Workspaces without a space o su número de espacios de trabajo, y no se puede renombrar ni eliminar. Le sigue una fila por espacio, con su círculo, su nombre y sus recuentos de espacios de trabajo y de variables; una fila contraída también señala Agent setup failed o sus advertencias de entorno. Haz clic en una fila para desplegarla. Solo se despliega un espacio a la vez.

CampoQué hace
NameHaz clic en el nombre para editarlo y pulsa Enter para guardar o Escape para cancelar; hacer clic en otro lugar también guarda. Un nombre debe tener de 1 a 32 caracteres, no puede ser Default y no puede repetir el nombre de otro espacio, sin distinguir mayúsculas y minúsculas. Un nombre no válido muestra el motivo bajo el campo, y no se guarda nada.
ImageUpload image abre un selector de archivos, igual que un clic en el círculo del espacio. Cuando hay una imagen, los botones pasan a ser Replace image y Remove image. Consulta Imagen del espacio.
ColorSin color, o uno de Red, Green, Yellow, Blue, Magenta y Cyan. Un espacio sin imagen dibuja su color como un degradado en su círculo, igual en todos los temas, y sin color, un contorno.
EnvironmentUn resumen de las variables del espacio y un botón Edit. Consulta Entorno del espacio.
Agent setupSe muestra cuando el espacio cambia CLAUDE_CONFIG_DIR o CODEX_HOME respecto al valor predeterminado: una línea por agente, como Claude Code hooks and MCP, con su estado, Retry tras un error e Install cuando no está instalado.

Delete space, al final de un espacio desplegado, pregunta Delete Work? Its 3 workspaces move to Default. con Cancel y Delete space. Al confirmar, los espacios de trabajo del espacio pasan a Default sin cerrar ningún terminal, Default pasa a ser el espacio activo si lo era el eliminado, y se borra la imagen del espacio.

New space añade Space N con el primer número libre y abre su nombre para editarlo, igual que New space… en el menú de espacios de la barra lateral y New space en la paleta de comandos. Con 9 espacios, el botón se desactiva y aparece 9 spaces maximum a su lado.

Imagen del espacio

Una imagen sustituye el degradado de color en el círculo del espacio, en la cabecera de la barra lateral, el menú de espacios y Settings. Elige un archivo PNG, JPEG, WebP, GIF, BMP o TIFF de 25 MB como máximo y de 12 000 píxeles por lado como máximo. Paneflow aplica la orientación EXIF de la foto, la recorta en un cuadrado centrado y guarda un PNG de 96 píxeles en avatars/ dentro del home de Paneflow (~/.paneflow/avatars/, %USERPROFILE%\.paneflow\avatars\ en Windows). El nombre del archivo se registra como avatar en la entrada del espacio en paneflow.json. Una imagen que no se puede leer o que es demasiado grande muestra el motivo bajo el campo Image, y el espacio conserva su círculo anterior. Sustituir o quitar una imagen borra el archivo anterior.

Entorno del espacio

Edit bajo Environment abre una fila por variable. Los valores se definen en cada terminal que se abra a partir de entonces en los espacios de trabajo de ese espacio, por encima de terminal.env y por debajo del env de un perfil de agente y del env propio de un panel. Un ~ inicial es tu directorio home, y $NAME toma el valor del entorno de Paneflow; la línea bajo una fila muestra el valor expandido. Apunta CLAUDE_CONFIG_DIR, CODEX_HOME o GH_CONFIG_DIR a un directorio aparte para usar una segunda cuenta de Claude Code, Codex o GitHub CLI en ese espacio. Esas tres deben ser rutas absolutas; Paneflow crea el directorio si no existe, privado para ti en Linux y macOS, antes de que se inicie el primer terminal, y un mensaje emergente nombra el directorio si no puede crearlo. Dos cuentas solo se mantienen separadas mientras cada CLI respete su variable de directorio, y GH_CONFIG_DIR no aísla nada mientras GH_TOKEN o GITHUB_TOKEN esté definida.

Save rechaza, con el motivo bajo la fila o el formulario, un valor sin nombre, un nombre que aparece dos veces, un nombre que no es un nombre de variable, un nombre PANEFLOW_, una variable que Paneflow define para cada terminal como TERM, una variable que cambia cómo los programas se cargan o ejecutan agentes como LD_PRELOAD o un marcador de sesión de agente como CLAUDECODE, una ruta relativa para CLAUDE_CONFIG_DIR, CODEX_HOME o GH_CONFIG_DIR, y un $NAME que nombra una variable que el entorno de Paneflow no define. En Windows, los terminales reciben los nombres en mayúsculas, mientras que paneflow.json conserva las mayúsculas y minúsculas que escribiste. Una variable cuyo nombre contiene KEY, TOKEN, SECRET o PASSWORD muestra Stored in plain text in paneflow.json; prefer a config directory. Cuando el propio entorno de Paneflow define ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, OPENAI_API_KEY, GH_TOKEN o GITHUB_TOKEN y el espacio no la redefine, una advertencia lo indica: esas variables tienen prioridad sobre la cuenta guardada en un directorio de configuración.

Los terminales abiertos conservan el entorno con el que se iniciaron: al mover un espacio de trabajo a un espacio con otro entorno aparece Open terminals keep their previous environment, y nada se reinicia. Una shell que exporta la misma variable desde su archivo rc, por ejemplo .zshrc, prevalece sobre el valor del espacio dentro de ese terminal.

Cuando un espacio cambia CLAUDE_CONFIG_DIR o CODEX_HOME respecto al valor predeterminado, al guardarlo se instalan los hooks y el bridge MCP de Paneflow en ese directorio para cada agente ya instalado en Settings > Agents, de modo que la barra lateral sigue mostrando cuándo el agente trabaja y cuándo espera. Cada inicio de una build de release los actualiza, una vez por cada par distinto de directorios de Claude Code y Codex. Agent setup lista el estado de cada agente, con Retry tras un error e Install cuando no está instalado.

Eliminar un espacio deja sus hooks en su sitio. Para quitarlos, elimina las entradas marcadas con "_paneflow_managed": true de los hooks de settings.json en el CLAUDE_CONFIG_DIR del espacio, el servidor paneflow de su .claude.json y su skills/paneflow-conductor/SKILL.md; para Codex, elimina las mismas entradas de hooks.json y la tabla [mcp_servers.paneflow] de config.toml en su CODEX_HOME. Los registros del espacio están en ~/.paneflow/integrations/spaces/<space id>/ y también se pueden eliminar.

Un espacio organiza el trabajo; no es una frontera de seguridad. Cada terminal sigue ejecutándose con tu usuario, y cualquier cosa que pueda leer tu directorio home puede leer un valor de paneflow.json.

Acceso IA vs MCP

La página Agents controla cómo Paneflow lanza agentes y cuánta automatización puede ejecutar un conductor de confianza.

claude_code_bypass_permissions solo afecta a lanzamientos de Claude Code. Cuando está activado, Paneflow lanza Claude Code con --permission-mode bypassPermissions. No cambia el comportamiento de Codex, OpenCode, Gemini ni MCP.

Plugins es una página operativa separada. Registra el servidor paneflow-mcp incluido para que los agentes compatibles puedan listar, leer y buscar en paneles de Paneflow. Toca los archivos de config propios de los agentes y puede ejecutarse de nuevo de forma segura.

Controles solo de config

Usa paneflow.json cuando necesites un ajuste que no está intencionadamente en la UI principal de Settings.

Ejemplos comunes:

  • terminal.scrollback_lines para el historial de scrollback por terminal.
  • terminal.ligatures, terminal.cursor_blink, terminal.env y terminal.scroll_multiplier para comportamiento avanzado del terminal. Todas las builds de Paneflow emulan sus paneles con un único motor libghostty-vt de versión fijada y enlace estático, así que no hay ningún motor que seleccionar.
  • Entradas commands[] que no son templates de workspace.
  • Opciones de perfiles, telemetry, window decoration y agent panel.

Paneflow recarga cambios de config válidos mediante su watcher. Si el JSON está mal formado, la app en ejecución conserva la última config válida en vez de caer a los valores por defecto. El JSON Schema marca claves desconocidas en editores; el runtime sigue siendo tolerante para que builds antiguos puedan ignorar claves nuevas.

Ver también

  • Configuración - ubicación del archivo, setup del schema y comportamiento runtime.
  • Schema - cada clave, tipo, valor por defecto y estabilidad.
  • Atajos y acciones - nombres de acciones para overrides de shortcuts.
  • Temas - nombres de temas incluidos y comportamiento de recarga en caliente.