Skip to main content
GitHub is one of two supported code hosts (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.
Where: Platform → Profile → Integrations tab. Click Connect GitHub.

​
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.