Aller au contenu
PaneflowPaneflow

Paramètres

Comprendre ce que le panneau Settings de Paneflow contrôle, ce qu'il écrit dans paneflow.json, et quelles clés avancées restent uniquement dans la config.

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

PageCe qu'elle contrôleÉcrit dansApplication
GeneralÉditeur externe par défaut et shell par défaut pour les nouvelles panes terminal.external_editor, default_shellAux nouveaux lancements. Les terminaux déjà lancés gardent leur processus courant.
AppearanceLight, Dark, System, le preset de thème, Comfortable density, Interface style, Workspace icon, Background style sur Windows, macOS et Linux, App icon, plus des contrôles dédiés au matériau de sidebar Windows, macOS et Linux.theme, comfortable_density, interface_style, workspace_icon, app_icon, windows_chrome_material, windows_terminal_material, macos_chrome_material, linux_chrome_material, linux_terminal_materialLes changements de thème, de densité, de style, d'icône et de matériau se rechargent à chaud.
Keyboard ShortcutsBindings des actions et retour aux valeurs par défaut.shortcutsRechargé après la sauvegarde de config.
NotificationsNotifications OS natives pour les agents en attente et pour les notifications envoyées par les programmes du terminal.agent_panel.notify_when_agent_waitingRechargement à chaud.
TerminalForme 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 et 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_materialLes contrôles d'affichage se rechargent à chaud. La forme du curseur s'applique au prochain terminal créé.
WorkspacesTemplates de workspace réutilisables avec panes, agents, commandes shell, cwd, env et prompt prérempli.commands[].workspaceLes templates passent par le même chemin de lancement workspace que paneflow up.
SpacesLes espaces qui regroupent les espaces de travail : Default en premier, puis chaque espace avec son nom, son image, sa couleur, ses variables d'environnement, l'état des hooks et du MCP de Claude Code et de Codex dans les dossiers de config qu'il définit, et une action de suppression qui déplace ses espaces de travail vers Default après confirmation. Jusqu'à 9 espaces.spaces ; les images vont dans avatars/ du home PaneflowLes noms, images et couleurs se rechargent à chaud. Un environnement s'applique aux terminaux ouverts après le changement.
WorktreesDossier 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_limitRechargement à chaud. La racine s'applique aux worktrees créés ensuite.
AgentsQuels agents le lanceur affiche, avec leur version installée et leur état de hooks, un interrupteur Paneflow hooks pour Claude Code et Codex, 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 ; l'interrupteur Paneflow hooks écrit la config de hooks de l'agentLes changements de lanceur et d'accès se rechargent à chaud.
PluginsInstalle 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.

Style d'interface

Settings > Appearance propose Interface style sous le preset de thème, et la palette de commandes propose le même choix sous Interface style. Ce réglage choisit la disposition et le langage de coins de toute l'application, et il est enregistré dans interface_style.

StyleCe qu'il dessine
Classic (par défaut)Une fenêtre bord à bord : la barre latérale, les panneaux et le dock Changes vont jusqu'aux bords de la fenêtre, séparés par de fines lignes, les onglets des panneaux du haut et du dock se placent dans la barre de titre à côté des contrôles de la fenêtre, et la partie vide de cette rangée déplace la fenêtre. Des coins circulaires sur une échelle serrée : 12 px pour les boîtes de dialogue et les notifications, et 8 px pour les lignes, les boutons et les onglets de panneau. Comfortable density n'a aucun effet.
RoundedL'apparence de Paneflow 0.19 et des versions antérieures : des cartes de panneaux aux coins continus (squircles) et aux rayons généreux, qui flottent sous une barre de titre pleine largeur. Comfortable density ne s'applique qu'à ce style.

