​

GitHub

The GitHub integration lets Qodex understand your repository and participate in pull request review. After you install the Qodex GitHub App and link a repo to a project, Qodex can inspect code, run PR review workflows, post inline findings, and publish Check Runs. Syncing generated tests back to your repository is planned and not available today.

​

What Qodex can do with GitHub

Qodex cannot push arbitrary commits, change repo settings, or merge pull requests.

​

How setup works

​

1. Install the GitHub App

Install the Qodex GitHub App on the account or organization that owns your repo. Choose the repositories Qodex is allowed to access. Qodex uses short-lived GitHub App installation tokens, not a personal access token.

​

2. Link a repo to your Qodex project

In Qodex, open Settings > Connections > GitHub and choose a repo from the picker. The project can link up to 10 repos. Repos larger than 500 MB are rejected at link time.

​

3. Let Qodex analyze the repo

After linking, Qodex starts a background analysis job. It reads the repo, discovers routes and project structure, and seeds project memory so later agent work has useful context. You can manually refresh a linked repo later. Refreshes are rate-limited to avoid repeatedly cloning the same repo.

​

Unlink a repository

Open Settings > Connections > GitHub, find the linked repository or folder, click Unlink, and confirm Unlink. This removes the repository’s association with the current Qodex project and drops Qodex’s cached clone. It does not delete the GitHub repository or uninstall the GitHub App. To remove the project’s grant to an entire GitHub App install instead, see Disconnect a GitHub account.

​

Pull request review

When PR review is enabled, Qodex reacts to PR activity through GitHub webhooks. For each tracked PR, Qodex can:

• Read the PR diff and relevant surrounding code.
• Post a walkthrough comment.
• Add inline findings where the issue appears.
• Run verification probes when needed.
• Publish a Check Run that can be used for merge gating.

To make a repo review-on-request, turn off Automatic reviews in its review settings. @qodex-ai review and the Run review button still start a review. Track reviewed PRs, findings, and plan usage under Code > PR review in your project.

​

Permissions

The GitHub App requests the permissions needed for review: Qodex does not write tests or any other files to your repository.

​

Next steps