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ágina | Qué controla | Escribe en | Cuándo aplica |
|---|---|---|---|
| General | Editor externo por defecto y shell por defecto para nuevos paneles de terminal. | external_editor, default_shell | Nuevos lanzamientos. Los terminales en ejecución mantienen su proceso actual. |
| Appearance | Light, 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_material | Los cambios de tema, densidad, estilo, icono y material se recargan en caliente. |
| Keyboard Shortcuts | Bindings de acciones y restablecimiento a valores por defecto. | shortcuts | Se recarga después de guardar la config. |
| Notifications | Notificaciones nativas del OS para agentes en espera y para las notificaciones que envían los programas de terminal. | agent_panel.notify_when_agent_waiting | Recarga en caliente. |
| Terminal | Forma 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_material | Los controles visuales se recargan en caliente. La forma del cursor aplica al siguiente terminal nuevo. |
| Workspaces | Templates de workspace reutilizables con paneles, agentes, comandos shell, cwd, env y prompt prefijado. | commands[].workspace | Los templates pasan por la misma ruta de lanzamiento de workspace que paneflow up. |
| Spaces | Los 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 Paneflow | Los nombres, las imágenes y los colores se recargan en caliente. Un entorno se aplica a los terminales abiertos después del cambio. |
| Worktrees | Directorio 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_limit | Recarga en caliente. La raíz se aplica a los worktrees creados a partir de entonces. |
| Agents | Qué 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 agente | Los cambios de lanzador y acceso se recargan en caliente. |
| Plugins | Instala o repara el bridge paneflow-mcp incluido para Claude Code, Codex, Gemini y opencode. | Archivos de config de agentes, no paneflow.json | Vuelve 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.
| Estilo | Qué 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. |
| Rounded | El 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.
| Estilo | Windows | macOS | Linux |
|---|---|---|---|
| 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. |
| Blended | Ambos 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.
| Icono | Qué dibuja |
|---|---|
| Glass (predeterminado) | El icono instalado: tres paneles de cristal sobre una baldosa violeta. |
| Black | La marca de Paneflow en barras horizontales blanco roto sobre una baldosa negra. |
| White | Las mismas barras en tinta oscura sobre una baldosa blanca. |
| Black solid | Los tres paneles como formas sólidas blanco roto sobre una baldosa negra. |
| White solid | Los 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.
| Icono | app_icon | Qué dibuja |
|---|---|---|
| Aubergine | aubergine | Paneles lila sobre una baldosa berenjena intensa. |
| Paper | paper | Paneles en tinta berenjena sobre una baldosa de papel blanco roto. |
| Midnight matte | midnight-matte | Paneles gris oscuro sobre una baldosa negra mate. |
| Polar | polar | Paneles azules y cian sobre una baldosa blanco hielo. |
| Melon | melon | Paneles coral y naranja sobre una baldosa crema. |
| Honeydew | honeydew | Paneles verde oscuro sobre una baldosa menta y lima. |
| Berry | berry | Paneles ciruela sobre una baldosa violeta y rosa. |
| Rainbow | rainbow | Paneles en seis franjas retro sobre una baldosa negra. |
| Solarwave | solarwave | Bandas de atardecer cromadas sobre una baldosa púrpura intensa. |
| Neon | neon | Contornos de neón cian y rosa sobre una baldosa violeta oscura. |
| Phosphor | phosphor | Paneles verdes luminosos sobre una baldosa de pantalla negra. |
| Holo | holo | Paneles oscuros sobre una baldosa de lámina iridiscente. |
| Amethyst | amethyst | Paneles lila sobre una gema violeta facetada. |
| Blueprint | blueprint | Paneles azul pálido sobre una baldosa de plano técnico. |
| Chip | chip | Paneles de metal cepillado sobre un chip, montado en una placa de circuito verde. |
| Nostalgia | nostalgia | Paneles blanco cromado sobre una baldosa azul brillante. |
| Plataforma | Dónde aparece la elección | Cuándo |
|---|---|---|
| Windows | El 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. |
| macOS | El Dock y el selector de aplicaciones, mientras Paneflow se ejecuta. | Al instante. |
| Linux, X11 | El 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, Wayland | En 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 mostrado | terminal.minimum_contrast | Efecto |
|---|---|---|
| Auto | clave ausente | APCA Lc 60 para todos los temas, claros y oscuros. |
| Off | 0 | Sin corrección. Los programas mantienen los colores solicitados. |
| 45, 60, 75, 90 | ese número | Un 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.
| Campo | Qué hace |
|---|---|
| Name | Haz 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. |
| Image | Upload 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. |
| Color | Sin 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. |
| Environment | Un resumen de las variables del espacio y un botón Edit. Consulta Entorno del espacio. |
| Agent setup | Se 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_linespara el historial de scrollback por terminal.terminal.ligatures,terminal.cursor_blink,terminal.envyterminal.scroll_multiplierpara comportamiento avanzado del terminal. Todas las builds de Paneflow emulan sus paneles con un único motorlibghostty-vtde 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.