Dans les deux styles, chaque menu et chaque liste déroulante est un panneau de 8 px avec des lignes de 28 px, des libellés de 14 px et des raccourcis de 12 px. La palette de commandes et la boîte de dialogue Clone repository ont la même apparence dans les deux styles. Le changement s'applique aussitôt à toutes les fenêtres ouvertes. Paneflow s'ouvre en Classic à partir de 0.20.0 ; pour garder les cartes de panneaux flottantes, choisissez Rounded ou définissez "interface_style": "rounded".

Style d'arrière-plan

Sur Windows, macOS et Linux, Settings > Appearance propose Background style sous le style d'interface, et la palette de commandes propose le même choix sous Background style. Ce réglage active ou coupe d'un coup tous les matériaux de fenêtre de la plateforme. Jusqu'à 0.19, il s'appelait Interface style ; il garde ses valeurs et ses clés.

StyleWindowsmacOSLinux
Themed (par défaut)windows_chrome_material et windows_terminal_material à false : les couleurs pleines du thème.macos_chrome_material à false : une sidebar opaque.linux_chrome_material et linux_terminal_material à false : une fenêtre opaque.
BlendedLes deux à true : Mica transparaît à travers la sidebar et le terminal.macos_chrome_material à true : le matériau Sidebar natif s'affiche derrière la sidebar.Les deux à true : le bureau transparaît à travers un voile derrière la sidebar et un voile plus dense derrière le terminal.

Sous Linux, avec "window_backdrop": "blurred", Paneflow demande à un compositeur Wayland qui propose ext-background-effect ou le flou de KDE de flouter ce qui se trouve derrière la fenêtre translucide, en suivant ses coins arrondis. Ailleurs, y compris sous X11 et GNOME, Paneflow ne demande pas de flou : le compositeur peut en fournir un, par exemple l'extension Blur my Shell sur GNOME. Sans lui, le fond d'écran transparaît net à travers le voile.

Il n'existe pas de clé background_style : Paneflow déduit le style de ces réglages. Quand ils divergent, par exemple après en avoir activé un à la main, la ligne affiche Custom.

Icône des espaces de travail

Settings > Appearance propose Workspace icon, et la palette de commandes propose le même choix sous Workspace icon. Ce réglage choisit le glyphe affiché devant chaque espace de travail dans la barre latérale, et il est enregistré dans workspace_icon. Default garde le dossier en contour de Paneflow. Standard remplace le dossier par un chevron de dépliage, vers la droite quand l'espace de travail est replié et vers le bas quand il est ouvert. Metal est un dossier de verre plein, Windows un dossier jaune en dégradé, Windows 95 le dossier pixel en 16 couleurs, et Pixel un dossier pixel en contour. Chaque style a un glyphe fermé et un glyphe ouvert, et les deux styles pixel sont plus nets à une échelle d'affichage de 100 % ou 200 %.

Icône de l'application

Settings > Appearance propose App icon en bas de la carte du thème. Ce réglage choisit l'icône que Paneflow affiche pour ses fenêtres en cours d'exécution, et il est enregistré dans app_icon. La ligne montre l'icône actuelle et son nom ; cliquez dessus pour déplier une galerie de toutes les icônes, puis choisissez-en une pour l'appliquer aussitôt.

IcôneCe qu'elle dessine
Glass (par défaut)L'icône installée : trois panneaux de verre sur une tuile violette.
BlackLa marque Paneflow en barres horizontales blanc cassé sur une tuile noire.
WhiteLes mêmes barres à l'encre foncée sur une tuile blanche.
Black solidLes trois panneaux en formes pleines blanc cassé sur une tuile noire.
White solidLes mêmes panneaux pleins à l'encre foncée sur une tuile blanche.

Seize icônes illustrées suivent. Chacune montre la même marque dans une autre matière.

