Claude Review Loop

review-loop

A Claude Code plugin that adds an automated code review loop to your workflow.

What it does

When you use `/review-loop`, the plugin creates a two-phase lifecycle:

1. Task phase: You describe a task, Claude implements it
2. Review phase: When Claude finishes, the stop hook prepares a Codex runner script and blocks exit. Claude then runs Codex directly (with output streaming to the user) and addresses the review feedback.

The result: every task gets an independent second opinion before you accept the changes, and you can watch the review happen in real time.

Review coverage

The plugin spawns up to 4 parallel Codex sub-agents, depending on project type:

Agent	Always runs?	Focus
Diff Review	Yes	git diff — code quality, test coverage, security (OWASP top 10)
Holistic Review	Yes	Project structure, documentation, AGENTS.md, agent harness, architecture
Next.js Review	If next.config.* or "next" in package.json	App Router, Server Components, caching, Server Actions, React performance
UX Review	If app/, pages/, public/, or index.html exists	Browser E2E via agent-browser, accessibility, responsive design

After all agents finish, Codex deduplicates findings and writes a single consolidated review to `reviews/review-.md`.

Requirements

• Claude Code (CLI)
• jq — brew install jq (macOS) / apt install jq (Linux)
• Codex CLI — npm install -g @openai/codex

Codex multi-agent

This plugin uses Codex [multi-agent](https://developers.openai.com/codex/multi-agent/) to run parallel review agents. The `/review-loop` command automatically enables it in `~/.codex/config.toml` on first use.

To set it up manually instead:

# ~/.codex/config.toml
[features]
multi_agent = true

Installation

...