LLM Council Plugin for Claude Code
A multi-model consensus engine that integrates OpenAI Codex CLI, Google Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Overview
The LLM Council summons multiple AI models to deliberate on your technical questions. Each model provides its perspective, reviews its peers' answers, and a chairman synthesizes everything into a final verdict.
How It Works
┌─────────────────────────────────────────────────────────────┐
│ LLM COUNCIL WORKFLOW │
├─────────────────────────────────────────────────────────────┤
│ │
│ Stage 1: Opinion Collection (Parallel) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Claude │ │ Codex │ │ Gemini │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │
│ v v v │
│ Stage 2: Peer Review (Cross-examination) │
│ ┌─────────────────────────────────────┐ │
│ │ Each model reviews others' answers │ │
│ └─────────────────────────────────────┘ │
│ │ │
│ v │
│ Stage 3: Chairman Synthesis │
│ ┌─────────────────────────────────────┐ │
│ │ Claude Opus synthesizes the verdict │ │
│ └─────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
Quick Start
Prerequisites
Required Dependencies
Before installing the plugin, ensure these critical dependencies are available:
| Dependency | Purpose | Installation |
|---|
| jq | JSON parsing for hook security validations | macOS: brew install jq
Ubuntu/Debian: sudo apt-get install jq
Alpine: apk add jq
Verify: jq --version |
| Claude CLI | Required for council deliberations | See code.claude.com/docs/setup |
⚠️ IMPORTANT: Without jq, all security validations are disabled:
- ❌ Command injection detection
- ❌ Sensitive data leak detection (API keys, tokens)
- ❌ Council quorum verification
- ❌ Command length limits
Optional Dependencies (for multi-model council)
For full three-model council functionality, install these optional CLIs:
| CLI | Installation | Purpose |
|---|
| Codex | npm install -g @openai/codex | Adds OpenAI perspective |
| Gemini | npm install -g @google/gemini-cli | Adds Google perspective |
Note: The plugin works with Claude CLI alone, but multi-model deliberation provides richer perspectives.
Installation
For a full installation and debugging walkthrough, see docs/INSTALL.md.
Option A: Install via Marketplace (Recommended)
In Claude Code, run these commands:
# Add the marketplace
/plugin marketplace add xrf9268-hue/llm-council-plugin
# Install the plugin
/plugin install llm-council-plugin@llm-council
Alternatively, you can add via Git URL:
/plugin marketplace add https://github.com/xrf9268-hue/llm-council-plugin.git
Option B: Local Development
Clone this repo:
git clone https://github.com/xrf9268-hue/llm-council-plugin.git .claude-plugins/llm-council
Note: Scripts already have execute permissions set in the repository. They should work immediately after cloning on Linux/Mac systems. Only run chmod +x if you encounter permission errors (e.g., on Windows or after extracting from ZIP):
# Only needed if scripts aren't executable:
chmod +x .claude-plugins/llm-council/hooks/*.sh .claude-plugins/llm-council/skills/council-orchestrator/scripts/*.sh
⚠️ Troubleshooting Hook Issues
If you see errors like "BLOCKED: Detected potentially dangerous pattern: &&", your cached plugin is outdated.
Quick fix:
# Run diagnostic script
./scripts/verify-plugin-version.sh
# Or manually update cache
rm -rf ~/.claude/plugins/cache/llm-council-plugin
# Then reinstall the plugin
See docs/TROUBLESHOOTING.md for comprehensive troubleshooting guidance.
Usage
Using the Slash Command
In Claude Code, use the /council command:
/council "How should I implement rate limiting in a Node.js API?"
Each /council run:
- Resets the
.council/ working directory for this session.
- Runs opinion collection, peer review, and chairman synthesis.
- Displays the final report in chat and saves it to
.council/final_report.md.
xrf9268-hue