yuuichieguchi

Claude Plan Reviewer — AI skill for Claude Code

AI community

Automatically review Claude Code plans using external AI CLIs.

How to install Claude Plan Reviewer

This entry records only its repository, not the path inside it, so there is no exact command to give. Open yuuichieguchi/claude-plan-reviewer and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Plan Reviewer does

Automatically review Claude Code plans using external AI CLIs.

Alternatives in AI

Flow Deliver — Multi-AI validation, scoring, and review using Codex and Gemini CLIs (Double Diamond Deliver phase) 2.8k ★
Pilotfish — Multi-model orchestration layer for Claude Code — the frontier model plans, cheaper models execute, verificati 688 ★
Claudish CLI — for external AI models) 679 ★

README

claude-plan-reviewer

Automatically review Claude Code plans using external AI CLIs (Codex, Gemini CLI). Uses Claude Code's `PreToolUse` hook to intercept `ExitPlanMode`, send the plan for external review, and inject feedback back into Claude's context.

How It Works

Claude writes a plan and calls ExitPlanMode
  → PreToolUse hook fires → hook runs
  → Finds the latest plan file from ~/.claude/plans/
  → Runs review via Codex / Gemini CLI
  → If LGTM → permissionDecision:"allow" → Claude exits plan mode
  → If not  → permissionDecision:"deny" + review feedback
            → Claude revises the plan → calls ExitPlanMode again
  → After maxReviews reached → allow without review

**Note:** Due to a Claude Code limitation, the review result is only displayed in the chat when the reviewer returns feedback (deny). When the reviewer returns LGTM (allow), the review result is streamed to stderr but not shown in the chat UI.

Install

npm install -g claude-plan-reviewer

Setup

claude-plan-reviewer setup

**Note:** The hook takes effect in Claude Code sessions started after setup. Already-running sessions are not affected.

Teardown

claude-plan-reviewer teardown

Uninstall

npm uninstall -g claude-plan-reviewer

Configuration

# Show current config
claude-plan-reviewer config show

# Change adapter (codex | gemini)
claude-plan-reviewer config set adapter gemini

# Change max reviews per session
claude-plan-reviewer config set maxReviews 3

# Set Codex model
claude-plan-reviewer config set codex.model o3

# Set Gemini model
claude-plan-reviewer config set gemini.model gemini-2.5-pro

Config File

`~/.claude-plan-reviewer.json`

{
  "adapter": "codex",
  "maxReviews": 2,
  "prompt": "",
  "codex": {
    "model": "",
    "sandbox": "read-only"
  },
  "gemini": {
    "model": ""
  }
}