> ## 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.

# Repository setup

> Set up a GitHub test repository and integrate CodeRabbit for automated code reviews

<Steps>
  <Step title=">>> Integrate CodeRabbit into a GitHub repository that you own" />

  <Step title="Observe CodeRabbit perform a code review of a pull request that you initiate" />

  <Step title="Converse with CodeRabbit about the code review" />

  <Step title="Prompt CodeRabbit to generate its own improvements to the pull request" />
</Steps>

## Before you begin

Create a new repository on GitHub. Name the new repository `coderabbit-test`, and let it have otherwise default GitHub settings.

## Integrate CodeRabbit with your GitHub account

To integrate CodeRabbit with your GitHub account, follow these steps:

<Steps>
  <Step stepNumber="1" title="Create an account">
    Visit [the CodeRabbit login
    page](https://app.coderabbit.ai/login?free-trial). No credit card required!
  </Step>
</Steps>

CodeRabbit takes a moment to set up the integration. After it finishes, the CodeRabbit dashboard appears.

## Add CodeRabbit to your repository

To add CodeRabbit to your test repository, follow these steps:

<Steps>
  <Step stepNumber="2" title="Access repository settings">
    On the CodeRabbit dashboard, click **Add Repositories**. A GitHub repository-access dialog appears.
  </Step>

  <Step stepNumber="3" title="Grant repository access">
    Select the **Only select repositories** radio button.
  </Step>

  <Step stepNumber="4" title="Select your test repository">
    From the **Select repositories** menu, select the `coderabbit-test` repository that you created earlier in this guide.
  </Step>

  <Step stepNumber="5" title="Install and authorize CodeRabbit">
    Click **Install & Authorize**.

    <Info>
      CodeRabbit requests read and write access to your repository in order for its code review, issue management, and pull request generation features to work. CodeRabbit does not retain your source code after review, except when [review caching](/reference/caching) is enabled to speed up future reviews. For more information, see [the CodeRabbit Trust Center](https://trust.coderabbit.ai).
    </Info>
  </Step>

  <Step stepNumber="6" title="Complete signup if prompted">
    If a CodeRabbit **Complete your signup** dialog appears, then fill it out with the requested information before continuing.
  </Step>
</Steps>

CodeRabbit is now ready to use with your test repository. The next steps demonstrate its core code-review features.