Skip to main content

​
Installation

Mesa integrates directly with your GitHub repositories to provide AI-powered code review. Follow these steps to get started.

​
Prerequisites

Before installing Mesa, ensure you have:
  • A GitHub account with admin access to the repositories you want to connect
  • Repositories that you want Mesa to monitor and provide feedback on

​
Step 1: Connect Your GitHub Account

1

Sign up for Mesa

Visit Mesa and click “Continue with GitHub” to create your account.
2

Authorize GitHub Integration

You’ll be redirected to GitHub to authorize Mesa’s access to your repositories. Mesa requires the following permissions:
  • Read access to repository content and metadata
  • Write access to pull requests and issues for commenting
  • Webhook access to receive real-time updates
Mesa only accesses repositories you explicitly select. You can modify permissions at any time through your GitHub settings.
3

Select Repositories

Choose which repositories you want Mesa to monitor. You can:
  • Select all repositories in your organization
  • Choose specific repositories individually
  • Add repositories later from your Mesa dashboard

​
Step 2: Watch Mesa Review Your First Pull Request

Once you have connected your GitHub account and selected your repositories, Mesa will give the opportunity to select a first pull request to review. You will be able to watch the review in real-time to see how Mesa’s agent swarm analyzes the code.
Live review of a pull request

​
Step 3: Configure Your First Expert Agent

Once connected, you’ll be taken to the Mesa dashboard where you can set up your first custom code review agent.
1

Create an Expert Agent

Navigate to the “Agents” section and click “Create Agent”.
2

Configure Agent Settings

Customize your agent’s behavior:
  • Name: Give your agent a name
  • Icon: Choose an icon for your agent
  • Model: Choose a model for your agent
  • Repository: Choose repositories that your agent should apply to
  • Directive: Give your agent a job description, ex. “You are an expert in frontend development, specializing in React, Typescript, and TailwindCSS”
  • Rules: Click on the ellipsis in the top right corner of the agent card and click “Add Rule” to create a rule for your agent. These rules will be conditionally considered by the agent when reviewing code.
3

Set Review Triggers

Navigate to “PR Defaults” -> “Review” and set when Mesa should review code:
  • On pull request creation
  • When new commits are pushed

​
Step 4 (Optional): Iterate on Your Configuration

1

Create a Test Pull Request

Create a small pull request in one of your connected repositories to test the integration.
2

Verify Agent Response

Your code review agent should automatically comment on the PR within a few minutes. Check that:
  • Comments appear as expected
  • Review quality meets your standards
  • Notifications are delivered properly
3

Adjust Settings

Based on the test results, tweak your agent configuration in the Mesa dashboard.
4

Manually Request a Re-review

If you wish to force Mesa to re-review a pull request, you can do so manually by adding a discussion comment with the text /review.

​
Troubleshooting

  • Check that the repository is connected in your Mesa dashboard
  • Review Mesa’s review trigger conditions
  • Go to GitHub Settings → Applications → Mesa
  • Verify all required permissions are granted
  • Re-authorize if necessary through the Mesa dashboard
  • Check that Mesa has write access to the repository
  • Verify you haven’t reached GitHub’s rate limits
  • Ensure the PR is not in a private repository without proper access

​
Next Steps

Now that Mesa is installed and configured:

Need Help?

Our support team is available to help with setup and configuration questions. Email us at support@mesa.dev.