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

# GitHub

> Connect GitHub to Modus so your scopes have context from your repositories.

Connect GitHub so your repositories — code, pull requests, issues, and comments —
become context that Modus can reason over. GitHub connects via a **GitHub App**
installation over OAuth — see [Connecting apps](/guides/connect-apps) for the
general flow.

## Who can connect

Installing the Modus GitHub App on an **organization** requires an **organization
owner**. Members can start the install and request approval — GitHub notifies an
owner to approve. On personal repositories, you can install it yourself.

## Connect

<Steps>
  <Step title="Start the connection">
    In [Modus](https://app.getmodus.com), go to **Integrations**, find **GitHub**
    under **Code**, and click **Connect**.
  </Step>

  <Step title="Install the GitHub App">
    In the popup, install the Modus GitHub App and choose which **repositories** it
    can access (all repos, or a specific selection). This is where GitHub's
    permissions are granted.
  </Step>

  <Step title="Select repositories in Modus">
    Back in Modus, pick the **repositories** Modus should use as context.
  </Step>
</Steps>

## What Modus can access

Access is defined by the GitHub App's permissions and the repositories you grant
at install time — read access to the selected repositories' content, pull
requests, issues, and workflow runs. No access is granted to repositories you
don't select.

This is a **workspace** connection shared across your Modus organization.

Need help? Contact us at [support@getmodus.com](mailto:support@getmodus.com).
