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 localfor 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)
Scan to join WeChat group