Advanced JSON
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
| Field | Description |
|---|---|
outputDir | Destination folder for .debate.md, .chat.md, and .ask.md exports. |
defaults.agentA | Agent that responds first by default. |
defaults.agentB | Agent that responds second by default. |
defaults.summaryAgent | Agent used for the final summary by default. |
defaults.turns | Total number of turns, between 1 and 20. |
agents | List 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:
| Option | Description |
|---|---|
command | Command to run. |
args | Arguments passed to the command. |
promptMode | stdin or argument. |
responseFormat | text by default, or antigravity-json to extract a successful Antigravity JSON response (cli adapter only). |
modelArg | Flag used to pass a model. |
model | Default model for this agent. |
shell | Useful on Windows for certain npm or PowerShell wrappers. |
role | Agent role. |
timeoutMs | Global timeout. |
idleTimeoutMs | Timeout if the CLI stays silent. |
maxOutputBytes | Maximum combined output size, 50 MiB by default. An invalid value restores this safe limit. |
cols / rows | Pseudo-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:
| Option | Description |
|---|---|
model | Ollama model used. |
baseUrl | Ollama API URL. |
validateModel | Verifies that the model is installed. |
autoPullModel | Allows automatic download. |
pullTimeoutMs | Download timeout. |
unloadOtherModels | Unloads other models before generation. |
keepAlive | Duration to keep the model loaded. |
temperature | Response variation. |
maxOutputBytes | Maximum 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.