# Github

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

{% hint style="info" %}
If you connected GitHub during onboarding or through [Connect your Code](https://bluebricks.co/docs/getting-started/connect-your-code), you're already set up. The steps below are for teams configuring the integration for the first time.
{% endhint %}

## How to enable the GitHub integration

1. Go to **Account Settings** > **Integrations** ([app.bluebricks.co/settings?tab=integrations](https://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](https://bluebricks.co/docs/orchestration/environments/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](https://bluebricks.co/docs/orchestration/environments/gitops-environments#plan-results-on-pull-requests).