KnowledgeAI review not triggering

If Mesrai isn’t reviewing your PRs, check these common causes:

1. Automated review is disabled

Verify that automated reviews are enabled:

  • Go to Code Review SettingsGeneral
  • Check that Automated Review is turned on
  • Or verify in mesrai-config.yml:
automatedReviewActive: true

2. Webhook is not configured

Mesrai needs webhooks to know when a PR is opened or updated:

  • Go to your Git provider’s webhook settings
  • Verify the Mesrai webhook URL is registered and active
  • Check for failed delivery attempts

3. PR title matches an ignored keyword

If the PR title contains an ignored keyword, Mesrai skips the review:

ignoredTitleKeywords:
  - "release"
  - "WIP"

Check your ignoredTitleKeywords setting.

4. Base branch is not monitored

By default, Mesrai reviews PRs targeting the default branch. If your PR targets a different branch, add it to baseBranches:

baseBranches:
  - develop
  - staging

5. Review cadence is set to manual

If review cadence is set to Manual, Mesrai only reviews when you comment @mesrai start-review.

6. Auto-pause is active

If you’ve pushed multiple times quickly, auto-pause may have kicked in. Wait for the cooldown period or comment @mesrai start-review to trigger manually.

Still not working?

Try commenting @mesrai start-review on the PR to trigger a manual review. If that doesn’t work, check the Troubleshooting guide.