Configuration
La configuration indique à Palabre quels agents existent, quels agents utiliser par défaut et où écrire les exports. Si outputDir n'est pas défini, les fichiers .debate.md, .chat.md et .ask.md sont créés dans le dossier .palabre/ par défaut.
Créer une configuration
Dans un terminal interactif, palabre crée automatiquement la configuration globale au premier lancement quand elle n'existe pas encore, puis ouvre l'accueil TUI :
palabre
La commande explicite reste disponible pour les scripts, la CI, ou quand vous voulez créer une config sans entrer dans la TUI :
palabre init
Cette commande crée une configuration globale :
~/.palabre/palabre.config.json
Pour une configuration propre au projet courant :
palabre init --local
Cela crée :
./palabre.config.json
Voir la configuration utile
palabre
palabre agents
palabre doctor
Depuis l'accueil TUI, /config affiche les réglages courants et /agents liste les agents disponibles. Hors TUI, palabre agents affiche les agents déclarés et leur détection locale. palabre doctor vérifie les erreurs courantes.
Au démarrage de l'accueil TUI, Palabre synchronise prudemment les agents connus détectés : il peut ajouter les agents connus manquants et rafraîchir les noms de commandes connus, mais il n'écrase pas les agents custom, les rôles, les modèles ni les defaults utilisateur.
Une commande configurée avec un chemin absolu reste inchangée lors de la synchronisation, même si le fichier a disparu ; palabre doctor vérifie alors ce fichier précis. Pour les détails et le retour à la détection automatique, voir JSON avancé.
Modifier les paramètres courants
palabre config
Dans la TUI, /config permet de définir ou supprimer les paramètres par défaut sans quitter Palabre. Les commandes directes ci-dessous permettent aussi de modifier un seul réglage depuis le terminal ou un script.
Commandes directes utiles :
palabre config --set-defaults codex claude --summary-agent claude -t 4
palabre config --mode ask --ask-agents codex claude opencode --ask-summary-agent opencode
palabre config --interface tui
palabre config --language en
palabre config -t 3
palabre config --summary-agent claude
palabre config --clear-defaults
palabre config --sync-agents
palabre config --ollama-models --json
palabre config --set-ollama-model <modele-ollama-installe>
palabre config --sync-ollama-model
Dans la TUI, les mêmes réglages courants sont accessibles depuis /config avec des commandes comme /agents, /roles, /summary, /turns, /interface, /language, /mode, /ollama, /ollama-url <url|default>, /ollama-model <modele> et /ollama-sync. Utilisez /home pour revenir à l'accueil.
Aller plus loin
Approbation et Relay
L'approbation lie le chemin et l'empreinte du fichier à ~/.palabre/trusted-configs.json. init approuve sa création ; config et relay allow-repo maintiennent une approbation existante, sans en inventer une. Une édition manuelle demande une nouvelle approbation lorsque le parcours la vérifie : configuration projet implicite et tous les appels Relay. Vous relisez le fichier, puis utilisez palabre config --config <fichier> --trust-config ; jamais un agent pour élargir ses droits. Voir Portée de l’approbation.
La politique relay.allowedTasks / relay.reviewRepositories se modifie avec palabre relay allow-repo proprietaire/depot, après confirmation humaine. outputDir reçoit aussi les .relay.md ; l’option Mission utilise .palabre/missions/<id>/ indépendamment de ce réglage.