Package Exports

council-cli
council-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (council-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Council CLI

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

How It Works

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

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