GitHub

GitHub

By connecting Super with GitHub, you can search and ask questions across the issues and pull requests in your connected repositories.
This article covers connecting GitHub, how Super uses your data, and permissions.

Connecting GitHub & Super

Required Permissions for Setup

To connect Super and GitHub, you must have the necessary permissions* in both platforms.
  • In Super: Permission to add or remove data sources depends on your team's settings. By default, only workspace admins or owners can set up a connection. However, a Super admin can enable a setting to allow all members to add and remove data sources.
  • In GitHub: You need read access to the repositories you want to connect, plus permission to install GitHub Apps in the organization. For most organizations, only org admins can install apps.
*If you don't have these permissions, ask a GitHub org admin to install the Super app and grant access to the repositories you need.

Initial GitHub Connection

    In Super, click Data Sources in the sidebar.
    Click + New source , then choose or search for GitHub and click Connect GitHub .
    A new window will open. Review the permissions Super is requesting and click Allow .
    Back in Super, select the GitHub repositories you want to sync.
    The initial sync will start in the background.

How Super uses your GitHub data

Super indexes issues and pull requests from the repositories you connect — titles, descriptions, and metadata like state (open/closed/merged), assignees, reviewers, labels, milestones, and dates. Comments, code, commit history, and repository metadata are not synced.
When a repository is first connected, Super imports all issues and pull requests modified in the last 365 days. After that, Super uses GitHub webhooks to receive near-real-time updates — changes you make in GitHub usually appear in Super within seconds.

Access Control & Privacy

GitHub is a  Shared  source: once a repository is connected, its content is available to your Super workspace as a whole. Super does not mirror GitHub's per-user repository permissions — anyone with access to the source in Super can search content from any connected repository, including private ones. To limit who can query GitHub content, choose which repositories to connect and use Super's access controls.
By default a newly connected repository is restricted to workspace admins. To open it to more people, go to the connection in the Data Sources panel and adjust access. See  Controlling access to shared sources  for details.

Frequently asked questions

Does Super write back to GitHub?

No. Super is strictly read-only — it doesn't open issues, leave comments, change labels, modify pull requests, or push to your repositories.

Is code from my repositories indexed?

No — the GitHub source only indexes issues and pull requests. If you want Super to index a repository's source files, you need to add it as a separate  Git  source and enable the Index code option there. This works even for repositories hosted on GitHub.

How quickly do changes in GitHub appear in Super?

Usually within seconds. Super registers webhooks on connected repositories, so issue and pull request updates are pushed to Super in near-real-time.

What happens if a repo is made private after we connect it?

The connection keeps working as long as the Super GitHub App still has access to the repo. Removing the app from a repo on the GitHub side stops sync for that repo.