VuonDocs

GitHub Integration

Connect GitHub to give Vuon agents repository-aware context, improve source references on datasets, and ensure data is grounded in the actual code context.

By default, it’s best to connect all repositories that define your data logic — dbt models, SQL transformations, warehouse schema code, etc. Leave scans enabled so they refresh automatically when columns are added or changed.

Get started

Connect your GitHub account

  1. Open the Vuon Admin panel.
  2. Go to Integrations → GitHub.
  3. Click Connect GitHub account and complete OAuth.

Install the GitHub App

Vuon uses the Vuon Data GitHub App.

  1. In the GitHub prompt, install Vuon Data on the organization you want to connect.
  2. Choose All repositories or Only select repositories.
  3. Finish the installation to return to Vuon.

You can manage the installation directly in GitHub (requires a GitHub admin role): https://github.com/settings/apps/authorizations

Select repositories

  1. Back in Vuon, select the organization you want to connect.
  2. Choose repositories to scan and configure settings as needed.

Permissions

The Vuon Data app requests read access to:

  • Code
  • Members
  • Metadata

Troubleshooting

No organizations show up

If no organizations show up, re-run OAuth and verify you belong to the org. Make sure you have admin permissions for the organization you're trying to connect.

Repositories are missing

If repositories are missing, update the GitHub App installation settings. Go to the GitHub App installation URL and adjust which repositories the app can access.

FAQ

Can I connect multiple GitHub organizations?

Yes, you can connect multiple GitHub organizations. Repeat the setup process for each organization you want to connect.

What does Vuon do with my repository data?

Vuon scans repositories to index code and documentation. This helps the AI agent provide better context when answering questions or making code changes. Your code is never shared outside your organization.

Can I limit which repositories Vuon can access?

Yes, during the GitHub App installation, you can choose to grant access to all repositories or only select specific repositories.

Was this page helpful?