AI Consultants v2.9.1 - AI Expert Panel

Simultaneously consult multiple AIs as "consultants" for coding questions. Each consultant has a configurable persona that influences their response style.

Quick Start

/ai-consultants:config-wizard       # Initial setup
/ai-consultants:consult "Your question here"

What's New in v2.9

• Kimi CLI Consultant: New "The Eastern Sage" persona for holistic understanding (v2.9)
• Amp CLI Consultant: "The Systems Thinker" persona for system design (v2.8)
• Qwen CLI Support: CLI/API mode switching for Qwen3 (v2.7)
• CLI/API Mode Switching: Gemini, Codex, Claude, Mistral, Qwen3 can use CLI or API (v2.6)
• Model Quality Tiers: premium, standard, economy with apply_model_tier() (v2.5)
• Budget Enforcement: Configurable cost limits with ENABLE_BUDGET_LIMIT (v2.4)
• Premium Model Defaults: All consultants now use flagship models by default
• 14 Consultants: Gemini, Codex, Mistral, Kilo, Cursor, Aider, Amp, Kimi, Claude, Qwen3, GLM, Grok, DeepSeek, Ollama

Slash Commands

Consultation Commands

| Command | Description | |---------|-------------| | /ai-consultants:consult | Main consultation - ask AI consultants a coding question | | /ai-consultants:ask-experts | Quick query alias for consult | | /ai-consultants:debate | Run consultation with multi-round debate | | /ai-consultants:help | Show all commands and usage |

Configuration Commands

| Command | Description | |---------|-------------| | /ai-consultants:config-wizard | Full interactive setup (CLI detection, API keys, personas) | | /ai-consultants:config-check | Verify CLI agents are installed and authenticated | | /ai-consultants:config-status | View current configuration | | /ai-consultants:config-preset | Set default preset (minimal, balanced, high-stakes, local) | | /ai-consultants:config-strategy | Set default synthesis strategy | | /ai-consultants:config-features | Toggle features (Debate, Synthesis, Peer Review, etc.) | | /ai-consultants:config-personas | Change consultant personas | | /ai-consultants:config-api | Configure API-based consultants (Qwen3, GLM, Grok, DeepSeek) |

Configuration Workflow

Set your preferences using slash commands:

/ai-consultants:config-preset       # Choose default preset
/ai-consultants:config-strategy     # Choose synthesis strategy
/ai-consultants:config-features     # Enable/disable features
/ai-consultants:config-status       # View current settings

Consultants and Personas

| Consultant | CLI | Persona | Focus | |------------|-----|---------|-------| | Google Gemini | gemini | The Architect | Design patterns, scalability | | OpenAI Codex | codex | The Pragmatist | Simplicity, proven solutions | | Mistral Vibe | vibe | The Devil's Advocate | Edge cases, vulnerabilities | | Kilo Code | kilocode | The Innovator | Creativity, unconventional | | Cursor | agent | The Integrator | Full-stack perspective | | Aider | aider | The Pair Programmer | Collaborative coding | | Amp | amp | The Systems Thinker | System design, interactions | | Kimi | kimi | The Eastern Sage | Holistic, balanced perspectives | | Claude | claude | The Synthesizer | Big picture, synthesis | | Qwen | qwen | The Analyst | Data-driven, metrics | | Ollama | ollama | The Local Expert | Privacy-first, zero cost |

API-only consultants: GLM (The Methodologist), Grok (The Provocateur), DeepSeek (The Code Specialist)

CLI/API Mode: Gemini, Codex, Claude, Mistral, and Qwen can switch between CLI and API mode via *_USE_API environment variables.

Self-Exclusion: The invoking agent is automatically excluded from the panel. When invoked from Claude Code, Claude is excluded; when invoked from Codex CLI, Codex is excluded, etc.

Requirements

• At least 2 consultant CLIs installed and authenticated
• jq for JSON processing

Quick Install

curl -fsSL https://raw.githubusercontent.com/matteoscurati/ai-consultants/main/scripts/install.sh | bash
~/.claude/skills/ai-consultants/scripts/doctor.sh --fix

CLI Installation

npm install -g @google/gemini-cli      # Gemini
npm install -g @openai/codex           # Codex
pip install mistral-vibe               # Mistral
npm install -g @kilocode/cli           # Kilo
npm install -g @qwen-code/qwen-code@latest  # Qwen
curl -fsSL https://ampcode.com/install.sh | bash  # Amp
pip install kimi-cli && kimi login     # Kimi
brew install jq                        # Required

# For local inference (optional)
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2

Configuration Presets

| Preset | Consultants | Use Case | |--------|-------------|----------| | minimal | 2 (Gemini + Codex) | Quick questions | | balanced | 4 (+Mistral +Kilo) | Standard use | | thorough | 5 (+Cursor) | Comprehensive | | high-stakes | All + debate | Critical decisions | | local | Ollama only | Full privacy | | security | Security-focused | +Debate | | cost-capped | Budget-friendly | Low cost |

Synthesis Strategies

| Strategy | Description | |----------|-------------| | majority | Most common answer wins (default) | | risk_averse | Weight conservative responses | | security_first | Prioritize security | | cost_capped | Prefer cheaper solutions | | compare_only | No recommendation |

