Première configuration
Première configuration automatique
Dans un terminal interactif, le plus simple est de lancer :
palabre
Si aucune configuration n'existe encore, Palabre crée la configuration globale :
~/.palabre/palabre.config.json
Il détecte les outils disponibles localement, choisit des paramètres utiles quand c'est possible, puis ouvre l'accueil TUI.
Initialisation explicite
Vous pouvez toujours initialiser Palabre explicitement :
palabre init
Cette commande crée la même configuration globale :
~/.palabre/palabre.config.json
Elle détecte aussi les outils disponibles localement : Codex, Claude, Antigravity, OpenCode, Mistral Vibe et Ollama. Après la création, Palabre affiche la langue active et la commande rapide pour basculer vers l'autre langue.
Pour une configuration propre au projet courant :
palabre init --local
Choisir la langue
Par défaut, Palabre utilise le français. Pour passer l'interface et les prompts envoyés aux agents en anglais :
palabre config --language en
Pour revenir au français :
palabre config --language fr
Vous pouvez aussi choisir la langue directement à l'initialisation :
palabre init --language en
Vérifier l'installation
palabre doctor
doctor ne lance aucun agent IA. Il vérifie la configuration, les commandes disponibles, Ollama et les modèles locaux déclarés.
Voir les agents déclarés
palabre agents
ou :
palabre -a
Cette commande affiche les agents présents dans votre configuration et indique s'ils sont détectés sur votre machine.
Choisir des agents par défaut
Le plus simple est d'utiliser l'assistant :
palabre config
Vous pouvez aussi définir directement les agents par défaut :
palabre config --set-defaults codex claude --summary-agent claude -t 4
Ici :
codexrépond en premier ;clauderépond en second ;claudeproduit la synthèse finale ;-t 4demande jusqu'à quatre réponses au total (deux par agent si toutes sont jouées, hors synthèse).
Rôles complémentaires aux modes
Les rôles orientent les consignes des agents en Débat, Ask et Chat, pas en Relay. Ils complètent le mode choisi : un implementer propose, un reviewer cherche les risques, un critic remet les hypothèses en question, un architect structure les options et un scout explore. Ils ne changent ni le modèle ni les permissions. La synthèse finale utilise automatiquement la consigne summarizer, quel que soit le rôle habituel de l'agent choisi.
Pour une session : --role-a / --role-b en Débat, --ask-role en Ask, --role-a pour l'interlocuteur initial en Chat. Pour le rôle par défaut : palabre agent-role <agent> <rôle>. Dans Relay, « chef de mission » et « équipier » décrivent qui confie et qui reçoit la tâche ; ce ne sont pas ces rôles configurables. Voir la référence CLI.
Ajouter des agents détectés plus tard
Si vous installez Claude Code, Codex, Antigravity, OpenCode, Mistral Vibe ou Ollama après avoir créé la configuration :
palabre config --sync-agents
Cette commande ajoute les agents connus détectés manquants et rafraîchit les noms de commandes connus sans écraser vos agents custom ni vos defaults existants. L'accueil TUI effectue la même synchronisation prudente automatiquement au démarrage.
Les commandes déjà configurées avec un chemin absolu sont conservées, même si ce chemin est introuvable ; aucun repli silencieux vers une autre installation.
Étape suivante
Vous pouvez maintenant lancer une première session.
Autres réglages et approbation
palabre config --mode ask --ask-agents codex claude opencode
palabre config --interface terminal
palabre config --clear-defaults
--clear-defaults retire les paramètres par défaut ; il ne désinstalle pas les agents. Voir palabre config --help.
palabre init --local crée ./palabre.config.json, prioritaire sur la configuration globale dans ce dossier. Une configuration peut lancer des commandes avec vos droits : PALABRE exige une approbation pour une configuration projet implicite et pour les configurations utilisées par Relay, locales ou globales. init approuve le fichier qu'il crée ; une modification manuelle invalide cette approbation. Vous relisez le fichier, puis confirmez dans un terminal ou lancez palabre config --config <fichier> --trust-config. Un agent ne doit jamais approuver une politique pour s'accorder des droits.
Pour autoriser la seule tâche de revue Relay sur un dépôt, lancez vous-même palabre relay allow-repo proprietaire/depot dans votre terminal visible : une confirmation au clavier est requise. Voir Relay.