Back to Docs
Docs

Quickstart - first PR review in 3 minutes

TriRev is a GitHub App that posts an AI code review on every pull request. Install it, open a PR, and the review shows up. No CI to wire, no YAML to write, no API key to manage.

This page takes you from "I just heard about TriRev" to "I have a real review on a real PR" in under 3 minutes.

What you need

  • A GitHub account or organization where you can install GitHub Apps.
  • A repository with at least one open or upcoming pull request.
  • That is the full list. No credit card required for the Free plan.

Step 1 - Install TriRev

  1. Open the TriRev listing on GitHub Marketplace.
  2. Click Set up a plan and choose Free. The Free plan covers 30 PR reviews per month with all 3 review agents on public and private repos.
  3. Pick the account or organization where you want TriRev installed.
  4. Choose All repositories or Only select repositories. You can change this later in your GitHub App settings.
  5. Click Install to confirm.

The install completes in a few seconds. You will be redirected to GitHub.

Step 2 - Read the welcome issue

Within ~30 seconds of installing, TriRev opens a single GitHub issue titled TriRev is installed - getting started checklist in your repository (or in the first repository alphabetically if you installed across an organization).

The issue contains:

  • A 3-step checklist: open a PR, read the review, optionally configure TriRev.
  • A note that you have 30 free reviews per month and that we will warn you at 80% usage.
  • Links back to this docs site.

You can close the issue at any time. It has no functional effect.

If you do not see the welcome issue after 1 minute, jump to Troubleshooting - "Welcome issue did not appear".

Step 3 - Open a pull request

That is it. Open or push to any pull request on a repository where TriRev is installed. The review starts automatically when:

  • You open a new PR.
  • You push new commits to an existing PR.

You do not need to mention TriRev, add a label, or click anything. TriRev listens for the standard GitHub pull_request and pull_request.synchronize webhooks.

Step 4 - See your first review

Within ~30 seconds of opening or updating the PR, TriRev posts a single review comment with:

  • A short summary of all findings across correctness, security, and style.
  • Inline comments on specific lines, each labelled with severity (critical / high / medium / low / info), confidence (0.0 to 1.0), and category (e.g. null-safety, injection, naming).
  • A concrete suggestion with a code fix where applicable.

If TriRev finds nothing, it still posts a clean summary confirming the review passed. Silence on a PR is never the expected behaviour.

The very first review you receive on a fresh install includes a small collapsed "First review from TriRev" footer. This footer appears once per install, so you can ignore it after the first PR.

Step 5 - (Optional) Customize

For most repositories, TriRev's defaults work well: all three agents on, medium severity threshold, 0.7 confidence threshold. Add a .trirev.yml file at the root of the repository only when you want to change something:

version: 1
severity_threshold: high
agents:
  style: false
ignore_paths:
  - "**/dist/**"
  - "**/*.generated.*"

This example only reports high and critical findings, disables the style agent, and skips generated files. The full reference lives in the Configuration guide.

What to do next

Nothing required. Just open a pull request like you normally would. TriRev will review it and post a comment within a couple of minutes. Setup is done.

The links below are for when a question comes up later, not before:

If you spent more than 3 minutes on this page, that is a bug. Tell us at the contact link in the FAQ.