Consensus mode enables multiple AI models to collaborate on a task through a structured process of proposing solutions, voting, and synthesizing the best approach.
Usage
TUI (Interactive)
/consensus <agents> "<prompt>"
/settings # configure rounds & synthesizer
CLI
puzldai consensus "<prompt>" -a <agents> [-r rounds] [-s synthesizer]
| Flag | Description |
|---|
-a | Comma-separated agents to participate |
-r | Number of voting rounds (default: 2) |
-s | Agent to synthesize final result |
Examples
# TUI: Three-model consensus
/consensus claude,gemini,codex "Design the authentication system"
# CLI: With 3 rounds and claude as synthesizer
puzldai consensus "Choose the best database" -a claude,gemini,ollama -r 3 -s claude
How It Works
Proposal Phase
Each agent independently proposes a solution to the task. They receive project structure context but don’t see other agents’ proposals to avoid bias.
Voting Rounds
Agents review all proposals and vote for the best one, providing reasoning. Multiple voting rounds allow positions to evolve.
Synthesis
A synthesizer agent analyzes the votes, identifies the winning proposal, and creates a unified final solution incorporating the best ideas.
Configuration
TUI Settings
Configure consensus options via /settings → Collaboration tab:
| Setting | Description |
|---|
| Rounds | Number of voting rounds (1-5, default: 2) |
| Synthesizer | Agent to synthesize final result (default: auto/first agent) |
CLI Flags
| Flag | Description |
|---|
-a | Comma-separated agents to participate (required) |
-r | Number of voting rounds (default: 2) |
-s | Agent to synthesize final result |
Actions After Consensus
After consensus completes, you can:
| Action | Description |
|---|
| Build | Enter Build mode to implement the synthesized solution |
| Continue | Accept the result and continue chatting |
| Reject | Discard the result |
Project Context
Consensus mode automatically provides project structure to all agents, enabling them to make informed proposals that reference actual files and directories in your codebase.
Keyboard Shortcuts
| Key | Action |
|---|
Escape | Hide view (keeps running in background) |
Ctrl+E | Return to consensus view |
Ctrl+C | Cancel operation |
↑/↓ | Navigate action options |
Enter | Select action |
Best Practices
Use consensus for architectural decisions - When there are multiple valid approaches, consensus helps explore options and reach agreement.
Requires 2+ agents - Consensus needs at least two models to vote and reach agreement.
Example Output
─── Consensus ───
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ claude │ │ gemini │ │ codex │
│ [proposal] │ │ [proposal] │ │ [proposal] │
│ Use JWT with... │ │ Session-based...│ │ OAuth 2.0... │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Voting Round 1...
Winner: claude's proposal (2 votes)
Synthesis:
Based on the consensus, JWT authentication is recommended...
