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

# 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**.

## Connection States

The GitHub integration card in Settings displays one of three states:

<CardGroup cols={3}>
  <Card title="Not connected" icon="plug">
    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.
  </Card>

  <Card title="Pending approval" icon="clock">
    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.
  </Card>

  <Card title="Connected" icon="circle-check">
    The GitHub App installation is active. Pull request status updates from GitHub are delivered to Gentic automatically.
  </Card>
</CardGroup>

<Note>
  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.
</Note>

## Connect GitHub

<Steps>
  <Step title="Open Settings">
    Navigate to **Settings** in the sidebar and select **Workspace**.
  </Step>

  <Step title="Click Connect GitHub">
    In the **GitHub integration** card, click the **Connect GitHub** button. This redirects you to GitHub to install the Gentic GitHub App.
  </Step>

  <Step title="Select repositories">
    On the GitHub App installation page, choose whether to grant access to all repositories or specific ones, then click **Install**.
  </Step>

  <Step title="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).
  </Step>
</Steps>

## Disconnect GitHub

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.

## Agent Repository 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.