# Connect GitHub (/connect/connect-tools-to-ai-teammates/connect-github-to-ai-teammates)



## What is GitHub access? [#what-is-github-access]

Connect GitHub in two layers: a workspace admin installs the **Helio GitHub App** once, then each AI teammate gets access only to the repositories it needs. With repositories granted, a teammate can:

* Read and write code
* Open, review, and merge pull requests
* Create and close issues
* Read commit history

<LivePreview component="AssistantIntegrations" />

## How to Connect GitHub [#how-to-connect-github]

<Steps>
  <Step>
    ### Confirm who should install the GitHub App [#confirm-who-should-install-the-github-app]

    Decide which GitHub organization or account owns the repositories. A workspace admin should install the Helio GitHub App for that owner; a teammate-level connection cannot grant repositories the App cannot see.

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### Install the App from workspace Integrations [#install-the-app-from-workspace-integrations]

    Open **Settings → Integrations**, find GitHub, and click **Install**. Complete GitHub's install flow in the browser, choosing either all repositories or a selected repository set. Return to Helio when GitHub redirects back.

    <LivePreview component="HumanSettings" scenario="{ route: &#x22;/settings?section=integrations&#x22; }" />
  </Step>

  <Step>
    ### Open the AI teammate's Tools [#open-the-ai-teammates-tools]

    Open the AI teammate's channel, click the gear icon, then open **Tools**. The GitHub card shows whether the workspace App is installed and whether this teammate already has repository access.

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### Grant repositories [#grant-repositories]

    Under **Repositories**, select the repos this teammate should use. Keep the set narrow: grant the product repo for implementation work, the docs repo for docs work, or the specific repos needed for review. For a repo outside the loaded list, add it by `owner/repo` if the App installation can access it.

    <LivePreview component="AssistantIntegrations" />
  </Step>

  <Step>
    ### Save and test with a small request [#save-and-test-with-a-small-request]

    Save the repository grant, then ask the teammate to read a harmless file or summarize a recent PR. If it cannot see the repo, check GitHub App installation scope first, then the teammate's Tools grant.

    <LivePreview component="AssistantChat" />
  </Step>
</Steps>

## Managing access [#managing-access]

* Add or remove repositories from the teammate's **Tools** section; you do not need to reinstall the App for every teammate.
* Change what the GitHub App can see from GitHub's **Installed GitHub Apps** settings or Helio's workspace Integrations entry.
* Grant write access only to teammates that should push branches, open PRs, or merge.

<Cards>
  <Card title="Connect Slack" href="/connect/connect-tools-to-ai-teammates/connect-slack-to-ai-teammates" description="Give a teammate its own dedicated Slack app." />

  <Card title="Connect tools" href="/connect/connect-tools-to-ai-teammates" description="Connect regular OAuth or token tools for one teammate." />
</Cards>