Icôneapp_iconCe qu'elle dessine
AubergineaubergineDes panneaux lilas sur une tuile aubergine profond.
PaperpaperDes panneaux à l'encre aubergine sur une tuile de papier blanc cassé.
Midnight mattemidnight-matteDes panneaux gris foncé sur une tuile noir mat.
PolarpolarDes panneaux bleus et cyan sur une tuile blanc glacier.
MelonmelonDes panneaux corail et orange sur une tuile crème.
HoneydewhoneydewDes panneaux vert foncé sur une tuile menthe et citron vert.
BerryberryDes panneaux prune sur une tuile violette et rose.
RainbowrainbowDes panneaux en six bandes rétro sur une tuile noire.
SolarwavesolarwaveDes bandes de coucher de soleil chromées sur une tuile violet profond.
NeonneonDes contours néon cyan et rose sur une tuile violet sombre.
PhosphorphosphorDes panneaux vert lumineux sur une tuile d'écran noire.
HoloholoDes panneaux sombres sur une tuile de feuille irisée.
AmethystamethystDes panneaux lilas sur une gemme violette à facettes.
BlueprintblueprintDes panneaux bleu pâle sur une tuile de plan d'architecte.
ChipchipDes panneaux de métal brossé sur une puce, sertie dans un circuit imprimé vert.
NostalgianostalgiaDes panneaux blanc chromé sur une tuile bleue brillante.
PlateformeOù le choix apparaîtQuand
WindowsLe bouton de la barre des tâches, Alt+Tab, et les raccourcis de votre profil qui ouvrent ce Paneflow : celui épinglé à la barre des tâches, un raccourci du bureau, l'entrée du menu Démarrer.Alt+Tab aussitôt. Le bouton de la barre des tâches à la prochaine ouverture de session ou au redémarrage de l'Explorateur Windows. Un raccourci garde l'icône pendant que Paneflow est fermé.
macOSLe Dock et le sélecteur d'applications, pendant que Paneflow tourne.Aussitôt.
Linux, X11L'icône de fenêtre que lisent le gestionnaire de fenêtres et le sélecteur de tâches.Les fenêtres ouvertes après le changement ; redémarrez Paneflow pour l'appliquer à toutes.
Linux, WaylandNulle part : le compositeur prend l'icône dans l'entrée de bureau installée.Jamais.

Sous Windows, un bouton épinglé à la barre des tâches affiche l'icône de son raccourci, pas celle de la fenêtre : Paneflow fait donc pointer ce raccourci vers un fichier d'icône qu'il écrit sous icons/ dans le home Paneflow, et le vérifie de nouveau à chaque lancement. Windows met en cache l'image d'un bouton de la barre des tâches et ne relit le raccourci qu'en rechargeant la barre des tâches : le bouton change donc à la prochaine ouverture de session, ou au redémarrage de l'Explorateur Windows. Choisir Glass rend au raccourci sa propre icône.

Le raccourci du menu Démarrer d'une installation pour toute la machine ne vous appartient pas. Pour toute icône autre que Glass, Paneflow le copie au même endroit dans votre propre dossier du menu Démarrer, que Windows privilégie, et donne l'icône à cette copie ; choisir Glass supprime la copie. Si vous désinstallez Paneflow pendant qu'une autre icône est sélectionnée, la copie reste : supprimez-la de %APPDATA%\Microsoft\Windows\Start Menu\Programs.

Sous macOS et Linux, le lanceur installé et la tuile du Dock d'un Paneflow qui ne tourne pas gardent l'icône Glass.

Contraste du terminal

Paneflow augmente le contraste du texte coloré par un programme lorsque sa couleur est trop proche du fond. Settings > Terminal expose ce réglage sous Minimum contrast. La palette de commandes propose les mêmes valeurs sous Minimum contrast.

Valeur affichéeterminal.minimum_contrastEffet
Autoclé absenteAPCA Lc 60 pour tous les thèmes, clairs et sombres.
Off0Aucune correction. Les programmes conservent les couleurs demandées.
45, 60, 75, 90ce nombreUne cible APCA Lc explicite.

Les valeurs supérieures à 90 sont limitées à 90. Les valeurs négatives ou invalides reviennent à Auto.

