Github

Connect GitHub repositories to Bluebricks for GitOps environments, plan check runs, and agent-powered infrastructure changes

The GitHub integration connects Bluebricks to your GitHub repositories. This is the same connection that powers both the orchestration platform and the agent:

• Orchestration: use version-controlled IaC source code as the foundation for blueprints, enable GitOps environments, and get plan check runs on pull requests

• Agent: the agent reads your infrastructure code to answer questions and opens pull requests when you ask it to make changes

If you connected GitHub during onboarding or through Connect your Code, you're already set up. The steps below are for teams configuring the integration for the first time.

How to enable the GitHub integration

1. Go to Account Settings > Integrations (app.bluebricks.co/settings?tab=integrations)

2. Click the GitHub integration button

3. Click Enable and authorize the Bluebricks GitHub App

4. Select the organization you want to connect

5. Choose which repositories Bluebricks can access

6. Click Save

To add or remove repositories later, go to Account Settings > Integrations and click Configure next to the GitHub integration.

Plan check runs on pull requests

GitOps environments post infrastructure plan results directly to your pull requests as GitHub check runs. Each check run summarizes planned adds, changes, and deletions, and links to the full plan in Bluebricks. Large plans are truncated with a link to the complete output.

For details on check run statuses and setup, see Plan results on pull requests.