GitHub
Sundial syncs all of its AI-managed context — data models, semantic layers, evals — through your own git repository, so you stay in control of versioning, access, and audit. To enable this, install the Sundial AI GitHub App on your organization. Sundial will read and write to the repository you select, and react to merges in real time via GitHub webhooks.
Prerequisites
You'll need org-owner access on the GitHub organization that hosts the repository you want to sync. Only org owners (or organization members with the "Install third-party apps" permission) can install GitHub Apps.
Installing the GitHub App
Sundial has separate GitHub Apps for each deployment. Open the URL for your deployment (the GitHub org owner needs to be signed in):
- AWS: https://github.com/apps/sundial-ai/installations/new
- GCP (US): https://github.com/apps/sundial-ai-gcp/installations/new
- GCP (EU): https://github.com/apps/sundial-ai-gcp-eu/installations/new
- On-prem: contact Sundial.
On the install screen:
- Select your GitHub organization.
- Under Repository access, choose Only select repositories and pick the dbt repo you want to connect.
- Click Install.
Permissions
The Sundial AI App requests the following permissions on the repositories you select during install:
| Permission | Access |
|---|---|
| Contents | Read & write |
| Pull requests | Read & write |
| Issues | Read & write |
| Webhooks | Read only |
The App is installed at the organization level but scoped only to the repositories you select. You can change the repository scope or uninstall the App at any time from your GitHub organization's installed Apps settings.
The Issues permission backs the GitHub context connector, which lets Sundial's agents read repository issues (alongside repos and pull requests) as context during an analysis.
Share the installation ID with Sundial
If the Sundial contractor account is a member of your GitHub org, you can skip this section.
Otherwise (e.g., the contractor has outside-collaborator access to the repo only), the org owner sends the installation ID to Sundial:
- Go to
https://github.com/organizations/<your_org>/settings/installations - Find your Sundial App in the installed Apps list (Sundial AI for AWS, Sundial AI GCP for GCP (US), Sundial AI GCP EU for GCP (EU)) and click Configure
- The installation ID is the trailing number in the URL:
https://github.com/organizations/<your_org>/settings/installations/<installation_id> - Send the number to your Sundial contact.
What this enables
Once the app is installed, Sundial can:
- Sync data model definitions, semantic models, and evals to and from your repository
- Trigger updates to the application layer automatically on merge via webhooks
- Keep all context versioned and auditable under your organization's git history