Council CLI

AI-powered implementation planning using multiple LLMs that debate and synthesize the best approach.

Follow us on X: https://x.com/council_cli

How It Works

1. Propose - 4 different LLMs generate implementation plans for your task
2. Rank - Each LLM blindly scores all plans on simplicity, correctness, security, and performance
3. Synthesize - A chairman model creates the final plan by combining the best ideas

Installation

npm install -g council-cli

Usage

# 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

Options

| Option | Description | |--------|-------------| | -o, --output | Output file name (default: councilplan.md) | | -h, --help | Show help message |

Setup

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.

Output

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 |

Example

$ 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)

Configuration

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

Requirements

• Node.js >= 18.0.0
• OpenRouter API key

License

MIT