feat: add codex-review plugin for automated code review v1.0.0

[vnz]

Summary

• Rewrite codex-review plugin v2.0.0 — restructured to match the proven coderabbit plugin architecture
• Separates concerns into command (execution), skill (reactive behavior), and agent (subagent delegation)
• The v1 monolithic command was brittle and hard for Claude to use; this fixes that

What changed from v1

Component	v1	v2
Command	codex-review.md (monolithic: review + fix loop + anti-loop)	review.md (clean execution wrapper with context injection)
Skill	review-workflow/SKILL.md (thin: just policy/severity)	code-review/SKILL.md (full review workflow with fix loop)
Agent	None	code-reviewer.md (specialized subagent for thorough analysis)

Plugin structure

plugins/codex-review/
├── .claude-plugin/
│   └── plugin.json
├── commands/
│   └── review.md              # /codex-review:review command
├── skills/
│   └── code-review/
│       └── SKILL.md           # When/how to review, fix-review workflow
├── agents/
│   └── code-reviewer.md       # Specialized review subagent
└── README.md

Design decisions

• Modeled on the official coderabbit plugin — adapted for Codex CLI (different flags, no auth flow, local-only fix loop)
• Reactive, not proactive — skill only triggers on user request, avoiding collision with coderabbit when both are installed
• --base passes refs as-is — no hardcoded origin/ prefix, supports multi-remote setups

Test plan

• prek run --all-files passes
• Plugin-validator confirms valid structure
• /codex-review:review command works (tested: auto-detected PR, ran review, found real bugs)
• CodeRabbit review clean
• Codex review findings fixed (committed mode fallback, origin/ hardcode)
• Agent can be spawned as subagent for thorough review

🤖 Generated with Claude Code

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request integrates a new codex-review plugin into the system, significantly enhancing the automated code review capabilities. The plugin streamlines the review process by offering intelligent mode detection and an iterative fix-and-review mechanism, which previously required manual configuration. This addition aims to improve developer efficiency and code quality by automating a critical part of the development workflow, while also optimizing resource usage by packaging procedural instructions into a portable unit.

Highlights

• New Plugin Added: Introduced the codex-review plugin, marking it as the first command-based plugin in the marketplace.
• Automated Code Review Command: Provided the /codex-review slash command, featuring auto-detection of review modes (--uncommitted, --base, or --commit) and an iterative fix-and-review loop.
• Review Workflow Skill: Included a review-workflow skill designed to guide decisions on when to review code and how to interpret findings, including P1/P2/P3 severity triage.
• Anti-Loop Safety Guards: Implemented three independent safety guards (max cycles, no progress, no changes) to prevent runaway review loops.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request introduces a new codex-review plugin for automated code reviews. The plugin is well-structured with a command, a skill, and clear documentation. The implementation thoughtfully includes an iterative fix-and-review loop with safety guards. My review has identified a significant dependency risk due to the use of a deprecated tool, and a minor inefficiency in the review loop's logic. Addressing these points will improve the plugin's long-term viability and performance.