06 - GitHub Integration#
GitHub integration connects Helmor workspaces to your remote repository. It adds account identity, remote branch tracking, and pull request workflows on top of the local agent experience.
What it enables#
| Feature | Benefit |
|---|---|
| Remote repo import | Clone and work on GitHub repositories without manual git clone. |
| Branch tracking | Workspaces know the upstream target branch for accurate diffs. |
| Account identity | Commits and PRs are attributed to your GitHub user. |
| Pull request prep | Push a workspace branch and open a PR directly from Helmor. |
Setup#
- Open Settings → GitHub in Helmor.
- Click Sign in with GitHub — a browser window opens for OAuth authorization.
- Grant access to the repositories (or organizations) you want Helmor to manage.
- Once authenticated, your GitHub repos appear in the Add Repository → Import from GitHub list.
The token is stored locally. Helmor never sends repository data to third-party servers beyond what the agent provider requires.
Common workflows#
- Import a repo — choose a GitHub project, Helmor clones it and links remote context.
- Push and PR — after reviewing agent work, push the workspace branch and create a pull request from the workspace view.
- Sync upstream — pull remote changes into the workspace to keep the base branch current.
Permissions#
Helmor requests the minimum scopes needed to read repos, push branches, and manage PRs. If your organization requires SSO, authorize Helmor through your org's approval flow.
Keep in mind#
GitHub does not replace local review. Always inspect the diff and run checks before pushing. If authentication fails, see GitHub Authentication Issues for troubleshooting steps.
Related#
- Add a Repository — import a GitHub repo into Helmor.
- Changes and Review — review before shipping.