CLI Quickstart

If dotnet run complains about multiple frameworks, add -f net8.0.

Single repository (wizard)

intelligencex setup wizard

Review a PR (local)

The reviewer reads inputs from environment variables (or GITHUB_EVENT_PATH).

$env:INPUT_REPO = "owner/name"
$env:INPUT_PR_NUMBER = "123"
intelligencex reviewer run

Web UI (preview)

intelligencex setup web

Single repository (non-interactive)

intelligencex setup --repo owner/name --with-config

Single repository (non-interactive, multi-account routing)

intelligencex setup --repo owner/name --with-config `
  --openai-account-id acc-primary `
  --openai-account-ids acc-primary,acc-backup,acc-team `
  --openai-account-rotation round-robin `
  --openai-account-failover true

Update only the auth secret

intelligencex setup --repo owner/name --update-secret

dotnet run --project IntelligenceX.Cli/IntelligenceX.Cli.csproj -c Release -- auth login --set-github-secret

The command auto-detects repo/org + token if available (see CLI Overview for details).

Usage snapshot (limits + credits)

intelligencex usage --events

Usage snapshot (JSON)

intelligencex usage --json --no-cache

Usage snapshot by surface (codex vs spark)

intelligencex usage --events --by-surface

Manual GitHub workflow run with account override

gh workflow run review-intelligencex.yml `
  -f repo=owner/name `
  -f pr_number=123 `
  -f openai_account_ids=acc-primary,acc-backup `
  -f openai_account_rotation=round-robin `
  -f openai_account_failover=true `
  -f usage_budget_guard=true `
  -f usage_budget_allow_credits=true `
  -f usage_budget_allow_weekly_limit=false

Manual secret flow

intelligencex setup --repo owner/name --manual-secret

intelligencex setup --repo owner/name --manual-secret --manual-secret-stdout

Explicit secrets block (no inherit)

intelligencex setup --repo owner/name --explicit-secrets

Clean up

intelligencex setup --repo owner/name --cleanup --keep-secret

Release notes (CLI)

dotnet run --project IntelligenceX.Cli/IntelligenceX.Cli.csproj -c Release -- release notes --update-changelog

Release notes (workflow)

Use .github/workflows/release-notes.yml (template in IntelligenceX.Cli/Templates/release-notes.yml). Inputs are mapped to environment variables to keep YAML minimal.

Release reviewer (workflow)

Use .github/workflows/release-reviewer.yml. Inputs like release_tag, release_title, release_repo, and rids map to env vars. Token env: INTELLIGENCEX_REVIEWER_TOKEN (fallback: INTELLIGENCEX_RELEASE_TOKEN, GITHUB_TOKEN).

Resolve stale review threads (local)

intelligencex reviewer resolve-threads --repo owner/name --pr 123