Claude Code Plan Review Plugin

English | 中文

A Claude Code plugin that provides human review capability for Plan Mode. The plugin intercepts ExitPlanMode calls via hooks and opens a browser-based review interface where users can annotate and provide feedback on Claude-generated plans.

Features

• ExitPlanMode Interception: Automatically intercepts plan submissions for human review
• Inline Comments: Attach comments to specific text selections (like GitLab MR review)
• Batch Review: Create multiple draft comments before submitting
• Version History: Track plan revisions with diff comparison
• Real-time Updates: SSE-based live updates in the browser

Installation

Via Claude Code CLI

# Add GitHub marketplace
claude plugin marketplace add zhcsyncer/cc-plan-review

# Install the plugin
claude plugin install cc-plan-review@cc-collab-plugins

Via Claude Code Interactive

/plugin marketplace add zhcsyncer/cc-plan-review
/plugin install cc-plan-review@cc-collab-plugins

Or simply use /plugin and follow the interactive prompts.

Update Plugin

Step 1: Update marketplace

claude plugin marketplace update

Step 2: Update the plugin via Claude Code

1. Enter /plugin command
2. Select 2. Manage and uninstall plugins
3. Press Enter on the cc-plan-review plugin
4. Press Enter again
5. Select Update now

From Source (Development)

git clone https://github.com/zhcsyncer/cc-plan-review.git
cd cc-plan-review
pnpm install && pnpm build
claude plugin add ./cc-plan-review

How It Works

The plugin consists of two components working together:

1. Hooks (PreToolUse)

Intercepts ExitPlanMode calls and triggers the review workflow:

ExitPlanMode called → Hook intercepts → Opens browser → User reviews → Returns approve/block

2. MCP Server

Provides tools and resources for the review workflow:

Tools:

• ask_questions: Agent asks clarifying questions or acknowledges user comments

Resources:

• review://project/{projectPath}/pending: Get all pending reviews for a specific project
• review://project/{projectPath}/current: Get the most recent pending review
• review://{id}: Get specific review details by ID

Review Status Flow

stateDiagram-v2
    [*] --> open: Create Review
    open --> approved: Approve directly (no comments)
    open --> changes_requested: User submits comments

    changes_requested --> discussing: Agent asks questions
    changes_requested --> updated: Agent submits revision

    discussing --> updated: User answers, Agent updates
    discussing --> approved: Issues resolved, User approves

    updated --> changes_requested: User adds more comments
    updated --> approved: User approves revision

    approved --> [*]

Loading

Known Limitations

Post-Approval Mode Switching

When the user approves a plan in the review interface, the plugin returns an "approve" decision to Claude Code. However, there is a known limitation:

Issue: After the hook returns approve, Claude Code does not automatically switch from Plan Mode to Accept Edits Mode.

Workaround: After approving a plan, users have two options:

1. Wait for prompt: Wait for Claude Code to show the "Accept Edits" prompt in terminal, then confirm
2. Manual switch: Press Shift+Tab to switch to Accept Edits mode manually

This is a limitation of the Claude Code hooks system, which can only approve/block tool calls but cannot trigger mode switches automatically.

Hook Timeout (10 Minutes)

The Claude Code hooks system has a 10-minute timeout for PreToolUse hooks. If the review process takes longer than 10 minutes:

Behavior:

• The hook will timeout and Claude Code treats it as a rejection (block)
• Claude will receive an error indicating the hook timed out
• The review session remains open in the browser but becomes disconnected

Recommendation:

• Complete your review within 10 minutes
• For complex plans, consider leaving quick comments first and then using the discussion feature for detailed feedback

Data Persistence

Review data is stored in the following directory:

~/.cc-plan-review/reviews/

Each review session is saved as a JSON file with the review ID as the filename.

Tech Stack

• Frontend: Vue 3, Rsbuild, TailwindCSS
• Backend: Node.js, Express 5, MCP SDK

Development

pnpm install        # Install dependencies
pnpm dev            # Watch mode
pnpm build          # Full build (server + scripts + client)
pnpm start          # Start server