codereviewbuddy 0.3.0

codereview buddy helps your AI agent interact with AI code review--smoothly!

codereviewbuddy

An MCP server that helps your AI coding agent interact with AI code reviewers — smoothly.

Manages review comments from Unblocked, Devin, and CodeRabbit on GitHub PRs with staleness detection, batch resolution, and re-review triggering.

Features

• List review comments with reviewer identification and staleness detection
• Resolve comments individually or bulk-resolve stale ones (files changed since review)
• Reply to review threads directly from your agent
• Request re-reviews with per-reviewer logic (manual trigger for Unblocked, auto for Devin/CodeRabbit)
• Zero config auth — uses gh CLI, no PAT tokens or .env files

Prerequisites

• GitHub CLI (gh) installed and authenticated (gh auth login)
• Python 3.14+

MCP Client Configuration

Windsurf

Add to your MCP settings (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "codereviewbuddy": {
      "command": "uvx",
      "args": ["codereviewbuddy"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "codereviewbuddy": {
      "command": "uvx",
      "args": ["codereviewbuddy"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "codereviewbuddy": {
      "command": "uvx",
      "args": ["codereviewbuddy"]
    }
  }
}

From source (development)

{
  "mcpServers": {
    "codereviewbuddy": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/codereviewbuddy", "codereviewbuddy"]
    }
  }
}

MCP Tools

Tool	Description
list_review_comments	Fetch all review threads with reviewer ID, status, and staleness
resolve_comment	Resolve a single thread by GraphQL node ID (PRRT_...)
resolve_stale_comments	Bulk-resolve threads on files modified since the review
reply_to_comment	Reply to a review thread
request_rereview	Trigger re-reviews per reviewer (handles differences automatically)

Installation

pip install codereviewbuddy

With uv:

uv tool install codereviewbuddy

Development

git clone https://github.com/detailobsessed/codereviewbuddy.git
cd codereviewbuddy
uv sync

Testing

poe test          # Run tests (excludes slow)
poe test-cov      # Run with coverage report
poe test-all      # Run all tests including slow

Quality checks

poe lint          # ruff check
poe typecheck     # ty check
poe check         # lint + typecheck
poe prek          # run all pre-commit hooks

Template Updates

This project was generated with copier-uv-bleeding. To pull the latest template changes:

copier update --trust .