Getting Started

Install AI Council, set up your license key, and run your first multi-agent AI code review in minutes.

Installation

AI Council is distributed as an npm package with pre-compiled binaries for all major platforms.

Terminal 
npm install -g @mugzie/ai-council

This automatically installs the correct binary for your platform:

  • macOS - darwin-arm64 (Apple Silicon) or darwin-x64 (Intel)
  • Linux - linux-arm64 or linux-x64
  • Windows - win32-x64
💡
Verify Installation

Run ai-council --help to verify the installation was successful.

Claude Code CLI & Agent SDK (Optional)

To use Agent Review mode (--agent), you need the Claude Code CLI and the Claude Agent SDK.

Install Claude Code CLI 
npm install -g @anthropic-ai/claude-code
Install Claude Agent SDK 
npm install @anthropic-ai/claude-agent-sdk

You will also need an Anthropic API key. Set it in your environment:

Bash / Zsh 
export ANTHROPIC_API_KEY="sk-ant-..."
💡
Not required for standard reviews

Claude Code and the Agent SDK are only needed for --agent mode. All other review modes (review, security, perf, arch, sanity, --deep-analysis) work with just an OpenAI and/or Gemini API key.

License Setup

AI Council requires a valid license key to operate. Purchase your license from our store.

Purchase License

Once you have your license key, set it as an environment variable:

Bash / Zsh 
export AI_COUNCIL_LICENSE_KEY="your-license-key"
Add to shell profile (~/.zshrc or ~/.bashrc) 
# AI Council License
export AI_COUNCIL_LICENSE_KEY="your-license-key"

Quick Start

Get up and running with AI Council in under a minute.

1

Install the package

npm install -g @mugzie/ai-council
2

Set your license key

export AI_COUNCIL_LICENSE_KEY="your-key"
3

Configure AI provider (at least one required)

# OpenAI (recommended)
export OPENAI_API_KEY="sk-..."

# Or Google Gemini
export GEMINI_API_KEY="..."

# Or both for best results!
4

Run your first review

ai-council review --diff --branch=main --pretty

Need Help?

Can't find what you're looking for? Here are some resources:

Email Support (answered within one business day) Frequently Asked Questions Manage License & Billing