Skip to main content
Buster uses a GitHub App to enable agents to read your code, create pull requests, and provide automated feedback.
GitHub integration is required for agents to access your repositories. You must have organization ownership or administrator permissions to install the app.

​
Installing the GitHub App

Install the Buster GitHub App through from the Buster web app. The GitHub integration is found within the “Integrations” tab.
We recommend granting access only to repositories where you plan to deploy agents.
Buster GitHub App installation page

​
Permissions

When you install the GitHub app, you will be prompted to grant the following permissions: Read permissions:
  • metadata: Basic repository information
Read and write permissions:
  • contents: Read files and commit changes
  • pull_requests: Create and comment on pull requests
  • issues: Create and manage issues
The app only accesses repositories that you explicitly grant it access to. If you have branch protection rules enabled, the app can’t push directly to protected branches.

​
Managing repository access

When installing the Buster GitHub App, you can grant access to all of your repositories or specific ones. You can modify this selection anytime in your GitHub app settings.

​
Configuring repository source

After installing the GitHub App, configure which repositories your agents can access in the “Integrations” tab of the web app.

​
Troubleshooting

​
GitHub app connection issues

If you encounter problems with the GitHub app, resetting the connection can solve most problems.
1

Uninstall the Buster app through GitHub

  1. In GitHub, go to installations and select Configure next to the Buster app. Scroll down and select Uninstall.
  2. Go to Authorized GitHub Apps and select Revoke next to the Buster app.
2

Reinstall the Buster app

  1. In your Buster account, go to “Integrations” and install the GitHub app.
  2. Verify the connection appears as “Connected”.

​
Agent not triggering on pull requests

If your agent isn’t running when PRs are created:
1

Verify GitHub App installation

Check that the Buster app is installed on the repository in your GitHub installations.
2

Check webhook deliveries

In GitHub, go to Settings → Webhooks → Buster and verify recent webhook deliveries are successful. If you see failed deliveries, redeliver them manually to test.
3

Review agent configuration

Ensure your agent file is located in .github/buster/agents/ and has a valid pull request trigger configured.

​
Permission denied errors

If agents can’t create pull requests or comments, you may need to expand permissions.
1

Navigate to GitHub App settings

Go to GitHub Settings → Applications → Installed GitHub Apps → Buster and click Configure.
2

Update permissions

Ensure the following permissions are granted:
  • Contents: Read and write
  • Pull requests: Read and write
  • Issues: Read and write