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. MCP Servers 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. |
| Themes | Light, Dark, System, más controles dedicados de material de sidebar para Windows y macOS cuando están disponibles. | theme, windows_chrome_material, macos_chrome_material | Los cambios de tema 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. | 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 y material de terminal Windows. | terminal.cursor_shape, terminal.cursor_color, font_family, font_size, font_weight, line_height, cell_width, terminal.integrated_glyphs, terminal.color_emoji, windows_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. |
| AI Agent | Visibilidad de botones de lanzamiento, modo bypass de Claude Code, acceso libre IA y injection fence. | *_button_visible, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence | Los cambios de lanzador y acceso se recargan en caliente. |
| MCP Servers | 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. |
Acceso IA vs MCP
La página AI Agent 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.
MCP Servers 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.backend,terminal.ligatures,terminal.cursor_blink,terminal.envyterminal.scroll_multiplierpara comportamiento avanzado del terminal. Las builds estándar de Linux y las builds compatibles de Windows x64 MSVC seleccionan Ghostty conauto; usaterminal.backendenalacrittypara volver atrás. macOS y las builds sin la función Ghostty nativa del target usan Alacritty. El ajuste de backend se aplica solo a las sesiones nuevas.- 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.