> ## Documentation Index
> Fetch the complete documentation index at: https://qodex.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PR review

> Qodex reviews linked GitHub pull requests with summaries, inline findings, preview checks, and merge-gating status.

# PR review

Qodex reviews pull requests on linked GitHub repos.

When a PR opens or changes, Qodex reads the diff, looks for real bugs and security issues, posts a walkthrough comment, adds inline findings where it can, checks the preview deployment when available, and updates a GitHub Check Run.

## What Qodex adds to a PR

<CardGroup cols={2}>
  <Card title="Walkthrough comment" icon="message-square" href="/pr-review-walkthrough-anatomy">
    A top-level review summary that explains what changed, what Qodex checked, and whether findings were raised.
  </Card>

  <Card title="Inline findings" icon="message-square-text" href="/pr-review-inline-findings">
    Comments attached to specific changed lines, with severity, category, confidence, and suggested fixes when safe.
  </Card>

  <Card title="Preview checks" icon="zap" href="/pr-review-verification-probes">
    Safe GET requests against a PR preview deployment to confirm whether a finding is reproducible.
  </Card>

  <Card title="Check Run" icon="shield-check" href="/pr-review-check-run">
    A GitHub status check that is advisory by default and can be configured to block merges on verified findings.
  </Card>
</CardGroup>

## Review flow

A `pull_request` webhook, or an `@qodex review` comment, starts the review.

Qodex fetches the PR diff through the GitHub App, reads `.qodex.yaml`, loads project context, and reviews the diff with a high-precision confidence floor. Findings below `0.7` confidence are dropped before they reach the PR. Repo rules such as severity thresholds and excluded paths are applied next.

Findings on changed lines become inline comments. Findings outside the diff move into the walkthrough body so they are still visible. If the PR has a successful preview deployment, Qodex can run safe verification probes and attach request and response evidence.

At the end, Qodex posts the GitHub review, records the findings, and completes the Check Run as `neutral`, `success`, or `failure` depending on the repo's gate policy.

## Deeper review on larger PRs

For larger or riskier pull requests, Qodex can spend extra review attention where it is most useful: real bugs, missing tests, risky behavior changes, and security issues.

The goal is still the same: fewer low-value comments, more findings that explain a real risk. Repo settings and `.qodex.yaml` decide which paths, severities, and confidence levels should reach the PR.

## Where to go next

<CardGroup cols={2}>
  <Card title="How a review fires" icon="webhook" href="/pr-review-how-it-fires">
    Follow the sequence from GitHub event to posted review.
  </Card>

  <Card title="Install the GitHub App" icon="git-branch" href="/pr-review-install-github-app">
    Set up access so Qodex can see repos and review PRs.
  </Card>

  <Card title="Limits and caveats" icon="ruler" href="/pr-review-limits-caveats">
    Understand diff caps, confidence filters, skipped PRs, and probe limits.
  </Card>

  <Card title="Troubleshooting" icon="life-buoy" href="/pr-review-troubleshooting">
    Fix skipped reviews, neutral checks, uncertain anchors, and opt-outs.
  </Card>
</CardGroup>

## When to use it

* Use PR review when you want one reviewer per repo that focuses on real bugs, security issues, and risky behavior changes.
* Use it when you ship several PRs a day and want review status next to CI.
* Use it when linting already catches style problems and you want a reviewer that can also test a preview deployment.

## When not to use it

* Do not expect Qodex to be a nitpicker. It defaults to `severity_threshold: minor` and drops findings below `confidence: 0.7`.
* Docs-only, generated-file, or no-op diffs may produce a clean review or be skipped by repo policy.

## Related

<CardGroup cols={2}>
  <Card title="Install the GitHub App" icon="git-branch" href="/pr-review-install-github-app" />

  <Card title="Connect a repo" icon="link" href="/pr-review-connect-repo" />

  <Card title=".qodex.yaml reference" icon="file-code" href="/qodex-yaml-reference" />

  <Card title="Troubleshooting" icon="life-buoy" href="/pr-review-troubleshooting" />
</CardGroup>