GitHub Authentication

Connect your GitHub repositories to AI SRE to enable code analysis and change correlation.

​

Overview

AI SRE uses GitHub OAuth to access your repositories, enabling:

• Code analysis and dependency mapping
• Change correlation with incidents
• Pull request and commit history review
• Deployment timeline analysis

​

Setup during onboarding

GitHub connection is part of the onboarding flow:

1. Onboarding wizard — After signing in, you’ll see the onboarding wizard
2. Company setup — If you’re the first user, you’ll create a company account
3. GitHub connection — The wizard guides you to connect GitHub
4. Authorize GitHub App — You’ll be redirected to GitHub to authorize the AI SRE GitHub App
5. Select organization — Choose the GitHub organization to connect
6. Select repositories — Choose which repositories to connect
7. Complete setup — Return to AI SRE to complete onboarding

​

Permissions

AI SRE only reads from your repositories—it never modifies your code or GitHub settings.

​

Repository selection

Connect repositories that:

• Contain production services you investigate
• Have active development and deployments
• Are relevant to incident response

Best practices:

• Start with 1–2 critical repositories
• Add additional repositories as needed
• Regularly review connected repositories
• Only connect repositories needed for incident investigation

​

Troubleshooting

​

”Insufficient Permissions” error

You don’t have sufficient permissions to install the GitHub App. Solution: Contact your GitHub organization admin to install the app, or install at the repository level if you’re a repository admin.

​

”Repository Not Found” error

The selected repository isn’t accessible. Solution: Verify you have access to the repository and check repository visibility settings.

​

”Authentication Failed” error

The OAuth flow failed or was cancelled. Solution: Try the authentication process again. Clear your browser cache if issues persist.

​

Managing connections

​

View connected repositories

Go to Connectors → GitHub to view connected repositories and connection status.

​

Update repository selection

1. Go to GitHub App settings
2. Modify repository access
3. Changes sync to AI SRE automatically

​

Disconnect GitHub

1. Go to Connectors → GitHub
2. Click Disconnect
3. Confirm disconnection

Note: Disconnecting removes access to repository data. Reconnect to use GitHub features.

​

Next steps