// get started
Install GitHub Apps
Install Superagent Security and Open CLA on the repositories you choose to enable PR scans, contributor trust, red-team reports, and CLA checks.
Superagent gets GitHub access through GitHub Apps installed on the repositories you choose, not through a broad OAuth token. Install each app only on the repos Superagent should scan, test, or govern.
The two apps
| App | Install URL | What it enables |
|---|---|---|
| Superagent Security | github.com/apps/superagent-security | PR security scans, supply chain scans, contributor trust, repository red-team reports, GitHub advisory ingestion |
| Open CLA | github.com/apps/open-cla | CLA checks on pull requests, contributor signing, per-repo CLA enforcement |
You can install one or both apps on the same repositories.
Install an app
- Sign in to the Superagent dashboard and open Integrations.
- Select the app that matches your workflow. GitHub opens the installation flow.
- Install on the organization or account that owns your repositories.
- Choose Only select repositories and pick the repos Superagent should access. Select all repositories only if you intentionally want every repo covered.
- GitHub redirects you back to Superagent when the install completes.
After connecting:
- Open Integrations and confirm each app shows as connected.
- Open Repository and verify your repos appear with the expected capability badges: Security, CLA, or both.
- Open or update a pull request on a connected repo to see the first checks run.
You can change repository access later by reconfiguring the app in GitHub or from Integrations.
Superagent Security
Install Superagent Security when you need:
- Security scan and Contributor trust checks on pull requests
- Superagent Supply Chain Scan checks for changed dependencies
- Repository red-team reports on connected repos, including private repo clone access for scans
- GitHub repository security advisories surfaced as findings
The app needs repository access for checks, pull request events, comments, and labels. Advisory triage uses repository_advisory webhook events.
Open CLA
Install Open CLA when you need:
- The Contributor License Agreement check on pull requests
- Contributor signing, in-app or via Dropbox Sign
- Per-repository CLA template assignment
Open CLA needs repository access for CLA file reads, pull request checks, and signing comments. Organization membership read access is required for corporate CLA coverage. See How CLA checks work.