EN
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

ChampTypeDescription
languagefr ou enLangue de Palabre et des prompts envoyés aux agents. Peut être forcée ponctuellement avec --language ou PALABRE_LANGUAGE.
outputDirstringDossier des exports .debate.md, .relay.md, .ask.md, .chat.md ; défaut .palabre, . traité comme .palabre.

defaults

ChampTypeDescription
modedebate, chat ou askMode lancé par défaut quand aucun mode n'est fourni.
agentAstringAgent qui répond en premier en Débat et agent actif initial en Chat.
agentBstringAgent qui répond en second.
askAgentsstringAgents par défaut du mode ask, 4 maximum.
summaryAgentstringAgent de synthèse finale du mode débat, et fallback du mode ask.
askSummaryAgentstringAgent de synthèse finale spécifique au mode ask.
turnsnumberNombre total de réponses, entre 1 et 20.
interfacetui ou terminalInterface par défaut pour les sessions interactives.

Agent CLI

ChampTypeDescription
typecli ou cli-ptyType de l'agent.
commandstringCommande à lancer.
argsstringArguments transmis.
promptModestdin ou argumentManière de transmettre le prompt.
responseFormattext ou antigravity-jsonAdapter cli seulement ; texte par défaut. JSON Antigravity : extrait uniquement response si status vaut SUCCESS, sans repli.
shellbooleanActive la résolution prudente des wrappers Windows ; les natifs et shims reconnus restent lancés sans shell. Ignoré par Relay.
rolestringRôle de l'agent.
tierprimary / localClasse de l’agent ; sans effet sur la consigne de rôle.
modelstringModèle par défaut optionnel.
modelArgstringFlag modèle optionnel.
timeoutMsnumberDélai global en millisecondes, 180 000 par défaut pour CLI/PTY, 900 000 pour OpenCode batch.
idleTimeoutMsnumberTimeout d'inactivité.
maxOutputBytesnumberTaille maximale cumulée de stdout et stderr, 50 Mio par défaut.
allowEmptyOutputbooleanAutorise exceptionnellement une réponse CLI texte vide ; sans effet sur le refus d'un JSON Antigravity vide ou invalide.
cols / rowsnumberDimensions du pseudo-terminal pour cli-pty.

Agent Ollama

ChampTypeDescription
typeollamaType de l'agent.
baseUrlstringURL de l'API Ollama.
modelstringModèle local.
rolestringRôle de l'agent.
tierprimary / localClasse de l’agent ; sans effet sur la consigne de rôle.
validateModelbooleanVérifie que le modèle existe.
autoPullModelbooleanTélécharge le modèle si absent.
pullTimeoutMsnumberTimeout de téléchargement.
unloadOtherModelsbooleanDécharge les autres modèles.
keepAlivestringMaintien du modèle chargé.
temperaturenumberVariation des réponses.
maxOutputBytesnumberTaille maximale de chaque réponse HTTP bufferisée, 50 Mio par défaut.

relay

view est facultatif : background (Arrière-plan, défaut) ou auto (Privilégier la conversation ouverte, choix explicite). En arrière-plan, les outils sont limités et une cible ouverte est refusée. En auto, une conversation Codex existante ouverte utilise ses outils et permissions, écriture comprise si autorisée ; fermée, elle part en arrière-plan. Un bloc { "view": "background" } est valide sans autoriser de revue. Les valeurs explicites existantes sont conservées, sans migration de fichier. Seul le propriétaire change ce réglage avec palabre config --relay-view <auto|background>, après affichage du fichier, du choix et de ses conséquences, puis confirmation clavier TTY, sans --yes ni --trust-config. Voir Mode Relay.

ChampTypeDescription
allowedTasksstringTâche préautorisable : review seulement.
reviewRepositoriesstringDépôt GitHub.com exact proprietaire/depot ou motif proprietaire/*.

Utilisez palabre relay allow-repo proprietaire/depot : confirmation au clavier dans votre terminal, jamais par un agent. Si review est autorisé, la liste de dépôts ne peut pas être vide.

tier (primary / local) est optionnel pour les agents CLI et Ollama. timeoutMs est exprimé en millisecondes (180 000 par défaut pour CLI/PTY, 900 000 pour OpenCode batch, 300 000 dans le défaut Antigravity). shell est ignoré par Relay ; les adapters refusent un wrapper shell restant pour un prompt en argument. outputDir vaut .palabre par défaut ; . est traité comme .palabre. Il reçoit aussi .relay.md ; Mission garde .palabre/missions/<id>/, indépendamment de ce réglage. L'exemple ci-dessus est une configuration complète avec deux agents, pas la totalité des agents générés.