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

# GitHub on Overcut Cloud

> Connect GitHub to Overcut's managed service by installing the Overcut GitHub App.

Use this path when you use **Overcut's managed service** (Overcut Cloud). You
install the managed **Overcut GitHub App** from within your workspace; there are
no credentials to manage, no app to create, and no webhook to register.

<Note>
  Not your setup? See [Which setup do I need?](/docs/integrations/github#which-setup-do-i-need)
  If you run **Overcut on your own infrastructure**, follow
  [GitHub from self-hosted Overcut](/docs/integrations/github/self-hosted) instead.
</Note>

## Prerequisites

* A **GitHub account** with access to repositories you want to connect
* **Admin permissions** to install GitHub Apps in your repositories or organization
* An active Overcut Cloud workspace

## Connect

<Steps>
  <Step title="Start GitHub Connection">
    In your Overcut workspace, go to **Integrations** and click **Connect GitHub**.
  </Step>

  <Step title="Install the Overcut GitHub App">
    Click **Connect** to be redirected to GitHub. Choose whether to install the app for your personal account or specific organizations. Grant the necessary permissions for repositories and issues.
  </Step>

  <Step title="Select Repositories">
    Choose which repositories the Overcut app should have access to. You can select all repositories or specific ones based on your needs.
  </Step>

  <Step title="Complete the Setup">
    After installing the app and selecting repositories, you'll be redirected back to Overcut. The connection will be established and you can start using GitHub in your workflows.
  </Step>
</Steps>

To add or remove repositories later, use the installation's **Configure** page
on GitHub (**Organization settings -> GitHub Apps -> Overcut -> Configure**);
Overcut picks up the change automatically.

## Permissions

The managed Overcut GitHub App requests the following permissions:

### Repository Access

* **Contents**: Read and write access to repository code
* **Issues**: Read and write access to issues and comments
* **Pull Requests**: Read and write access to pull requests and reviews
* **Actions**: Read and write access to trigger and monitor GitHub Actions workflows
* **Metadata**: Read access to repository metadata

### Organization Access

* **Members**: Read access to organization members (for assignment features)
* **Organization**: Read access to organization information

These permissions allow Overcut to fully integrate with your GitHub workflow while maintaining security and following GitHub's best practices.

## Troubleshooting

### Connection Issues

* Ensure you have admin permissions in your GitHub organization
* Try disconnecting and reconnecting the integration
* Check that your GitHub account is accessible and not rate-limited

### Missing Repositories

* The integration only shows repositories included in the app installation -
  review the installation's **Configure** page on GitHub
* Check your GitHub user permissions for specific repositories

For what agents can do once connected (repositories, issues, pull requests,
triggers), see the [GitHub overview](/docs/integrations/github).