---
id: integrations.github
title: Connect GitHub Repositories
summary: Install the GitHub App, select repository access and bind the intended repository/ref as Project Reference Materials.
kind: quickstart
product_area: data_integrations
status: stable
updated: 2026-10-31
canonical: /docs/integrations/github
---

# Connect GitHub Repositories

## Prerequisites

Use a GitHub.com account with permission to install the Teammately GitHub App for the intended account or organization. Your organization may require approval. Choose the repositories the Project actually needs.

## Connect and discover

1. Open **Admin → Integrations → GitHub** and start the connection.
2. On GitHub, check the account/organization and review the requested read-only contents and metadata access.
3. Select the repositories the app may access and complete authorization.
4. Back in Teammately, review discovered repositories. Use **Sync repositories** after changing repository access.

## Bind the Project

Open the Project's **Reference Materials**, add a Git repository connection and select the repository and ref. Inspect indexing state and resulting content before relying on it as Project context.

Workspace authorization discovers accessible repositories; it does not automatically bind all of them to Projects. Indexed Reference Materials and the Project Agent Brief are separate objects.

## Verify and recover

Confirm the expected repository appears, the selected ref is correct, and indexing completes for the intended content. For a missing repository, review the installed GitHub App's repository selection and your account access, then sync. For revoked authorization, restore provider access through the normal connection flow.

Review repository access in GitHub when reducing permissions. Keep organization authorization, Project binding and indexed content distinct when investigating access.

## Related reference pages

{% related-card-grid %}
- [Reference Materials](/docs/agent-setup/reference-materials)
- [Workspace Integrations](/docs/admin-console/integrations)
- [Permissions troubleshooting](/docs/troubleshooting/permissions)
{% /related-card-grid %}