heyGRC Docs

What a review looks like

How heyGRC posts findings on a pull request: neutral Checks status, inline comments, one sticky summary, and /heygrc on demand.

heyGRC is a compliance reviewer, not a merge gate by default. On each review pass it grounds findings in the frameworks and company context you configured. It looks for compliance-relevant changes, not bugs. Summary and finding prose follow the org review language (default English).

What appears on the pull request

  1. Checks status
    A GitHub check run for heyGRC. By default it is neutral (or success when clean): it informs; it does not fail the PR to block merge. You can make it required in branch protection if you want a gate.

  2. Inline comments
    Findings on the lines that matter: control ID / reasoning where a change touches an obligation. Inline threads are resolvable conversations (see Does heyGRC block merges?).

  3. One summary per PR (sticky)
    heyGRC keeps a single summary for the pull request and updates it in place as you push. It does not stack a new full summary on every commit. When there are genuinely new findings, you still get a short review signal; unchanged re-runs stay quiet on the conversation. A /heygrc mention that finds nothing new can confirm completion with a reaction on your comment.

When reviews run

Review cadence is set in the console (org default, optional per-repo override):

ModeBehavior
autoReview when a PR is opened, reopened, or pushed to
auto_onceReview on open/reopen only (not every push)
mention_onlySilent until someone comments /heygrc

Default is auto. Teams that already run a noisy code-review bot often start with auto_once or mention_only.

On-demand: /heygrc

Comment /heygrc on a PR to trigger a review. You must be an Owner, Member, or Collaborator on the repo so a drive-by commenter cannot spend your reviews.

Large pull requests

Very large PRs may be reviewed only in part or marked partial / skipped with a clear neutral check so the worker stays safe. Prefer smaller PRs when you need full coverage. Orgs that enable EU inference use a smaller review budget, so partial reviews are more likely on huge diffs.

When an org has EU inference on, the review summary includes Inference: EU (Mistral) so you can see which path ran. Default orgs have no extra inference line.

On this page