IntelligenceX

Onboarding Wizard

Edit on GitHub

Use the IntelligenceX CLI onboarding wizard to detect the right setup path, connect GitHub, and open a PR with reviewer changes.

Onboarding Wizard (CLI)

The CLI wizard is the fastest way to set up the reviewer across one or more repositories. It runs locally, opens any needed browser approvals, and applies changes via PRs by default. After merging onboarding, run the First PR Checklist on your next PR.

Screenshots

Quick start

intelligencex setup wizard

The wizard now starts with doctor-based auto-detect and path selection before GitHub auth/repo selection. You can still run preflight manually:

intelligencex setup autodetect --json
flowchart TD
  classDef start fill:#38BDF8,stroke:#0369A1,color:#082F49,stroke-width:2px;
  classDef decision fill:#FDE68A,stroke:#B45309,color:#451A03,stroke-width:2px;
  classDef path fill:#A7F3D0,stroke:#047857,color:#052E2B,stroke-width:2px;
  classDef converge fill:#C7D2FE,stroke:#4338CA,color:#1E1B4B,stroke-width:2px;
  classDef finish fill:#E9D5FF,stroke:#7C3AED,color:#2E1065,stroke-width:2px;

  A["Run wizard"] --> B["Doctor auto-detect"]
  B --> C{"Choose path"}
  C --> D["new-setup"]
  C --> E["refresh-auth"]
  C --> F["cleanup"]
  C --> G["maintenance"]
  D --> H["GitHub auth and repos"]
  E --> H
  F --> H
  G --> H
  H --> I["Path-specific configure and auth requirements"]
  I --> J["Plan apply verify"]

  class A,B start;
  class C decision;
  class D,E,F,G path;
  class H converge;
  class I,J finish;

Path requirements and Bot parity flow are documented in Web Onboarding Flow .

Web UI (preview)

intelligencex setup web

See Web Setup UI for limitations and security notes.

What the wizard does

  • Authenticates GitHub (device flow, PAT, or GitHub App)
  • Lets you pick single or multiple repos
  • Builds reviewer config via presets or custom JSON
  • Preset flow exposes static-analysis controls (gate, runner strict mode, packs, export path)
  • Can load existing config from a repo and preview the workflow
  • Summary includes workflow status (managed/unmanaged) from the first selected repo
  • Logs into ChatGPT (native transport) if secrets are needed
  • Creates PRs with workflow/config updates

Operations

  • Setup / update workflow + config (default)
  • Update OpenAI secret only
  • Cleanup (remove workflow/config)
  • Maintenance (inspect first, then pick setup/update-secret/cleanup)

Path-first non-interactive examples:

intelligencex setup wizard --path new-setup --repo owner/name
intelligencex setup wizard --path refresh-auth --repo owner/name
intelligencex setup wizard --path cleanup --repo owner/name --dry-run

If auto-detect preflight fails and you need richer diagnostics:

intelligencex setup wizard --verbose

GitHub auth modes

1) GitHub App (installation token)

    • Recommended for org-wide onboarding
    • You can create an App via the manifest flow
    • The wizard can save the App profile for reuse

2) OAuth device flow

    • Fastest for a single repo

3) Personal access token

    • Use only if required by your org policy

Config options

  • Workflow only (no config)
  • Presets (balanced, picky, security, performance, tests, minimal)
  • Load existing config from a repo
  • Custom JSON (editor, path, or paste)

For config ownership and precedence details, see Workflow vs JSON .

Example: org-wide GitHub App flow

1) Click "Create App (manifest)" in the wizard
2) Install the app in the org
3) Click "List installations"
4) Pick the org installation
5) Click "Use installation token"

Example: one-repo device flow

1) Run: intelligencex setup wizard
2) Pick "Device flow"
3) Authenticate and select a single repo
4) Plan + Apply (creates PR)

Manual secret mode

If you do not want the CLI to upload secrets automatically:

intelligencex setup wizard --manual-secret

The wizard writes the secret value to a local temporary file and prints instructions for manual paste. For direct terminal output, add --manual-secret-stdout (requires --manual-secret and is less safe).

Explicit secrets block

Explicit secrets mapping is enabled by default. If needed, you can force it explicitly:

intelligencex setup wizard --explicit-secrets

Troubleshooting

  • If no installations are found for a GitHub App, install it first:

https://github.com/apps/ <app-id>/installations

  • If the wizard cannot list repos, verify the token scope and access.