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.
  • Triages the pull requests that are already open on those repositories, so your dashboard is useful immediately rather than after the next push. This one-time sweep is bounded (25 PRs across the installation by default, 10 per repository).
  • Begins listening for pull requests on those repositories. Every PR opened or updated from then on 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. It covers installations on your own GitHub account, and organization installations that the GitHub account you signed in with performed — in both cases because GitHub itself tells us who owns or installed it. Anything we cannot prove stays unconnected rather than being handed to the wrong account.

My dashboard is empty — what now?

A dashboard shows nothing until an installation is linked to your account. If it looks empty:

  • Confirm the install actually completed on GitHub (Settings → Applications → Installed GitHub Apps).
  • Look for the Connect banner at the top of the dashboard — an installation we can prove is yours appears there for one-click linking.
  • If the repositories you selected have no open pull requests, open or update one; there is nothing to triage until then.
  • If you signed in with a provider other than GitHub, sign in with GitHub instead: linking an installation needs the GitHub identity that owns or performed it.
  • If an organization install still isn't showing (for example, an owner approved it on your behalf), contact us and we will link it for you.

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.