BugBot automatically reviews your PRs and catches potential bugs and issues. It uses the same AI that powers Cursor Agent to catch issues that humans might miss.

​

Setup

To set up BugBot, you need Cursor admin access and GitHub org admin access.

1. Go to cursor.com/dashboard
2. Navigate to the BugBot tab
3. Click Connect GitHub (or Manage Connections if already connected)
4. Follow the GitHub installation flow to install the app
5. After setup, return to the dashboard to enable BugBot on specific repos where you can configure settings

​

Configuration

• Individual
• Team

​

Spending limit

Set a monthly spending limit for BugBot in $USD. This counts towards your global spending limit.

​

Per GitHub installation

After installing, you’ll see available installations and their enabled repositories. Enable or disable BugBot per repository. BugBot only runs on your personal PRs.

​

Personal

Customize how BugBot works:

• Only Run when Mentioned: Start BugBot manually, by commenting cursor review or bugbot run on a PR
• Only Run Once: Run BugBot only once per PR, even if new commits are added

​

Spending limit

Set a monthly spending limit for BugBot in $USD. This counts towards your global spending limit.

​

Per GitHub installation

After installing, you’ll see available installations and their enabled repositories. Enable or disable BugBot per repository. BugBot only runs on your personal PRs.

​

Personal

Customize how BugBot works:

• Only Run when Mentioned: Start BugBot manually, by commenting cursor review or bugbot run on a PR
• Only Run Once: Run BugBot only once per PR, even if new commits are added

​

Spending limit

Team admins can set a monthly spending limit for BugBot in $USD. This counts towards your team’s global spending limit.

​

Per GitHub installation

After installing, team admins will see a list of available installations and their enabled repositories. Team admins can enable or disable BugBot per repository, setup allow/denylists for reviewers, and configure settings:

• Only Run Once: Run BugBot only once per PR per installation, even if new commits are added

Once enabled, BugBot will run for anyone contributing to the repository, whether or not they’re on your team.

​

Personal

Individual Team members can customize how BugBot works:

• Only Run when Mentioned: Start BugBot manually, by commenting cursor review or bugbot run on a PR
• Only Run Once: Run BugBot only once per PR, even if new commits are added

​

How BugBot Works

BugBot analyzes PR diffs using Cursor’s most powerful models. When it finds potential issues, it leaves comments with detailed explanations and fix suggestions.

• Automatic Comments: BugBot re-runs and comments on every PR update
• Manual Trigger: Run BugBot manually with cursor review, bugbot run, or cursor run in a PR comment
• Fix in Cursor: Use “Fix in Cursor” links in comments to jump into Cursor with full context preloaded

​

Pricing

BugBot uses the same AI that powers Cursor with Max mode pricing.

​

Troubleshooting

If BugBot isn’t working:

1. Enable verbose mode: Comment cursor review verbose=true (or bugbot run verbose=true) on your PR for detailed logging and request ID
2. Check permissions: Ensure BugBot has proper repository access
3. Verify installation: Make sure the GitHub app is installed and enabled for your repo

When reporting issues, include the request ID from verbose mode output for faster debugging.

​

FAQ