Usage Examples

Basic Consultation

/ai-consultants:consult "How to optimize this SQL query?"

With File Context

/ai-consultants:consult "Review this authentication flow" src/auth.ts

With Debate

/ai-consultants:debate "Microservices or monolith for our new service?"

Bash Usage

cd ~/.claude/skills/ai-consultants

# With preset
./scripts/consult_all.sh --preset balanced "Best approach for caching?"

# With strategy
./scripts/consult_all.sh --strategy risk_averse "Security question"

# With local model
./scripts/consult_all.sh --preset local "Private question"

Workflow

Query -> Classify -> Parallel Queries -> Voting -> Synthesis -> Report
                          |                |           |
                     Gemini (8)      Consensus    Recommendation
                     Codex (7)       Analysis     Comparison
                     Mistral (6)                  Risk Assessment

With debate:

Round 1 -> Cross-Critique -> Round 2 -> Final Synthesis

Usage Triggers

Automatic

• Doubts about implementation approach
• Validating complex solutions
• Exploring architectural alternatives

Explicit

• "Ask the consultants..."
• "What do the other models think?"
• "Compare solutions"
• "I want a second opinion"

Features

| Feature | Description | Toggle | |---------|-------------|--------| | Personas | Each consultant has a role that shapes responses | ENABLE_PERSONA | | Synthesis | Auto-combine responses into recommendation | ENABLE_SYNTHESIS | | Debate | Consultants critique each other's answers | ENABLE_DEBATE | | Peer Review | Consultants anonymously rank each other | ENABLE_PEER_REVIEW | | Smart Routing | Auto-select best consultants per question type | ENABLE_SMART_ROUTING | | Cost Tracking | Track API usage costs | ENABLE_COST_TRACKING | | Panic Mode | Auto-add rigor when uncertainty detected | ENABLE_PANIC_MODE |

Configuration

# Defaults (v2.9)
DEFAULT_PRESET=balanced      # Preset when --preset not given
DEFAULT_STRATEGY=majority    # Strategy when --strategy not given

# Core features
ENABLE_DEBATE=true           # Multi-agent debate
ENABLE_SYNTHESIS=true        # Automatic synthesis
ENABLE_PEER_REVIEW=false     # Anonymous peer review
ENABLE_PANIC_MODE=auto       # Auto-rigor for uncertainty

# CLI/API Mode Switching (v2.6+)
GEMINI_USE_API=false         # Use Google AI API instead of CLI
CODEX_USE_API=false          # Use OpenAI API instead of CLI
CLAUDE_USE_API=false         # Use Anthropic API instead of CLI
MISTRAL_USE_API=false        # Use Mistral API instead of CLI
QWEN3_USE_API=true           # Use DashScope API (default) or CLI

# New consultants (v2.7-2.9)
ENABLE_AMP=false             # Amp CLI - The Systems Thinker
AMP_MODEL=amp
ENABLE_KIMI=false            # Kimi CLI - The Eastern Sage
KIMI_MODEL=kimi-code/kimi-for-coding
ENABLE_QWEN3=false           # Qwen CLI/API - The Analyst
QWEN3_MODEL=qwen3-max

# Ollama (local models)
ENABLE_OLLAMA=true
OLLAMA_MODEL=qwen2.5-coder:32b

# Budget management (v2.4)
ENABLE_BUDGET_LIMIT=false
MAX_SESSION_COST=1.00
BUDGET_ACTION=warn           # warn or stop

Output

/tmp/ai_consultations/TIMESTAMP/
├── gemini.json        # Individual responses
├── codex.json
├── voting.json        # Consensus
├── synthesis.json     # Recommendation
└── report.md          # Human-readable

Doctor Command

Diagnose and fix issues:

./scripts/doctor.sh              # Full check
./scripts/doctor.sh --fix        # Auto-fix
./scripts/doctor.sh --json       # JSON output

Interpreting Results

| Scenario | Recommendation | |----------|----------------| | High confidence + High consensus | Proceed confidently | | Low confidence OR Low consensus | Consider more options | | Mistral disagrees | Investigate risks | | Panic mode triggered | Add debate rounds |

Best Practices

Security

• Never include credentials in queries
• Use --preset local for sensitive code

Effective Queries

• Be specific about the question
• Include constraints (performance, etc.)
• Use debate for controversial decisions

Troubleshooting

| Issue | Solution | |-------|----------| | "Unknown skill" | Run install script or check ~/.claude/commands/ | | "Exit code 1" | Run /ai-consultants:config-check to diagnose | | No consultants | Run /ai-consultants:config-wizard | | API errors | Check /ai-consultants:config-status | | CLI not found | Run ./scripts/doctor.sh --fix |

Extended Documentation

• Setup Guide - Installation, authentication, Claude Code setup
• Cost Rates - Model pricing
• Smart Routing - Category routing
• JSON Schema - Output format

Known Limitations

• Minimum 2 consultants required
• Smart Routing off by default
• Synthesis requires Claude CLI (fallback available)
• Estimated costs (heuristic token counting)