AI-powered implementation planning using multiple LLMs that debate and synthesize the best approach.
Follow us on X: https://x.com/council_cli
- Propose - 4 different LLMs generate implementation plans for your task
- Rank - Each LLM blindly scores all plans on simplicity, correctness, security, and performance
- Synthesize - A chairman model creates the final plan by combining the best ideas
npm install -g council-cli# Basic usage (always wrap your task in quotes!)
council "your task description"
# With custom output file
council "add JWT auth" --output auth-plan.md
# Show help
council --help| Option | Description |
|---|---|
-o, --output |
Output file name (default: councilplan.md) |
-h, --help |
Show help message |
On first run, Council will prompt you for your OpenRouter API key:
No OpenRouter API key found.
Get your key at: https://openrouter.ai/keys
Enter your OpenRouter API key: sk-or-v1-xxxxx
Get your API key at: https://openrouter.ai/keys
The configuration is saved to ~/.config/council/config.yaml for future use.
All files are saved to a ./llmcouncil/ folder in your current directory:
| File | Description |
|---|---|
stage1.md |
All proposals from each model |
stage2.md |
Rankings table and each model's evaluation |
stage3.md |
Chairman's analysis and thinking process |
councilplan.md |
Final synthesized implementation plan |
$ council "add user authentication with JWT tokens"
🏛️ Council CLI
Task: "add user authentication with JWT tokens"
Output folder: ./llmcouncil/
[1/3] Generating proposals from models...
✓ anthropic/claude-sonnet-4.5 ✓
✓ openai/gpt-5.2-codex ✓
✓ google/gemini-3-pro-preview ✓
✓ moonshotai/kimi-k2.5 ✓
[2/3] Models ranking all plans blindly...
✓ All models ranked ✓
[3/3] Chairman synthesizing final plan...
✓ anthropic/claude-opus-4.5 synthesis complete ✓
✓ All files saved to ./llmcouncil/:
- stage1.md (proposals)
- stage2.md (rankings)
- stage3.md (chairman analysis)
- councilplan.md (final plan)Edit ~/.config/council/config.yaml to customize models:
openrouter_api_key: sk-or-v1-xxxxx
proposer_models:
- anthropic/claude-sonnet-4.5
- openai/gpt-5.2-codex
- google/gemini-3-pro-preview
- moonshotai/kimi-k2.5
chairman_model: anthropic/claude-opus-4.5- Node.js >= 18.0.0
- OpenRouter API key
MIT