Connect GitHub to Gentic via GitHub App Installation
Install the Gentic GitHub App to enable automatic pull request status updates and repository access for your AI coding agent runs.
The GitHub integration connects a GitHub App installation to your Gentic workspace. Once connected, GitHub automatically sends pull request status events back to Gentic — so the issue status on your dashboard reflects the real state of the PR without you needing to update it manually. You manage the integration from Settings → Workspace.
The GitHub integration card in Settings displays one of three states:
Not connected
No GitHub App installation is linked to your workspace. Agent runs can still open pull requests if the agent worker has direct Git access, but PR status events will not flow back into Gentic automatically.
Pending approval
You have submitted an installation request, but an organization administrator has not yet approved the GitHub App. This state applies to organization-owned repositories only.
Connected
The GitHub App installation is active. Pull request status updates from GitHub are delivered to Gentic automatically.
If you install the Gentic GitHub App on an organization-owned repository, the installation may require approval from an organization administrator before it becomes active. The integration status shows Pending approval until the admin grants access.
Navigate to Settings in the sidebar and select Workspace.
2
Click Connect GitHub
In the GitHub integration card, click the Connect GitHub button. This redirects you to GitHub to install the Gentic GitHub App.
3
Select repositories
On the GitHub App installation page, choose whether to grant access to all repositories or specific ones, then click Install.
4
Confirm the connection
After installation, GitHub redirects you back to Gentic. The integration card now shows Connected (or Pending approval for org installs awaiting admin sign-off).
To remove the GitHub integration, open the GitHub integration card in Settings and click Disconnect. Gentic removes the stored installation record. The GitHub App itself remains installed on your GitHub account or organization — you must uninstall it separately from your GitHub App settings if you no longer want Gentic to have any access.
The GitHub App integration controls PR status webhooks only. It is separate from the credentials the agent worker uses to clone and push to repositories. The agent worker requires its own direct Git or SSH access to your repositories — configure this in your self-hosted agent worker environment, not through the GitHub App settings in Gentic.
