Multi Agent Review — AI skill for Claude Code

multi-agent-review

Automated PR reviews by Claude Code for commits made by Codex and other AI agents. Like CodeRabbit, but for agent-to-agent code review.

**Flow:** Codex writes code → pushes a PR → Claude Code reviews it → posts a structured GitHub PR review with inline comments.

Quick Start

npm install -g multi-agent-review

cd your-project
mar init

# Reviews happen automatically when Codex finishes a turn.
# Or run manually:
mar review codex/my-feature

Prerequisites

• Node.js >= 20
• Claude Code CLI (claude command)
• GitHub CLI (gh command, authenticated)
• Codex CLI (optional, for automatic reviews)

How It Works

1. **`mar init`** sets up your project:

   • Creates .mar/config.json with detected repo and branch defaults
   • Adds a notify hook to ~/.codex/config.toml so Codex triggers reviews automatically
   • Adds .mar/ to .gitignore

2. **When Codex finishes a turn**, the notify handler checks:

   • Is the branch a codex/* branch? (configurable pattern)
   • Are there new commits since the last review?
   • Is there an open PR for this branch?
   • If all yes: spawns a background review

3. **The review** runs `claude -p` with a structured review prompt:

   • Reads the cumulative diff against the base branch
   • Analyzes for security issues, bugs, performance problems, convention violations
   • Returns structured JSON with findings

4. **Posts to GitHub** as a proper PR review:

   • Summary with verdict and collapsible file walkthrough
   • Inline comments on specific diff lines with severity badges
   • Uses COMMENT event (advisory only, never blocks merges)
   • Updates existing review instead of posting duplicates

GitHub Action

Add Claude reviews to any repo without installing the CLI:

# .github/workflows/review.yml
name: Claude Review
on: pull_request

jobs:
  review:
    runs-on: