Core Settings

Mesrai has three config levels: Global, Repository, and Directory. Learn how they work in Config Inheritance & Overrides.

Config Priority

mesrai-config.yml in your repo root overrides web settings. No setup needed—just commit the file.

Sample mesrai-config.yml

version: '1.2'
summary:
  generatePRSummary: true
  customInstructions: ''
  behaviourForExistingDescription: concatenate
ignorePaths:
  - yarn.lock
  - package-lock.json
  - package.json
  - .env
baseBranches: []
reviewOptions:
  security: true
  code_style: true
  mesrai_rules: true
  refactoring: true
  error_handling: true
  maintainability: true
  potential_issues: true
  documentation_and_comments: true
  performance_and_optimization: true
  business_logic: true
suggestionControl:
  groupingMode: full
  limitationType: pr
  maxSuggestions: 9
  severityLevelFilter: medium
ignoredTitleKeywords: []
automatedReviewActive: true
pullRequestApprovalActive: false
isRequestChangesActive: false
llmGeneratedMemoriesRequireApproval: false

Review Behavior

Automated Review

Mesrai can review PRs automatically when opened, or only when you comment @mesrai start-review.

This affects the initial review only. For subsequent commits, see Review Cadence below.

Review Cadence

How Mesrai handles reviews on subsequent commits:

Review every new push. Continuous feedback on all changes.

PR Workflow

Auto-approve PRs

Mesrai approves PRs when no issues are found.

Platforms: GitHub, GitLab, Bitbucket

Request Changes

Mesrai requests changes when finding critical issues.

Platforms: GitHub, Bitbucket

Skip Conditions

Ignored Files: Use glob patterns (e.g., **/*.js), one per line. Default: yarn.lock, package-lock.json, package.json, .env

Ignored Titles: Skip PRs with specific keywords (case-insensitive, max 100 chars)

Base Branches: Additional branches to review besides default (dev, release, master)

Analysis Types

Code Quality

Security: SQL injection, XSS, security threats
Performance: Caching, query optimization, speed improvements
Error Handling: Exception management, error messages
Potential Issues: Null pointers, resource leaks, infinite loops

Code Structure

Refactoring: Code organization, function size, duplication
Maintainability: Future-proof code patterns
Code Style: Consistent formatting and standards
Documentation: Clear comments and API docs
Mesrai Rules: Custom rule enforcement
Business Logic: Validates PR implementation against task requirements and acceptance criteria

Review policy Centralized config