> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connected knowledge repositories

> Connect a Git repository of documents, such as a handbook, runbooks or architecture notes, so CodeRabbit uses it as reference knowledge in your organization's reviews and scans.

All Platforms (Connected knowledge repositories are available on GitHub, GitLab, Azure DevOps and Bitbucket Cloud.) | Team Plan (Connected knowledge repositories are available on the Team, Advanced and Enterprise plans as a private preview.) Cloud Only (This feature is available on CodeRabbit Cloud only. It is not available on self-hosted CodeRabbit deployments.) Admin Only (Only an organization admin can connect, refresh or disconnect a knowledge repository.)

A connected knowledge repository is a Git repository of documents, such as a handbook, runbooks or architecture notes. CodeRabbit uses it as reference knowledge in your organization's reviews and scans.

## Requirements and limits

Connected knowledge repositories are available on CodeRabbit Cloud for GitHub, GitLab, Azure DevOps and Bitbucket Cloud.

> [!NOTE]
>
> Connected knowledge repositories are available as part of a private preview on the Team, Advanced and Enterprise plans. Contact CodeRabbit support to enable them for your organization.

| Plan | Connected repositories |
| - | - |
| Enterprise | Up to 10 |
| Advanced | 1 |
| Team | 1 |
| Other plans | Not available |

* CodeRabbit always uses the default branch (for example, `main` or `master`) as the content source.
* Only an organization admin can connect, refresh or disconnect a repository.
* The repository must already be installed for CodeRabbit in the same organization.

## Connect a repository

1. In the CodeRabbit app, open **General → Knowledge repositories** in the sidebar.
2. Under **Repository to connect**, search for the repository and select it.
   * A public knowledge repository is used for every repository in your organization.
   * A private or internal knowledge repository is used only for other private and internal repositories.
3. Click **Connect**. CodeRabbit confirms with **Repository connected** and starts the first sync.
4. The repository appears in the list with links to **Re-index**, **Disconnect** and its summary page.
5. The repository is usually available in reviews and scans within a few minutes.

If the repository is missing from the search, install CodeRabbit on it first. If **Connect** is unavailable, your plan's limit is reached or your role is not organization admin.

## Feature support

* **Pull request reviews:** check changes against your documented conventions and guidelines.
* **Chat replies on pull requests and issues:** answer questions with your docs as context.
* **Deep Scan and pull request security scans:** give security agents your architecture and threat notes.
* **Coding Agent (coming soon):** give cloud coding tasks your docs while they work.
* **QA Agent (coming soon):** inform test planning and testing.

## Manage a connected repository

You can manage connected repositories from **Knowledge repositories** in settings:

* **Update the knowledge:** push to the default branch. CodeRabbit refreshes it automatically.
* **Force a refresh:** click **Re-index** on the repository's row.
* **View the summary page:** click the repository on **Knowledge repositories**, or open **Knowledge base** in the sidebar.
* **Stop using a repository:** click **Disconnect**. CodeRabbit removes its summary page and stops using it.
* **Stop a single repository from using connected knowledge:** turn on the [knowledge base opt-out](https://docs.coderabbit.ai/reference/configuration.md#param-knowledge-base-opt-out) for that repository, in its settings or in `.coderabbit.yaml`. Later reviews, scans and agent runs for that repository ignore connected repositories.

## What's next

> **[Knowledge Base overview](https://docs.coderabbit.ai/knowledge-base.md)**
>
> Return to the Knowledge Base overview for all adaptive review features

> **[Multi-repo analysis](https://docs.coderabbit.ai/knowledge-base/multi-repo-analysis.md)**
>
> Link related repositories so reviews check cross-repository impact

> **[Configuration reference](https://docs.coderabbit.ai/reference/configuration.md)**
>
> Review every `.coderabbit.yaml` option, including the knowledge base opt-out


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.