Démarrage rapide

Prérequis

• Node.js 20 ou plus
• pnpm 10
• Au moins un agent IA installé et configuré sur ta machine :
  • Claude Code (claude ou claude.exe)
  • Codex CLI (codex)
  • Gemini CLI (gemini)
  • Ollama pour les modèles locaux

Installation

pnpm install
pnpm build

Initialiser la configuration

pnpm start -- init

Cette commande crée un fichier palabre.config.json dans le dossier courant si il n'existe pas encore. Tu peux ensuite l'éditer pour y déclarer tes agents. Un ancien chicane.config.json reste lisible comme fallback de migration.

Pendant l'initialisation, Palabre détecte codex, claude, gemini et l'API locale Ollama. Quand une paire fiable est trouvée, elle devient le défaut de la config générée.

Premier débat

pnpm start -- run --preset codex-claude --subject "Comment structurer l'auth d'une app Nuxt ?"

Palabre va faire débattre Codex et Claude sur ce sujet pendant 4 tours (par défaut), puis générer une synthèse finale. La session est exportée dans un fichier .debate.md.

Pour donner du contexte projet sans choisir les fichiers un par un :

pnpm start -- run --preset codex-claude --subject "Critique cette architecture" --context src docs --turns 2

--context scanne les fichiers texte, respecte les exclusions courantes et affiche des avertissements pour les fichiers ignorés.

Installation globale locale

Depuis le repo :

pnpm build
pnpm link --global
palabre --version

Tu peux ensuite lancer palabre depuis un autre projet.

palabre codex-claude "Comment structurer l'auth d'une app Nuxt ?" -t 4
palabre -s "Critique rapide" -t 2

--subject est le nom long recommande pour le sujet. -s est son alias court, et --topic reste accepte pour compatibilite.

Pour afficher les étapes de mise à jour :

palabre update

Si Palabre est installé depuis ce repo git, tu peux aussi appliquer la mise à jour :

palabre update --apply

Vérifier l'installation

pnpm start -- --version
pnpm start -- --help