Le panneau Settings de Paneflow est l'interface humaine pour les préférences courantes. Ce n'est pas la référence complète de configuration. Utilise-le pour les réglages que tu ajustes souvent : éditeur, shell, thème, raccourcis, notifications, affichage terminal, templates de workspace, lanceurs d'agents, accès IA et configuration MCP.
TL;DR. La plupart des lignes de Settings écrivent dans
paneflow.json et se rechargent à chaud après la sauvegarde du
fichier. Plugins est différent : il installe ou répare le bridge
MCP de Paneflow dans les configs d'agents prises en charge. Les clés
avancées restent disponibles dans
paneflow.json.
Carte des paramètres
| Page | Ce qu'elle contrôle | Écrit dans | Application |
|---|---|---|---|
| General | Éditeur externe par défaut et shell par défaut pour les nouvelles panes terminal. | external_editor, default_shell | Aux nouveaux lancements. Les terminaux déjà lancés gardent leur processus courant. |
| Themes | Light, Dark, System, plus des contrôles dédiés au matériau de sidebar Windows et macOS quand disponibles. | theme, windows_chrome_material, macos_chrome_material | Les changements de thème et de matériau se rechargent à chaud. |
| Keyboard Shortcuts | Bindings des actions et retour aux valeurs par défaut. | shortcuts | Rechargé après la sauvegarde de config. |
| Notifications | Notifications OS natives pour les agents en attente. | agent_panel.notify_when_agent_waiting | Rechargement à chaud. |
| Terminal | Forme et couleur du curseur, famille de police, taille, graisse, hauteur de ligne, largeur de cellule, glyphes intégrés, emoji couleur, contraste minimal et matériau terminal Windows. | 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 | Les contrôles d'affichage se rechargent à chaud. La forme du curseur s'applique au prochain terminal créé. |
| Workspaces | Templates de workspace réutilisables avec panes, agents, commandes shell, cwd, env et prompt prérempli. | commands[].workspace | Les templates passent par le même chemin de lancement workspace que paneflow up. |
| Worktrees | Dossier racine des worktrees créés par Paneflow, suppression automatique avec une limite de conservation, la liste des worktrees gérés avec une action de suppression, et les snapshots pris avant une suppression avec restauration et suppression. | worktrees.dir, worktrees.auto_remove, worktrees.keep_limit | Rechargement à chaud. La racine s'applique aux worktrees créés ensuite. |
| Agents | Quels agents le lanceur affiche, avec leur version installée, les profils d'agent personnalisés, l'accès complet Claude Code, l'accès libre IA et l'injection fence. | *_button_visible, agent_profiles, claude_code_bypass_permissions, ai_unrestricted, ai_injection_fence | Les changements de lanceur et d'accès se rechargent à chaud. |
| Plugins | Installe ou répare le bridge paneflow-mcp inclus pour Claude Code, Codex, Gemini et opencode. | Fichiers de config des agents, pas paneflow.json | À relancer après une mise à jour de Paneflow ou quand une config agent change. |
Accès IA vs MCP
La page Agents contrôle la manière dont Paneflow lance les agents et le niveau d'automatisation qu'un conductor de confiance peut exercer.
claude_code_bypass_permissions affecte uniquement les lancements de
Claude Code. Quand il est activé, Paneflow lance Claude Code avec
--permission-mode bypassPermissions. Cela ne change pas le
comportement de Codex, OpenCode, Gemini ou MCP.
Plugins est une page opérationnelle séparée. Elle enregistre le
serveur paneflow-mcp inclus pour que les agents pris en charge
puissent lister, lire et chercher dans les panes Paneflow. Elle touche
les fichiers de config propres aux agents et peut être relancée sans
danger.
Contrôles config-only
Utilise paneflow.json quand tu as besoin d'un
réglage qui n'est volontairement pas dans l'UI Settings principale.
Exemples courants :
terminal.scrollback_linespour l'historique de scrollback par terminal.terminal.ligatures,terminal.cursor_blink,terminal.envetterminal.scroll_multiplierpour le comportement terminal avancé. Chaque build de Paneflow émule ses panes avec un unique moteurlibghostty-vtépinglé et lié statiquement : il n'y a donc aucun moteur à sélectionner.- Les entrées
commands[]qui ne sont pas des templates de workspace. - Les options de profils, telemetry, window decoration et agent panel.
Paneflow recharge les changements de config valides via son watcher. Si le JSON est mal formé, l'app en cours garde la dernière config valide au lieu de retomber sur les valeurs par défaut. Le JSON Schema signale les clés inconnues dans les éditeurs ; le runtime reste tolérant pour que les anciens builds puissent ignorer les nouvelles clés.
Voir aussi
- Configuration - emplacement du fichier, setup schema et comportement runtime.
- Schéma - chaque clé, type, défaut et stabilité.
- Raccourcis et actions - noms d'actions pour les overrides
shortcuts. - Thèmes - noms des thèmes inclus et comportement de rechargement à chaud.