Setup & Configuration
How to configure Deliberation: the two expert modes, the config.json schema and its
sections, OpenRouter model records, and opt-in session persistence. For provider
internals, environment variables, and manual MCP setup, see TECHNICAL.md.
Modes
Every expert supports two modes, chosen automatically from your request:
| Mode | Sandbox | Use when |
|---|---|---|
| Advisory | read-only |
Analysis, recommendations, reviews |
| Implementation | workspace-write |
Making changes, fixing issues |
Quick setup: init
bash
npx -y @antonbabenko/deliberation-mcp initinit is the fastest way to a working config on any host. /deliberation:setup runs it first.
In order, it:
- Finds the credentials you already have: a logged-in
codexCLI,agyonPATH,XAI_API_KEYandOPENROUTER_API_KEY.GEMINI_API_KEY/GOOGLE_API_KEYare reported but not used yet. Key values are never printed. - Writes the config at the normal path (
DELIBERATION_CONFIGwins). A new file enables each provider it found and has no model records, soOPENROUTER_API_KEYalone gives the built-in panel. An existing file only gains the missingproviders.<name>.enabled: trueflags; init shows them as a diff, asks on a terminal, and applies them without asking only with--yes. Anenabled: falseyou set is kept. - Pings each enabled provider with one tiny prompt and prints
OKorFAIL <errorKind>. - Runs one short demo consensus (one round, low effort) and prints the verdict and the
voices that answered.
--no-demoskips it. - Prints the install line for your host, or a short table when it cannot tell the host.
Run it again any time: a second run changes nothing and says so. When Deliberation was used
here before (a config file or saved sessions exist), the output is shorter and the demo is
skipped unless you pass --demo.