GitHub integration
Connect GitHub so Helpin agents can work in your repositories and your tasks show delivery progress. Once connected, agents can create branches, commit changes, and open pull requests, and Helpin updates the related task as the pull request moves forward.
GitHub connects through the Helpin GitHub App. You install the app on your GitHub account or organization and choose which repositories it can see.
Before you start
You need to be an organization Owner or Admin in Helpin. Other people see Organization admins manage provider access and can still use repositories already enabled for their workspace.
You need permission in GitHub to install apps on the account or organization that owns the repositories.
Connect GitHub
Open Settings and, under Organization, select Git connections.
Select Connect GitHub. If you already have a GitHub connection, the button reads Connect Another GitHub Org.
On GitHub, choose the account or organization, select the repositories to share, and install the app.
GitHub returns you to Helpin, where the new connection appears on the Git connections page.
Select Manage workspace repositories to make repositories available to a workspace. See Workspace repositories.
The app asks GitHub for read access to repository metadata and checks, and read and write access to code and pull requests. It receives push, pull request, release, and check suite events.
What Helpin does with GitHub
Agent work: coding agents create branches, commit, and open pull requests in enabled repositories.
Delivery progress: when a branch or pull request is linked to a task (for example, because Helpin created it), pushes and pull request updates appear in the task's Delivery progress timeline with View PR, View commit, and View branch links.
Task status: if your team has automatic state sync turned on, opening or closing a linked pull request can move the task to your review or closed state.
Automations: push, pull request, release, and check events can trigger automation rules.
Manage the connection
Each connection card on Git connections offers:
Action | What it does |
|---|---|
Manage access | Opens the app's installation settings on GitHub, where you change which repositories it can see |
Refresh icon | Syncs the connection so new repositories show up |
Edit commit identity (pencil icon) | Sets the Author name and Author email used for agent commits. Without one, commits use Helpin Agent |
The card also shows how many workspaces and enabled repositories use the connection.
Disconnect GitHub
On Git connections, select the trash icon on the connection.
Review the Disconnect Git provider message, then select Disconnect.
Disconnecting removes repository access from every workspace that used the connection. To remove the app from GitHub as well, uninstall it from your GitHub account or organization settings.
Self-hosted Helpin
If no GitHub App is set up for your Helpin server, Connect GitHub is unavailable and a workspace Owner sees Create GitHub App. Follow the prompts to choose who owns the app; GitHub then asks you to install it and returns you to Helpin.
Related
Was this article helpful?