IntelligenceX

Onboarding Wizard (CLI)

Edit on GitHub

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.

Quick start

intelligencex setup wizard

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
  • 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)

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)

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 will print the secret value and instructions for manual paste.

Explicit secrets block

If you want to avoid `secrets
inherit ` in the workflow, enable explicit secrets:
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.