FR
Configuration

Advanced JSON

Edit the configuration JSON directly for advanced use cases and custom agents.

Most common settings can be done with palabre config. This page covers cases where you edit palabre.config.json directly.

Minimal structure

{
  "outputDir": ".palabre",
  "defaults": {
    "agentA": "codex",
    "agentB": "claude",
    "summaryAgent": "claude",
    "turns": 4
  },
  "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",
      "args": ["--print", "--output-format", "text", "--no-session-persistence", "--tools", "Read,Glob,Grep"],
      "promptMode": "stdin",
      "role": "reviewer"
    }
  }
}

Main fields

FieldDescription
outputDirDestination folder for .debate.md, .chat.md, and .ask.md exports.
defaults.agentAAgent that responds first by default.
defaults.agentBAgent that responds second by default.
defaults.summaryAgentAgent used for the final summary by default.
defaults.turnsTotal number of turns, between 1 and 20.
agentsList of available agents. It must contain at least one usable agent.

CLI agent

"claude": {
  "type": "cli",
  "command": "claude.exe",
  "args": ["--print", "--output-format", "text", "--no-session-persistence", "--tools", "Read,Glob,Grep"],
  "promptMode": "stdin",
  "shell": false,
  "role": "reviewer"
}

Useful options:

OptionDescription
commandCommand to run.
argsArguments passed to the command.
promptModestdin or argument.
responseFormattext by default, or antigravity-json to extract a successful Antigravity JSON response (cli adapter only).
modelArgFlag used to pass a model.
modelDefault model for this agent.
shellUseful on Windows for certain npm or PowerShell wrappers.
roleAgent role.
timeoutMsGlobal timeout.
idleTimeoutMsTimeout if the CLI stays silent.
maxOutputBytesMaximum combined output size, 50 MiB by default. An invalid value restores this safe limit.
cols / rowsPseudo-terminal dimensions for cli-pty agents.

Ollama agent

"ollama-local": {
  "type": "ollama",
  "baseUrl": "http://localhost:11434",
  "model": "<installed-ollama-model>",
  "role": "critic",
  "validateModel": true,
  "unloadOtherModels": true
}

Useful options:

OptionDescription
modelOllama model used.
baseUrlOllama API URL.
validateModelVerifies that the model is installed.
autoPullModelAllows automatic download.
pullTimeoutMsDownload timeout.
unloadOtherModelsUnloads other models before generation.
keepAliveDuration to keep the model loaded.
temperatureResponse variation.
maxOutputBytesMaximum size of each buffered HTTP response, 50 MiB by default.

Scope of settings

Prefer palabre config when a command exists. After editing, read and reapprove the file for paths requiring it (see Approval). Changing args can remove default restrictions; PALABRE replaces only exactly recognized old default arrays, never custom arguments.

Other fields: language, defaults.mode (debate, ask, chat), defaults.askAgents, defaults.askSummaryAgent, defaults.interface, relay (review policy). Agents also have tier (primary or local). CLI agents use type: cli or cli-pty and support allowEmptyOutput, disabled by default.

Relay uses the target's type and command to identify its CLI, then builds its own arguments. It does not use the Debate agent's args, promptMode, model, shell or timeoutMs. Relay configuration is still required for authorized reviews.

An absolute command path is preserved during synchronization, even if missing; doctor and availability check that exact file, without verifying its version or falling back to PATH. To restore detection, replace the path with a simple command name yourself and reapprove when required.