> ## Documentation Index
> Fetch the complete documentation index at: https://cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect GitHub

> Cortex Code reaches repositories through Connect GitHub — on Code Home, in the repository picker, and under Settings → Integrations. No personal-access-token field.

Code needs a repository to work on. You give it one by connecting GitHub from the product; Cortex then lists the repositories the grant covers and starts sessions on them. The same connection adds GitHub tools to Chat.

<Frame caption="Settings → Integrations. Connect GitHub adds four GitHub tools to chat and unlocks repositories for Code.">
  <img src="https://mintcdn.com/cortex-foundation-add13747-droid-1a2462c9-cor-444-sanitize/_zkvI1h_JpZuQFg3/images/product/settings-integrations.png?fit=max&auto=format&n=_zkvI1h_JpZuQFg3&q=85&s=100a7174e9213b6beb866555da9e991b" alt="Settings → Integrations — GitHub with a Connect GitHub button and tools listed; Linear, Slack, Notion, Vercel marked Soon" width="1280" height="800" data-path="images/product/settings-integrations.png" />
</Frame>

## Connect

<Steps>
  <Step title="Sign in">
    A guest cannot hold a GitHub grant — there would be no way to come back and revoke it.
  </Step>

  <Step title="Choose Connect GitHub">
    From **Code Home**, the **repository picker**, or **Settings → Integrations**.
  </Step>

  <Step title="Approve on GitHub">
    Grant access to the repositories you want Code to see. There is no personal-access-token field anywhere in Cortex; the connection is the only route.
  </Step>

  <Step title="Pick a repository">
    Back in Code, choose a repository and start a session. See [Sessions](/code/sessions).
  </Step>
</Steps>

## What the connection gives you

| Surface  | What GitHub adds                                                                                                                               |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Code** | The repository list; sessions clone and work inside the guest                                                                                  |
| **Chat** | Four GitHub tools — list pull requests, list issues, create an issue, and more — available in your conversations                               |
| **CLI**  | `cortex pr <number>` to check out a pull request, and `cortex github install` to scaffold review workflows. See [Headless runs](/cli/headless) |

## If something is missing

| What you see                                 | What it means                              | Do this                                                        |
| -------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------- |
| No **Connect** control                       | GitHub is not available on this deployment | Nothing to configure — the surface is not offered here         |
| **Reconnect**                                | The grant lapsed or was revoked on GitHub  | Choose **Reconnect** and approve again                         |
| The public `/code` page instead of Code Home | You are not signed in                      | Sign in                                                        |
| A repository is not listed                   | The grant does not cover it                | Reconnect and include it, or adjust the installation on GitHub |

## Three different GitHub installs

| Install                        | Purpose                                              | Where                                                               |
| ------------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------- |
| **Connect GitHub**             | Repositories for Code sessions; GitHub tools in Chat | Code Home, repository picker, Settings → Integrations               |
| **Cortex Security GitHub App** | Pull-request review as a check run                   | `/code/security` in the app — see [Cortex Security](/code/security) |
| **`cortex github install`**    | Workflow files for CI review from the CLI            | Your repository — see [Headless runs](/cli/headless)                |

Connect GitHub is not part of Chat's connector catalogue under **Customize**, and Code Cloud is not a plugin surface.

## Related

* [Code quickstart](/code/quickstart)
* [Tools and connectors](/chat/tools) — the rest of Chat's connections.
* [Troubleshooting](/code/troubleshooting)