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. |
| Appearance | Light, 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_material | Les changements de thème, de densité, de style, d'icône 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 et pour les notifications envoyées par les programmes du terminal. | 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 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_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. |
| Spaces | Les 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 Paneflow | Les noms, images et couleurs se rechargent à chaud. Un environnement s'applique aux terminaux ouverts après le changement. |
| 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 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'agent | 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. |
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.
| Style | Ce 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. |
| Rounded | L'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.
| Style | Windows | macOS | Linux |
|---|---|---|---|
| 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. |
| Blended | Les 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ône | Ce qu'elle dessine |
|---|---|
| Glass (par défaut) | L'icône installée : trois panneaux de verre sur une tuile violette. |
| Black | La marque Paneflow en barres horizontales blanc cassé sur une tuile noire. |
| White | Les mêmes barres à l'encre foncée sur une tuile blanche. |
| Black solid | Les trois panneaux en formes pleines blanc cassé sur une tuile noire. |
| White solid | Les 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ône | app_icon | Ce qu'elle dessine |
|---|---|---|
| Aubergine | aubergine | Des panneaux lilas sur une tuile aubergine profond. |
| Paper | paper | Des panneaux à l'encre aubergine sur une tuile de papier blanc cassé. |
| Midnight matte | midnight-matte | Des panneaux gris foncé sur une tuile noir mat. |
| Polar | polar | Des panneaux bleus et cyan sur une tuile blanc glacier. |
| Melon | melon | Des panneaux corail et orange sur une tuile crème. |
| Honeydew | honeydew | Des panneaux vert foncé sur une tuile menthe et citron vert. |
| Berry | berry | Des panneaux prune sur une tuile violette et rose. |
| Rainbow | rainbow | Des panneaux en six bandes rétro sur une tuile noire. |
| Solarwave | solarwave | Des bandes de coucher de soleil chromées sur une tuile violet profond. |
| Neon | neon | Des contours néon cyan et rose sur une tuile violet sombre. |
| Phosphor | phosphor | Des panneaux vert lumineux sur une tuile d'écran noire. |
| Holo | holo | Des panneaux sombres sur une tuile de feuille irisée. |
| Amethyst | amethyst | Des panneaux lilas sur une gemme violette à facettes. |
| Blueprint | blueprint | Des panneaux bleu pâle sur une tuile de plan d'architecte. |
| Chip | chip | Des panneaux de métal brossé sur une puce, sertie dans un circuit imprimé vert. |
| Nostalgia | nostalgia | Des panneaux blanc chromé sur une tuile bleue brillante. |
| Plateforme | Où le choix apparaît | Quand |
|---|---|---|
| Windows | Le 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é. |
| macOS | Le Dock et le sélecteur d'applications, pendant que Paneflow tourne. | Aussitôt. |
| Linux, X11 | L'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, Wayland | Nulle 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ée | terminal.minimum_contrast | Effet |
|---|---|---|
| Auto | clé absente | APCA Lc 60 pour tous les thèmes, clairs et sombres. |
| Off | 0 | Aucune correction. Les programmes conservent les couleurs demandées. |
| 45, 60, 75, 90 | ce nombre | Une 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.
| Champ | Rôle |
|---|---|
| Name | Cliquez 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é. |
| Image | Upload 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. |
| Color | Aucune 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. |
| Environment | Un résumé des variables de l'espace et un bouton Edit. Voir Environnement de l'espace. |
| Agent setup | Affiché 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_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.