open-code-review  by spencermarx

AI-powered multi-agent code review system

Created 5 months ago
297 stars

Top 89.2% on SourcePulse

GitHubView on GitHub
Project Summary

Open Code Review (OCR) addresses the limitations of single-perspective AI code reviews by simulating a customizable team of AI agents that engage in discourse before synthesizing feedback. This approach provides developers with more comprehensive, nuanced, and actionable insights, aiming to augment human review processes by catching issues earlier and focusing human attention on complex, non-automatable problems.

How It Works

OCR employs an 8-phase workflow orchestrated by a Tech Lead agent. Code is analyzed, and then multiple reviewer agents, each with distinct personas and focus areas, examine it independently. Crucially, these agents then engage in a structured "Discourse" phase, debating findings through agreement, challenges, and connections. This collaborative debate precedes a final "Synthesis" phase, producing a unified, prioritized feedback report that leverages the collective intelligence and diverse perspectives of the simulated team.

Quick Start & Requirements

  • Primary Install: Install the CLI globally via npm: npm install -g @open-code-review/cli.
  • Prerequisites: Node.js >= 22.5.0, Git, and a supported AI coding assistant (e.g., Claude Code, Cursor, Windsurf). GitHub CLI (gh) is optional for PR posting.
  • Setup: Run ocr init in your project directory to detect and configure AI tools. Launch the dashboard with ocr dashboard or use AI assistant slash commands (e.g., /ocr:review).
  • Links: GitHub Repository, CLI Package.

Highlighted Details

  • Multi-Agent Discourse: Simulates team dynamics where reviewers debate findings, leading to more robust issue identification and validation.
  • Customizable Teams: Offers 28 reviewer personas, including industry legends like Martin Fowler and Kent Beck, with options for custom persistent or ephemeral reviewers.
  • Requirements-Aware Review: Evaluates code against explicit specifications, proposals, or tickets, generating a verification table in the synthesis.
  • Code Review Maps: Generates structured navigation documents for large changesets, identifying key files and dependencies with Mermaid graphs.
  • GitHub Integration: Posts synthesized reviews or AI-translated human-voice feedback directly to GitHub PRs.
  • Context Discovery: Automatically learns project standards from files like CLAUDE.md and .cursorrules.

Maintenance & Community

The provided README focuses on technical features and usage, with no specific details on maintainer activity, community channels (like Discord/Slack), or sponsorship information.

Licensing & Compatibility

The project is licensed under the Apache-2.0 license. This license is generally permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

This tool is explicitly designed to augment, not replace, human code review. Its primary function is to reduce the burden on human reviewers by identifying issues earlier, allowing humans to focus on more complex or nuanced aspects that machines cannot fully grasp. It requires Node.js version 22.5 or higher.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
8
Issues (30d)
0
Star History
58 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.