Install GitAlert

Install on a repository or organization

GitAlert is a GitHub App. You install it once and it starts checking pull requests on its own — there is nothing to add to your codebase and no CI pipeline to wire up.

  1. Sign in with your Git provider.
  2. From your dashboard, click Install GitAlert GitHub App. GitHub asks you to choose an account (your personal account or an organization you administer) and which repositories GitAlert may access.
  3. Pick All repositories or a specific list — you can change this any time from GitHub.
  4. Approve. That's it.

{primary} You can install GitAlert on an organization as well as a personal account. Installing on an org requires org-owner permission on GitHub, the same as any GitHub App.

What happens after you install

The moment the install completes, GitAlert:

  • Records your installation and the repositories you selected, so they appear in your dashboard.
  • Begins listening for pull requests on those repositories. The next PR that is opened or updated is triaged automatically, within seconds.

GitAlert reads your pull requests and posts its own neutral check. It never pushes commits, changes your branches, merges pull requests, or comments — the only thing it creates is its informational check-run. See Data & privacy for exactly what it reads and stores.

Connecting an installation to your dashboard

When you install from the dashboard button, GitHub sends you back through GitAlert's setup step, which links the new installation to your signed-in account automatically.

If you installed GitAlert directly from GitHub (outside the dashboard button), your dashboard has a one-click self-claim for installations on your own GitHub account — it connects them to you securely, because the account matches the identity you signed in with.

My dashboard is empty — what now?

A dashboard shows nothing until an installation is linked to your account and a pull request has been opened since you installed. If it looks empty:

  • Confirm the install actually completed on GitHub (Settings → Applications → Installed GitHub Apps).
  • Open or update a pull request on a covered repository — triage only runs on new PR activity, not retroactively on old PRs.
  • If you installed on an organization and it isn't showing, contact us so we can link the organization installation to your account. Self-serve claiming of organization installs is on the roadmap.

Uninstalling

You can remove GitAlert from any repository or organization at any time from GitHub → Settings → Installed GitHub Apps → GitAlert → Configure. As soon as you uninstall, GitAlert stops receiving that repository's data. See the Privacy & Security page for how data is retained and how to request deletion.