GitHub Integration
AgentDesk connects to GitHub to enable AI workflows to create pull requests in your repositories. When the AI proposes a code change, it opens a pull request for your team to review.
What GitHub integration does
- Creates pull requests from AI workflow code changes
- Links pull requests back to the originating support ticket
- Provides your team with clear descriptions of proposed changes
All pull requests require human review before merging. The AI never auto-merges.
Setting up GitHub
Installing the GitHub App
- Go to Admin > Portals > [your portal] > Integrations > GitHub.
- Click Install GitHub App.
- You will be taken to GitHub to authorise the installation.
- Select which repositories to grant access to (selecting specific repositories is recommended over granting access to all).
- Click Install.
Connecting repositories to a portal
After installation:
- Go to Admin > Portals > [your portal] > Repositories.
- Click Add Repository.
- Select from the list of repositories available through the GitHub App.
- Set the default branch for pull request targets.
How pull requests work
When an AI workflow generates code changes:
- A new branch is created from the default branch.
- The changes are committed to the new branch.
- A pull request is opened with a description of the changes, a link to the original ticket, and a test plan.
- Your team reviews and merges (or closes) the pull request.
Troubleshooting
GitHub App not installed
- Check that the app installation is still active on GitHub (Settings > Applications)
- Try reinstalling the app from the portal integrations page
Pull request creation fails
- Ensure the GitHub App has write access to the target repository
- Check that the default branch exists in the repository
- Verify the repository is connected to the portal