SOP-017: GitHub Integration

Document Control

• Version: 1.0
• Last Updated: 2024
• Category: Integrations

---

Purpose

Connect Cursor with GitHub to enable Cloud Agents and Bugbot to clone repositories, create branches, and push changes.

---

Scope

This SOP covers:

• Installing the Cursor GitHub app
• Configuring repository access
• Using agents from GitHub PRs and issues
• IP allowlist configuration for enterprise

---

Prerequisites

• GitHub account with repository access
• Cursor account (Team or Enterprise for full features)
• Admin access to GitHub organization (for org-wide setup)

---

Procedure

Step 1: Connect GitHub Account

1. Go to Cursor Dashboard
2. Click Connect next to GitHub
3. Choose access level:
   • All repositories - Full access to all repos
   • Selected repositories - Choose specific repos

Step 2: Authorize Permissions

The GitHub app requires these permissions:

Permission	Purpose
Repository access	Clone code and create branches
Pull requests	Create PRs with agent changes
Issues	Track bugs agents discover or fix
Checks and statuses	Report code quality and test results
Actions and workflows	Monitor CI/CD pipelines

Step 3: Use Agent from GitHub

Trigger Cloud Agents directly from GitHub:

On Pull Requests:

@cursor [your prompt here]

With Bugbot fixes:

@cursor fix

This reads Bugbot's suggestions and implements the fix.

On Issues:

@cursor implement this feature

Step 4: Configure IP Allowlist (Enterprise)

If your organization uses GitHub's IP allowlist:

Option 1: Enable for GitHub Apps (Recommended)

1. Go to organization Security settings
2. Navigate to IP allow list
3. Check "Allow access by GitHub Apps"

Cursor's app has pre-configured IPs that auto-update.

Option 2: Add IPs Manually

Add these IPs to your allowlist:

184.73.225.134
3.209.66.12
52.44.113.131

Contact hi@cursor.com before configuring.

---

Disconnecting

To remove GitHub integration:

1. Go to Cursor Dashboard
2. Click Disconnect Account next to GitHub

---

Verification Checklist

• [ ] GitHub app installed
• [ ] Repository access configured
• [ ] Cloud Agents can clone repos
• [ ] @cursor mentions work in PRs
• [ ] IP allowlist configured (if applicable)

---

Troubleshooting

Issue	Solution
Agent can't access repository	Verify app has access to that repo
Permission denied for PRs	Check PR write permissions
App not visible in GitHub	Reinstall from Cursor dashboard
IP blocked	Configure allowlist per Step 4

---

See Also

• SOP-020: Bugbot
• SOP-021: Cloud Agents
• SOP-014: Git Integration