Référence

Référence du fichier de configuration

Référence du format palabre.config.json, des agents, des defaults et des options avancées.

Cette page sert de référence rapide pour palabre.config.json.

Pour une explication progressive, commencez par Configuration.

Exemple complet

{
  "language": "fr",
  "outputDir": ".palabre",
  "defaults": {
    "mode": "debate",
    "agentA": "codex",
    "agentB": "claude",
    "askAgents": ["codex", "claude"],
    "summaryAgent": "claude",
    "askSummaryAgent": "claude",
    "turns": 4,
    "interface": "tui"
  },
  "agents": {
    "codex": {
      "type": "cli",
      "command": "codex",
      "args": ["exec", "--skip-git-repo-check", "--color", "never", "--sandbox", "read-only"],
      "promptMode": "stdin",
      "role": "implementer"
    },
    "claude": {
      "type": "cli",
      "command": "claude.exe",
      "args": ["--print", "--output-format", "text", "--no-session-persistence", "--tools", "Read,Glob,Grep"],
      "promptMode": "stdin",
      "shell": false,
      "role": "reviewer"
    }
  }
}

Racine

Champ	Type	Description
`language`	`fr` ou `en`	Langue de Palabre et des prompts envoyés aux agents. Peut être forcée ponctuellement avec `--language` ou `PALABRE_LANGUAGE`.
`outputDir`	string	Dossier d'export des fichiers `.debate.md`, `.chat.md` et `.ask.md`.

`defaults`

Champ	Type	Description
`mode`	`debate`, `chat` ou `ask`	Mode lancé par défaut quand aucun mode n'est fourni.
`agentA`	string	Agent qui répond en premier en Débat et agent actif initial en Chat.
`agentB`	string	Agent qui répond en second.
`askAgents`	string	Agents par défaut du mode ask, 4 maximum.
`summaryAgent`	string	Agent de synthèse finale du mode débat, et fallback du mode ask.
`askSummaryAgent`	string	Agent de synthèse finale spécifique au mode ask.
`turns`	number	Nombre total de réponses, entre 1 et 20.
`interface`	`tui` ou `terminal`	Interface par défaut pour les sessions interactives.

Agent CLI

Champ	Type	Description
`type`	`cli` ou `cli-pty`	Type de l'agent.
`command`	string	Commande à lancer.
`args`	string	Arguments transmis.
`promptMode`	`stdin` ou `argument`	Manière de transmettre le prompt.
`shell`	boolean	Lance via le shell système. La configuration générée l'active seulement pour certains wrappers Windows.
`role`	string	Rôle de l'agent.
`model`	string	Modèle par défaut optionnel.
`modelArg`	string	Flag modèle optionnel.
`timeoutMs`	number	Timeout global.
`idleTimeoutMs`	number	Timeout d'inactivité.
`maxOutputBytes`	number	Taille maximale cumulée de stdout et stderr, 50 Mio par défaut.
`allowEmptyOutput`	boolean	Autorise exceptionnellement une réponse CLI vide.
`cols` / `rows`	number	Dimensions du pseudo-terminal pour `cli-pty`.

Agent Ollama

Champ	Type	Description
`type`	`ollama`	Type de l'agent.
`baseUrl`	string	URL de l'API Ollama.
`model`	string	Modèle local.
`role`	string	Rôle de l'agent.
`validateModel`	boolean	Vérifie que le modèle existe.
`autoPullModel`	boolean	Télécharge le modèle si absent.
`pullTimeoutMs`	number	Timeout de téléchargement.
`unloadOtherModels`	boolean	Décharge les autres modèles.
`keepAlive`	string	Maintien du modèle chargé.
`temperature`	number	Variation des réponses.
`maxOutputBytes`	number	Taille maximale de chaque réponse HTTP bufferisée, 50 Mio par défaut.

Référence des commandes

Référence des commandes et options disponibles dans la CLI Palabre.

Presets

Liste et principe des presets de paires d'agents utilisables dans les commandes courtes.