Why is my AI code review not triggering

Common reasons and fixes when Fossa doesn’t automatically review your pull requests.

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

1. Automated review is disabled

Verify that automated reviews are enabled:

• Go to Code Review Settings → General
• Check that Automated Review is turned on
• Or verify in fossa-config.yml:

automatedReviewActive: true

2. Webhook is not configured

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

• Go to your Git provider’s webhook settings
• Verify the Fossa 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, Fossa skips the review:

ignoredTitleKeywords:
  - "release"
  - "WIP"

Check your ignoredTitleKeywords setting.

4. Base branch is not monitored

By default, Fossa 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, Fossa only reviews when you comment @fossy 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 @fossy start-review to trigger manually.

Still not working?

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