IntelligenceX

Getting Started with IntelligenceX

Edit on GitHub

Start with IntelligenceX using the reviewer wizard, IX Chat, .NET library, or PowerShell module, then expand into tools, Project Ops, and automation.

Getting Started with IntelligenceX

Get up and running with the part of IntelligenceX you need first. The fastest path is the reviewer onboarding flow, but the platform also includes IX Chat, tool packs, a .NET library, and a PowerShell module for local automation.

Choose Your Starting Point

Prerequisites

  • .NET 8.0 or later
  • GitHub account with repository access
  • ChatGPT account or GitHub Copilot access

The fastest way to set up IntelligenceX:

# Run from source
dotnet run --project IntelligenceX.Cli/IntelligenceX.Cli.csproj -c Release -- setup wizard

The wizard guides you through:

  1. Running preflight auto-detect (recommended): intelligencex setup autodetect
  2. Choosing your path (new setup, fix expired auth, cleanup, maintenance)
  3. Connecting to GitHub (OAuth, PAT, or your own GitHub App)
  4. Selecting repositories for review
  5. Choosing a review preset (balanced, picky, security, minimal, etc.)
  6. Creating a PR with the GitHub Actions workflow

See Web Onboarding Flow for the canonical path/auth requirements matrix and Bot contract-check flow.

Option 2 - Local Web UI (Preview)

For a visual setup experience:

intelligencex setup web

This starts a local web server (localhost only) with a step-by-step UI. See Web Setup UI for details.

Option 3 - Manual Setup

For full control:

# 1. Authenticate with ChatGPT
intelligencex auth login

# 2. Export the auth bundle
intelligencex auth export --format store-base64

# 3. Add to GitHub as a secret named INTELLIGENCEX_AUTH_B64
# 4. Create the workflow file

See CLI Quick Start for the complete manual flow.

What Happens After Reviewer Setup

Once the workflow is in place, IntelligenceX automatically reviews every PR:

  • Inline comments on specific code lines with suggestions
  • Summary review with overall assessment
  • Hybrid mode combines both
  • Auto-resolve cleans up stale bot threads

After merging your onboarding PR, run the First PR Checklist on the next PR.

Configuring the Reviewer

Create .intelligencex/reviewer.json in your repo:

{
  "review": {
    "provider": "openai",
    "model": "gpt-5.3-codex",
    "mode": "hybrid",
    "length": "long",
    "outputStyle": "compact"
  }
}

See Reviewer Configuration for all options.

If you want to decide where each setting should live, see Workflow vs JSON .

Next Steps