GitHub connector
Why GitHub is the foundational source connector for ctx| and where to manage repositories.
GitHub is the first source connector most teams set up. It gives ctx| access to the repositories your organization chooses, and those repositories become the base for code search, file reads, knowledge graph ingestion, and agent context.
GitHub also supports other connectors. When a source like Confluence or Linear needs to become visible and reviewable, ctx| syncs selected content into a GitHub repository first, then ingests it through the same Git-backed pipeline. For Linear, the configuration pull request branch is the draft scope and the target branch becomes the live scope after merge.
You can connect GitHub during onboarding, or later from the Connectors page.
Setup flow
Start the GitHub connection
Start from onboarding if you are setting up ctx| for the first time. If your organization already exists, open Connectors and choose GitHub.
Authorize GitHub access
GitHub asks you to install or authorize the ctx| GitHub App for a GitHub account or organization. You may need a GitHub organization owner to approve the installation if you do not have permission to install apps yourself.
Choose repositories
Select the repositories ctx| should be allowed to read. You can choose a narrow set first and expand access later if more repositories should become searchable or available as connector targets.
Ingest and manage access
ctx| ingests selected repositories so they can power search, Chat, MCP, and the knowledge graph. You can manage repositories later, re-run ingestion, or remove repository context when it should no longer be used.
What GitHub enables
- Single-repo and cross-repo code search.
- Repository ingestion into your organization's knowledge system.
- Repo-native docs, ADRs,
AGENTS.md, skills, and standards as agent context. - Target repositories for synced sources such as Confluence and Linear.
- Pull requests for ctx| configuration, including MCP setup where supported.
Where to manage repositories
Use the Git repositories section for setup and operations:
How repositories feed ctx| search, Chat, MCP, and the knowledge graph.
Add repositoryAdd Git repositories through GitHub selection or a manual clone URL.
Manage repositoriesReview indexed repositories, GitHub App selections, and repository actions.
Unindex / reindexRemove repository context from ctx| or start ingestion again.
Install MCPs via PROpen pull requests that add ctx| MCP configuration to selected repositories.
Related pages
- Ingestion explains what happens after ctx| receives repo-backed source material.
- Confluence connector shows how another source can sync selected content into a GitHub repository before ingestion.
- Linear connector covers the
reviewable
linear/config.yamlscope and Git-backed Linear mirror.