GitHub
Official Cursor GitHub app for background agents
Background Agents and Bugbot require the Cursor GitHub app to clone repositories and push changes.
All permissions follow the principle of least privilege needed for background agent functionality.
Installation
- Go to Integrations in Dashboard
- Click Connect next to GitHub
- Choose repository either All repositories or Selected repositories
Permissions
The GitHub app requires specific permissions to work with background agents:| Permission | Purpose |
|---|---|
| Repository access | Clone your code and create working branches |
| Pull requests | Create PRs with agent changes for your review |
| Issues | Track bugs and tasks that agents discover or fix |
| Checks and statuses | Report on code quality and test results |
| Actions and workflows | Monitor CI/CD pipelines and deployment status |
Troubleshooting
Agent can't access repository
Agent can't access repository
- Install the GitHub app with repository access
- Check repository permissions for private repos
- Verify your GitHub account permissions
Permission denied for pull requests
Permission denied for pull requests
- Grant the app write access to pull requests
- Check branch protection rules
- Reinstall if the app installation expired
App not visible in GitHub settings
App not visible in GitHub settings
- Check if installed at organization level
- Reinstall from github.com/apps/cursor
- Contact support if installation is corrupted