Seules les couleurs choisies par un programme sont corrigées : truecolor et indices de palette de 16 à 255. Les seize couleurs ANSI du thème, sa couleur de texte et son fond restent inchangés. La correction ajuste d'abord la luminosité en conservant la teinte. Si elle doit trop réduire la saturation, elle se rapproche de la couleur du thème la plus proche.

Les changements se rechargent à chaud dans les terminaux ouverts. Pour désactiver la correction partout, définissez "minimum_contrast": 0 sous terminal dans paneflow.json.

Espaces

Spaces s'ouvre sur un bouton New space à côté de son introduction, puis sur une carte qui liste Default en premier. Default contient tous les espaces de travail sans espace, affiche Workspaces without a space ou son nombre d'espaces de travail, et ne peut être ni renommé ni supprimé. Suit une ligne par espace, avec son cercle, son nom et ses nombres d'espaces de travail et de variables ; une ligne repliée signale aussi Agent setup failed ou ses avertissements d'environnement. Cliquez sur une ligne pour la déplier. Un seul espace est déplié à la fois.

ChampRôle
NameCliquez sur le nom pour le modifier, puis appuyez sur Enter pour enregistrer ou sur Escape pour annuler ; un clic ailleurs enregistre aussi. Un nom doit compter de 1 à 32 caractères, ne peut pas être Default et ne peut pas reprendre le nom d'un autre espace, sans tenir compte de la casse. Un nom invalide affiche la raison sous le champ, et rien n'est enregistré.
ImageUpload image ouvre un sélecteur de fichier, tout comme un clic sur le cercle de l'espace. Une fois une image définie, les boutons deviennent Replace image et Remove image. Voir Image de l'espace.
ColorAucune couleur, ou l'une des couleurs Red, Green, Yellow, Blue, Magenta et Cyan. Un espace sans image dessine sa couleur en dégradé dans son cercle, identique dans tous les thèmes, et sans couleur un contour.
EnvironmentUn résumé des variables de l'espace et un bouton Edit. Voir Environnement de l'espace.
Agent setupAffiché quand l'espace déplace CLAUDE_CONFIG_DIR ou CODEX_HOME hors de son emplacement par défaut : une ligne par agent, comme Claude Code hooks and MCP, avec son état, Retry après une erreur et Install quand il n'est pas installé.

Delete space, en bas d'un espace déplié, demande Delete Work? Its 3 workspaces move to Default. avec Cancel et Delete space. Confirmer déplace les espaces de travail de l'espace vers Default sans fermer aucun terminal, rend Default actif si l'espace supprimé l'était, et supprime l'image de l'espace.

New space ajoute Space N avec le premier numéro libre et ouvre son nom en édition, tout comme New space… dans le menu des espaces de la barre latérale et New space dans la palette de commandes. Avec 9 espaces, le bouton est désactivé et 9 spaces maximum s'affiche à côté.

Image de l'espace

Une image remplace le dégradé de couleur dans le cercle de l'espace, dans l'en-tête de la barre latérale, le menu des espaces et Settings. Choisissez un fichier PNG, JPEG, WebP, GIF, BMP ou TIFF de 25 Mo au plus et de 12 000 pixels au plus de côté. Paneflow applique l'orientation EXIF de la photo, la recadre en carré centré et stocke un PNG de 96 pixels dans avatars/ sous le home Paneflow (~/.paneflow/avatars/, %USERPROFILE%\.paneflow\avatars\ sur Windows). Le nom du fichier est enregistré dans avatar sur l'entrée de l'espace dans paneflow.json. Une image illisible ou trop grande affiche la raison sous le champ Image, et l'espace garde son cercle précédent. Remplacer ou retirer une image supprime le fichier précédent.

Environnement de l'espace

