Reviewer Overview
The reviewer runs in GitHub Actions (and Azure DevOps summary-only) and posts a structured review comment on PRs. Azure DevOps summary-only uses the PR-level changes endpoint (cumulative diff). It can use:
- ChatGPT (native transport) with a ChatGPT login bundle.
- Copilot (via Copilot CLI) for teams already using GitHub Copilot.
- Copilot direct HTTP transport (experimental) for custom gateways.
Recommended onboarding
- - CLI wizard
intelligencex setup wizard- - Local web UI (preview)
intelligencex setup web
Related docs:
Trust model (short version)
- BYO GitHub App is supported for branded bot identity.
- Secrets are stored in GitHub Actions (you control access).
- Web UI binds to localhost only; tokens never leave your machine.
Engine Scope
- - Review pipeline
- resolve inputs, build context, assemble prompt, call provider, parse inline comments, post summary/inline output.
- - Providers and transports
- OpenAI (native/appserver) and Copilot (CLI/direct).
- - Context builder
- diff-range selection, file filtering, chunking, redaction, language hints, related PRs.
- - Formatter/output
- summary templates, inline comment formatting, structured findings block.
- - Thread triage/auto-resolve
- load threads, require evidence, summarize/append optional replies.
Success Metrics
- Review latency (p50/p95) from job start to posted comment.
- Failure rate for review runs (auth, preflight, provider errors).
- Reviewer usefulness score (maintainer feedback or “kept” findings rate).
- Inline quality (false-positive rate based on fixes/confirmations).
Default Mode + Model Policy
- - Default review mode
hybrid(summary + inline when supported; falls back to summary-only).- - Default provider/model
- OpenAI with
gpt-5.3-codexunless configured otherwise; Copilot is opt-in. - - Safe defaults
- skip drafts; skip workflow changes unless allowed; no secrets/writes on untrusted PRs; fail-open only for transient errors; budget summary enabled; auto-resolve limited to bot threads with evidence; secrets audit on.
Reusable workflow (quick start)
jobs:
review:
uses: evotecit/github-actions/.github/workflows/review-intelligencex.yml@master
with:
reviewer_source: release
openai_transport: native
output_style: claude
style: colorful
secrets: inheritInputs → environment mapping (short)
The reusable workflow maps with: inputs to environment variables the reviewer reads.
| Workflow input | Environment variable |
|---|---|
repo | INPUT_REPO |
pr_number | INPUT_PR_NUMBER |
reviewer_token | INTELLIGENCEX_GITHUB_TOKEN |
reviewer_source | REVIEWER_SOURCE |
reviewer_release_repo | REVIEWER_RELEASE_REPO |
reviewer_release_tag | REVIEWER_RELEASE_TAG |
reviewer_release_asset | REVIEWER_RELEASE_ASSET |
reviewer_release_url | REVIEWER_RELEASE_URL |
Minimal config (native ChatGPT)
{
"review": {
"provider": "openai",
"openaiTransport": "native",
"model": "gpt-5.3-codex",
"mode": "inline",
"length": "long",
"reviewUsageSummary": true
}
}Quick flow (end-to-end)
# 1) Auth login (stores tokens locally)
intelligencex auth login
# 2) Setup reviewer (creates PR)
intelligencex setup wizardWhat to configure next
- Model/provider + output style
- Review length and strictness
- Auto-resolve/triage behavior for bot threads
- Triage-only mode (skip full review, only triage threads)
- Usage summary line (optional)
Usage and credits line
Enable reviewUsageSummary to append limits/credits (ChatGPT native only). See Configuration . When a code-review rate-limit window is present, its label is explicitly prefixed with code review (for example, code review weekly limit ) so it is distinct from general limits.