Start here

Quickstart

Three steps, a few minutes, and nothing to commit to your repository.

1. Install the GitHub App

Install LintCat on your GitHub organization or personal account, and choose all repositories or only some. GitHub then sends you back to the dashboard, signed in, with your organization set up.

Install the GitHub App

2. Add a model key

On the dashboard, open Settings in the sidebar, pick Anthropic or OpenAI and paste an API key. Only organization owners see this page. The key is stored encrypted and never shown again; the dashboard shows only its last four characters.

Until a key is saved, a pull request that would be reviewed gets a neutral check run asking an owner to add one, and no model is called.

3. Review a pull request

Open a pull request on an installed repository. The review runs in the background and posts when it finishes, and every later push to that pull request is reviewed again.

To review only the pull requests you pick, switch the repository to the ai-review label on its settings page. See Configuration.

What lands on the pull request

  • Inline review comments on the lines the findings point at, one per finding.
  • An AI PR Review check run with the full summary. Its conclusion is neutral whenever there are findings. The review is advisory and never blocks a merge.
  • One-click suggested changes wherever a finding carried a fix that checked out against the latest commit.
  • The review, its findings and its token spend, on your dashboard.