Mergeveil AI Pull Request Review Agent

Mergeveil AI is an intelligent GitHub App that automatically reviews pull requests and delivers structured, actionable AI feedback directly inside your GitHub workflow.

It listens to pull request events, analyzes changed code using advanced AI models, and posts file-level insights on bugs, performance risks, security issues, and best practices. Developers can also trigger manual reviews anytime using the /ai-review command in a pull request.

Built for production engineering teams, Mergeveil helps you ship cleaner, safer code faster without slowing down development.

Core Capabilities

Automated PR Reviews

• Automatically reviews pull requests on:
  • opened
  • synchronize
  • reopened
• Manual rerun supported via PR comment: /ai-review
• Posts structured AI feedback directly to the pull request

Intelligent Code Analysis

• Reviews changed files and diff patches
• Detects:
  • Bugs and logical issues
  • Security risks
  • Performance problems
  • Code quality concerns
• Provides clear suggested fixes for each issue
• Returns structured severity-based findings

Secure and Reliable

• Verifies GitHub webhook signatures (x-hub-signature-256)
• Deduplicates webhook deliveries to avoid duplicate reviews
• Uses GitHub App installation authentication
• Logs review activity and runtime events for traceability
• Health endpoint available for monitoring

Smart Review Scope Control

• Filters supported languages:
  • TypeScript
  • JavaScript
  • Python
  • Java
  • Go
• Ignores:
  • node_modules
  • dist
  • lock files
  • .env
• Limits review to configurable max files per PR
• Optimized for fast and focused analysis

AI-Powered Review Engine

• Uses Groq LLM inference (default: llama-3.3-70b-versatile)
• Sends file-level review requests
• Aggregates findings into a single structured PR review
• Outputs strict JSON findings internally for consistency

Optional Guarded Auto-Merge

• Can automatically merge PRs when:
  • No critical issues found
  • All checks pass
• Configurable merge method:
  • squash
  • merge
  • rebase
• Fully controllable via environment settings

Why Use Mergeveil AI

Mergeveil acts as an always-on senior code reviewer inside your GitHub repository.

It helps engineering teams:

• Catch issues early before merge
• Improve code quality automatically
• Enforce best practices consistently
• Reduce manual review workload
• Accelerate delivery without sacrificing safety

Whether you are a startup or scaling engineering team, Mergeveil integrates seamlessly into your existing GitHub workflow and elevates your development process with AI-powered reviews.

Triggering a Review

Automatic:

• Open a PR
• Push new commits
• Reopen a PR

Manual:

/ai-review

Comment this in any pull request to trigger a fresh AI review.

Output Structure (Internal)

Mergeveil generates structured review findings:

{
  "summary": "",
  "issues": [
    {
      "severity": "low|medium|high|critical",
      "file": "",
      "problem": "",
      "fix": ""
    }
  ]
}

If no issues are found:

{
  "summary": "",
  "issues": []
}

Built for Production

• GitHub App native authentication
• Webhook security verification
• Event deduplication
• Runtime logging and review history
• Health monitoring endpoint
• Cloud-ready deployment (Render, Docker, Node)

Mergeveil AI

Ship faster. Review smarter. Merge safer.