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

# Connect a Git Repository

> Give Revolte secure access to the codebase context it needs to plan, implement, and deliver changes.

Connect a repository before asking Revolte to change existing code. The selected repository gives the agent the project structure, dependencies, and established implementation patterns needed for grounded work.

<Steps>
  <Step title="Open the Repository Connection">
    During application setup, select the repository connection action. You can also connect a repository when a new chat needs codebase access.
  </Step>

  <Step title="Choose GitHub">
    Select **GitHub**, then select **Proceed**.

    <div style={{ maxWidth: "520px", margin: "0 auto" }}>
      <Frame>
        <img src="https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/agent/ai-chat/ai-chat-connect-github.png?fit=max&auto=format&n=rsn4aNVKS_FvNRWy&q=85&s=165ab6d6981c63736669a3fbf8f23eaa" alt="The Connect your repository dialog with GitHub available for selection." width="924" height="732" data-path="image-v2/agent/ai-chat/ai-chat-connect-github.png" />
      </Frame>
    </div>
  </Step>

  <Step title="Authorize Repository Access">
    Complete the GitHub authorization flow and grant access only to the repositories Revolte should use.
  </Step>

  <Step title="Select the Repository">
    Associate the repository with your Revolte application. When you start a task, Revolte can read the connected codebase, follow its existing patterns, and prepare changes against the selected branch.
  </Step>
</Steps>

Repository access also allows completed work to move into your normal Git workflow as a reviewable commit or pull request.

For provider-specific setup, see [GitHub Integration](/connect/github).