Skip to main content
You must have owner-level access for the GitHub organization or repository you intend to connect. Without these administrative privileges you cannot install the Garth GitHub App.

​
Connect your GitHub account

1

Access the Garth portal

Open your browser and navigate to the Garth dashboard.
2

Sign in

Select Continue with Google or Continue with Microsoft to authenticate via OAuth.
If you don’t have a Google or Microsoft account, sign up directly at app.heygarth.ai.
3

Create a Garth API key

In the left navigation, go to Developer → API Keys and click Create API Key.
Copy the API key and store it securely. It is shown only once.
4

Install the Garth GitHub App

Navigate to the Garth GitHub App and click Install. Sign in to GitHub if prompted.
5

Choose your workspace

Select the GitHub organization or personal account where Garth should be installed.
If your organization does not appear, verify you have the correct administrative rights and check your GitHub App installation settings.
6

Configure repository scope

Choose which repositories Garth can access:
  • All repositories — installs Garth on every current and future repository.
  • Select repositories — restricts Garth to specific projects you choose manually.
Garth requires read/write access to pull requests and checks to post code reviews. Your source code is never stored on Garth’s servers.
Click Install to apply.
7

Activate with your API key

After clicking Install, you are redirected to the Garth platform. Enter the API key you created earlier to complete the activation.
8

Start reviewing

Setup is complete. Open or update a pull request in any tracked repository to see Garth’s automated AI reviews in action.

​
Network configuration

If your infrastructure requires IP allowlisting, permit the following address through your firewall: 
34.117.160.133/32

​
Troubleshooting

If you cannot install the Garth GitHub App:
  1. Verify owner-level access — confirm you have Owner permissions for the organization or repository.
  2. Check organization settings — some organizations restrict third-party app installations; an organization owner may need to approve Garth before installation succeeds.
  3. Re-trigger the installation — return to the Garth GitHub App page and attempt the installation again.
  4. Contact your GitHub admin — if organization policies block app installations, your GitHub organization administrator must grant approval.
If Garth is installed but not reviewing pull requests:
  1. Confirm repository scope — verify the repository is included under All repositories or is explicitly listed under Select repositories in your App installation settings.
  2. Check API key activation — ensure you completed the API key activation step after installing the GitHub App.
  3. Verify pull request events — Garth triggers on newly opened or updated pull requests. Re-open the PR or push a new commit to trigger a review.
If you receive authentication or permission errors:
  1. Re-authenticate — log out and back into the Garth dashboard and retry connecting your GitHub account.
  2. Regenerate your API key — go to Developer → API Keys in Garth, revoke the old key, and create a new one.
  3. Reinstall the GitHub App — uninstall and reinstall the Garth GitHub App from your GitHub organization settings.
  4. Check SSO enforcement — if your organization uses SAML SSO, you may need to authorize the Garth GitHub App for SSO access from your GitHub personal settings.