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
- Open Admin → Integrations → GitHub and start the connection.
- On GitHub, check the account/organization and review the requested read-only contents and metadata access.
- Select the repositories the app may access and complete authorization.
- 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.