Edit sous Environment ouvre une ligne par variable. Les valeurs sont définies sur chaque terminal ouvert ensuite dans les espaces de travail de cet espace, au-dessus de terminal.env et en dessous de l'env d'un profil d'agent et de l'env propre à une surface. Un ~ en tête désigne votre dossier personnel, et $NAME prend sa valeur dans l'environnement de Paneflow ; la ligne sous chaque variable affiche la valeur développée. Pointez CLAUDE_CONFIG_DIR, CODEX_HOME ou GH_CONFIG_DIR vers un dossier séparé pour utiliser un second compte Claude Code, Codex ou GitHub CLI dans cet espace. Ces trois variables doivent être des chemins absolus ; Paneflow crée le dossier manquant, accessible à vous seul sur Linux et macOS, avant le démarrage du premier terminal, et un message nomme le dossier s'il n'y parvient pas. Deux comptes ne restent séparés que tant que chaque CLI respecte sa variable de dossier, et GH_CONFIG_DIR n'isole rien tant que GH_TOKEN ou GITHUB_TOKEN est défini.

Save refuse, avec la raison sous la ligne ou le formulaire, une valeur sans nom, un nom présent deux fois, un nom qui n'est pas un nom de variable, un nom en PANEFLOW_, une variable que Paneflow définit pour chaque terminal comme TERM, une variable qui modifie le chargement des programmes ou le lancement des agents comme LD_PRELOAD ou un marqueur de session d'agent comme CLAUDECODE, un chemin relatif pour CLAUDE_CONFIG_DIR, CODEX_HOME ou GH_CONFIG_DIR, et un $NAME qui désigne une variable absente de l'environnement de Paneflow. Sur Windows, les terminaux reçoivent les noms en majuscules, tandis que paneflow.json garde la casse saisie. Une variable dont le nom contient KEY, TOKEN, SECRET ou PASSWORD affiche Stored in plain text in paneflow.json; prefer a config directory. Quand l'environnement de Paneflow lui-même définit l'une des variables ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, OPENAI_API_KEY, GH_TOKEN ou GITHUB_TOKEN et que l'espace ne la redéfinit pas, un avertissement le signale : ces variables priment sur le compte enregistré dans un dossier de config.

Les terminaux ouverts gardent l'environnement avec lequel ils ont démarré : déplacer un espace de travail vers un espace dont l'environnement diffère affiche Open terminals keep their previous environment, et rien ne redémarre. Un shell qui exporte la même variable depuis son fichier rc, par exemple .zshrc, remplace la valeur de l'espace dans ce terminal.

Quand un espace déplace CLAUDE_CONFIG_DIR ou CODEX_HOME hors de son emplacement par défaut, l'enregistrer installe les hooks et le bridge MCP de Paneflow dans ce dossier pour chaque agent déjà installé dans Settings > Agents, afin que la barre latérale continue d'indiquer quand l'agent travaille et quand il attend. Chaque lancement d'un build de release les rafraîchit, une fois par paire distincte de dossiers Claude Code et Codex. Agent setup liste l'état de chaque agent, avec Retry après une erreur et Install quand il n'est pas installé.

Supprimer un espace laisse ses hooks en place. Pour les retirer, supprimez les entrées marquées "_paneflow_managed": true des hooks de settings.json dans le CLAUDE_CONFIG_DIR de l'espace, le serveur paneflow de son .claude.json et son skills/paneflow-conductor/SKILL.md ; pour Codex, supprimez les mêmes entrées de hooks.json et la table [mcp_servers.paneflow] de config.toml dans son CODEX_HOME. Les enregistrements de l'espace se trouvent sous ~/.paneflow/integrations/spaces/<space id>/ et peuvent aussi être supprimés.

Un espace organise le travail ; ce n'est pas une frontière de sécurité. Chaque terminal tourne toujours sous votre compte, et une valeur de paneflow.json est lisible par tout ce qui peut lire votre dossier personnel.

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_lines pour l'historique de scrollback par terminal.
  • terminal.ligatures, terminal.cursor_blink, terminal.env et terminal.scroll_multiplier pour le comportement terminal avancé. Chaque build de Paneflow émule ses panes avec un unique moteur libghostty-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.