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

# Connect GitHub

> Authorize GitHub so GPR can sync issues and open pull requests.

GitHub is optional for local coding, but you need it to open PRs on GitHub, sync issues, and enrich merge checks with live PR metadata.

GPR still works in **git-only** mode: the daemon uses local git and worktrees. Without GitHub OAuth, host-backed PR APIs are unavailable.

## Connect from the app

1. Sign in to GPR (Google or GitHub via Firebase login).
2. Open **Settings → Connections**.
3. Connect **GitHub** and finish the OAuth flow.
4. Bind a repository to your workspace when prompted during onboarding or workspace setup.

The GitHub OAuth callback uses the app deep link `com.pullrequest://github-callback`.

## Auto-pick issues with a label

Onboarding documents this convention:

1. Add the label `gpr:agent` to a GitHub issue.
2. Assign the issue to yourself.
3. GPR syncs it onto the board and can start work on your paired workspace.

## What GitHub unlocks

| Capability                          | Needs GitHub OAuth |
| ----------------------------------- | ------------------ |
| Local agent work in a worktree      | No                 |
| Open / update a GitHub pull request | Yes                |
| Sync GitHub issues onto the board   | Yes                |
| Live PR mergeability hints          | Yes                |
| Merge from the app via GitHub       | Yes                |

## Next

[Connect a coding agent](/docs/get-started/connect-a-coding-agent) on the paired machine.