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

# GitHub

> Connect GitHub once at the account level; every project uses the same identity.

GitHub is one of two supported code hosts ([GitLab](/integrations/gitlab) is the other). Hideout reads your repo, opens branches, and raises PRs through this connection. Connect once at the account level; every project against a GitHub repo reuses it.

<Note>
  **Where:** Platform → **Profile → Integrations** tab. Click **Connect GitHub**.
</Note>

## What we ask for

The GitHub OAuth scope is `repo` — read and write access to the repositories you authorize. Hideout uses it to:

* Read your codebase when an agent launches.
* Push branches and open PRs.
* Read commit and branch state for the Agents page.

Organization-level admin and billing access are not requested.

## Per-repo authorization

GitHub connections are per-user, per-repo. If a teammate connected a repo you haven't, your launches against the project's primary repo still work — Hideout uses the project owner's connection instead. The only thing affected is which repos show up in the New Project wizard's picker for you.

## Disconnecting

**Profile → Integrations → GitHub → Disconnect** clears the tokens and removes Hideout's authorization. Projects you've created lose their repo link; teammates' connections to the same repo aren't affected.

## Troubleshooting

* **"GitHub connection expired"** — your OAuth token was revoked or rotated. Reconnect from Profile → Integrations.
* **Agent unable to read codebase** — check that the project's connected repo is still accessible to the connecting user and that branch permissions allow Hideout to push.