llm-council

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.