FR
Reference

Configuration file reference

Reference for the palabre.config.json format, agents, defaults, and advanced options.

This page serves as a quick reference for palabre.config.json.

For a step-by-step explanation, start with Configuration.

Full example

{
  "language": "en",
  "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"
    }
  }
}

Root

FieldTypeDescription
languagefr or enPalabre and agent prompt language. Can be overridden for one command with --language or PALABRE_LANGUAGE.
outputDirstringExport folder for .debate.md, .relay.md, .ask.md, .chat.md; default .palabre, . treated as .palabre.

defaults

FieldTypeDescription
modedebate, chat, or askDefault mode when no mode is provided.
agentAstringAgent that responds first in Debate and is initially active in Chat.
agentBstringAgent that responds second.
askAgentsstringDefault ask mode agents, 4 maximum.
summaryAgentstringFinal summary agent for debate mode, and fallback for ask mode.
askSummaryAgentstringAsk-specific final summary agent.
turnsnumberTotal number of turns, between 1 and 20.
interfacetui or terminalDefault interface for interactive sessions.

CLI agent

FieldTypeDescription
typecli or cli-ptyAgent type.
commandstringCommand to run.
argsstringArguments passed.
promptModestdin or argumentHow the prompt is passed.
responseFormattext or antigravity-jsoncli adapter only; text by default. Antigravity JSON extracts only response when status is SUCCESS, without fallback.
shellbooleanRuns through the system shell. Generated configuration only enables it for selected Windows wrappers.
rolestringAgent role.
tierprimary / localAgent class; no effect on its role instruction.
modelstringOptional default model.
modelArgstringOptional model flag.
timeoutMsnumberGlobal timeout in milliseconds, 180,000 by default for CLI/PTY, 900,000 for OpenCode batch.
idleTimeoutMsnumberIdle timeout.
maxOutputBytesnumberMaximum combined stdout and stderr size, 50 MiB by default.
allowEmptyOutputbooleanExceptionally allows an empty CLI text response; does not allow empty or invalid Antigravity JSON.
cols / rowsnumberPseudo-terminal dimensions for cli-pty.

Ollama agent

FieldTypeDescription
typeollamaAgent type.
baseUrlstringOllama API URL.
modelstringLocal model.
rolestringAgent role.
tierprimary / localAgent class; no effect on its role instruction.
validateModelbooleanVerifies that the model exists.
autoPullModelbooleanDownloads the model if missing.
pullTimeoutMsnumberDownload timeout.
unloadOtherModelsbooleanUnloads other models.
keepAlivestringDuration to keep the model loaded.
temperaturenumberResponse variation.
maxOutputBytesnumberMaximum size of each buffered HTTP response, 50 MiB by default.

relay

view is optional: background (Background, default) or auto (Prefer the open conversation, explicit choice). Background limits tools and refuses an open target. In auto, an existing open Codex conversation uses its tools and permissions, including writing if allowed; when closed, it runs in background. A { "view": "background" } block is valid without authorizing reviews. Existing explicit values are preserved, without file migration. Only the owner changes this setting with palabre config --relay-view <auto|background>, after the file, choice and consequences are displayed, then TTY keyboard confirmation, without --yes or --trust-config. See Relay mode.

FieldTypeDescription
allowedTasksstringPreauthorizable task: review only.
reviewRepositoriesstringExact GitHub.com owner/repository or owner/* pattern.

Use palabre relay allow-repo owner/repository: keyboard confirmation in your terminal, never by an agent. When review is allowed, the repository list cannot be empty.

tier (primary / local) is optional for CLI and Ollama agents. timeoutMs is in milliseconds (180,000 by default for CLI/PTY, 900,000 for OpenCode batch, 300,000 in the Antigravity default). Relay ignores shell; adapters refuse a remaining shell wrapper for an argument prompt. outputDir defaults to .palabre; . is treated as .palabre. It also receives .relay.md; Mission keeps .palabre/missions/<id>/ independently. The example above is a complete two-agent configuration, not the full generated agent set.