Linking Repositories
After connecting the GitHub App, link individual projects to their GitHub repositories.
Linking a project
Go to Project → Settings → GitHub tab.
Codality offers two ways to link:
Auto-detect from git remote
If the project's local git repository has a GitHub remote, Codality detects the owner and repository name automatically. Click Link to confirm.
Manual selection
If auto-detect doesn't work, select the repository from a dropdown of all repositories the GitHub App has access to. This list comes from the app's installation.
What linking enables
Once a project is linked to a GitHub repository:
| Feature | Description |
|---|---|
| Push branches | Agent pushes branches to GitHub |
| PR creation | Agent creates pull requests on task completion (when protected main is enabled) |
| Check runs | codality/agent and codality/review check runs appear on PRs |
| CI feedback | Agent responds to CI failures automatically |
| Review handling | Agent responds to PR review feedback |
| PR comments | Agent responds to non-command comments on PRs |
| Webhook events | PR merged/closed events update ticket status |
Unlinking
Click Unlink in the project's GitHub settings to remove the association. The local repository is not affected. Existing PRs remain on GitHub but are no longer tracked by Codality.
Repository access
The GitHub App must have access to the repository. If you installed the app with "select repositories" and later add a new repo, update the installation on GitHub to include it.
Manage installation access at: https://github.com/settings/installations (find your Codality app).