# GitHub integration

Canonical HTML: https://getdispatcher.dev/help/github

## What you get

- Import GitHub issues into your Dispatcher board
- Open pull requests from reviewed agent work in a task’s worktree
- Ship large features as [GitHub Stacks](https://docs.github.com/en/pull-requests/how-tos/stacked-pull-requests) (`gh stack`) of dependent PRs
- Keep the coding loop close to the repo you already use

## Connect GitHub

1. Open Dispatcher
2. Go to **Settings → Integrations**
3. Choose **GitHub** and complete the OAuth flow
4. Approve access for the repositories you need

If the browser callback fails, confirm you launched the connect flow from the desktop app and that you aren’t blocking pop-ups or the Dispatcher redirect.

## Import issues

1. Open your board / project in Dispatcher
2. Use the GitHub import action (from Integrations or the issue intake UI)
3. Select issues or projects to pull in
4. Scope the task, attach context, then run an agent

## Open a pull request

1. Run an agent on a task so work lands in its [worktree](https://getdispatcher.dev/help/worktrees)
2. Review the diff and terminal output in Dispatcher
3. Use the PR action when the change is ready — choose a **single PR** or **Stacked PRs** (GitHub Stacks via `gh stack`) for larger features
4. Finish review/merge on GitHub as usual

## Tips

- Agents use your local git credentials/SSH setup inside the worktree
- Prefer small, reviewable tasks over huge multi-purpose prompts
- For stacked work, Dispatcher injects the `gh-stack` skill and shows a stack map so you can submit and merge without leaving the app
- If PR creation fails, verify GitHub auth hasn’t expired and the repo still allows access

## Related

- [Integrations overview](https://getdispatcher.dev/help/integrations)
- [Troubleshooting](https://getdispatcher.dev/help/troubleshooting)