Automatic reviews
Choose whether HeyDeer reviews pull requests on its own, and how often. You can always request a review yourself.
Review schedule
Set the schedule in Organization settings → Review rules, under When to review. A repository can follow it or choose its own; see How settings work.
| Schedule | What happens |
|---|---|
| Manual only | HeyDeer reviews only when someone asks: from HeyDeer, in a PR comment, or with Review this revision on the check. |
| Once per PR | HeyDeer reviews a pull request the first time it matches your filters. |
| On every push | HeyDeer reviews when the pull request first matches your filters, then after each push that adds commits. |
A new workspace starts with Manual only, so nothing is reviewed until an admin chooses a schedule.
Once per PR
A pull request gets one automatic review. Any review that starts counts, including one you requested, even if it later fails or is canceled; reopening the pull request doesn’t reset this. Later pushes aren’t reviewed automatically; with Fail the check when issues are found on, the check asks for a review. Comment @heydeer review to review it again.
On every push
Each commit is reviewed at most once for its target branch, so a label change or reopening doesn’t review it again. HeyDeer waits about 30 seconds after a push and reviews only the latest commit: a new push withdraws automatic reviews of earlier commits that haven’t finished.
By default, reviews after the first look only at what changed since the last review. See Follow-up reviews.
Maximum automatic reviews per PR
With On every push, HeyDeer stops reviewing a pull request automatically after this many successful reviews, including the first. The default is 5; choose 1, 2, 3, 5, 10, 20, or Unlimited. Reviews you request yourself don’t count and still work after the limit.
Stop automatic reviews when a PR closes
On by default. When a pull request is closed or merged, HeyDeer stops its queued and running automatic reviews. Reviews you requested yourself keep running.
Which pull requests qualify
A schedule applies only to pull requests that match your automatic review filters. By default, HeyDeer skips drafts and pull requests from forks. See Review filters.
To stop automatic reviews on one pull request, comment @heydeer pause. See PR comment commands.