EN
Démarrage

Première configuration

Créer une configuration Palabre, détecter les agents installés et définir des paramètres par défaut utiles.

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 :

  • codex répond en premier ;
  • claude répond en second ;
  • claude produit la synthèse finale ;
  • -t 4 demande 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.