Adding GitHub Repos

Superpositional needs access to your repositories before it can index them. You connect GitHub, select the repos you care about, and Superpositional handles the rest.

Connecting your GitHub account

Go to the Integrations page and connect GitHub. This installs the Superpositional GitHub App on your GitHub account or organisation.

During installation, GitHub asks you which repositories the app can access — you can grant access to all repos or select specific ones. The app needs read access to your code, pull requests, and issues. It also creates check runs on PRs to post review results.

You authorise once. After that, Superpositional can see the repositories you granted access to.

Adding repositories

Once GitHub is connected, go to the Repos page and click Add. A modal opens showing the repositories available from your GitHub App installation. Search or scroll to find the ones you want, and click Add on each.

You don't need to add everything at once. Start with one or two repos to see how indexing works, then add more when you're ready. Each repo you add gets queued for indexing immediately.

A few things to know:

• Private repos work fine. The GitHub App has access to whatever you authorised during installation.
• Monorepos are supported. Superpositional indexes the entire repository.
• You can add or remove repos later. Go back to the Repos page any time. Use the menu on each repo card to re-index or remove it.
• Multiple GitHub organisations. If your team uses multiple GitHub orgs, you can connect additional ones from the Add modal — click "Connect another GitHub organisation" at the bottom.

What happens after you add a repo

Once you add a repository, Superpositional kicks off the indexing pipeline. You can track progress in real time on the repo card itself — it shows the current stage and a progress bar. The repo card shows a status badge: Pending, Indexing, Ready, or Error.

For details on what each stage does and how long it takes, see Monitoring Indexing.

Re-indexing

Superpositional re-indexes automatically when you push to the default branch. You don't need to do anything — the GitHub App detects pushes and triggers a new indexing run. Push-triggered re-indexing is incremental — only the changes from the push are processed.

If you need to force a full re-index — say, after changing your repo's default branch or if something looks off — open the menu on the repo card (three-dot icon) and click Re-index. This runs the full pipeline again from scratch.

Removing a repository

To stop monitoring a repository, open the menu on the repo card and click Remove. Superpositional stops watching for changes immediately. Existing indexed data is retained but no longer updated.