claude-diff-review

claude-diff-review

Review Claude Code edits with per-hunk accept/reject instead of approving them one-by-one.

v0.8.1 — first stable release. Core review flow (interactive VS Code diff, terminal fallback, multi-round re-engagement, shadow baseline modes) is considered stable. See Known Issues for current limitations.

Claude Code's default flow interrupts you for every file edit. claude-diff-review flips the model: auto-approve edits, capture originals in the background, then open a native VS Code diff per file when Claude finishes. Accept what you like, reject individual hunks, restore what you don't — and if you reject anything, Claude is automatically re-engaged with the details.

---

Before & After

Before — Two edits tracked and ready for review:

After — VS Code opens the diff; user reverts a hunk, Claude is re-engaged:

---

How it works

You ask Claude to refactor something
         │
         ▼
┌─ PreToolUse hook ──────────────────┐
│  Copies original to shadow/        │
│  Returns "allow" → edit proceeds   │
│  (file scope: opens prev diffs)    │
└────────────────────────────────────┘
         │
         ▼  (Claude edits 1–N files)
         │
┌─ PostToolUse hook ─────────────────┐
│  Tracks: which files, edit count   │
│  Clears stale decisions on re-edit │
└────────────────────────────────────┘
         │
         ▼  (Claude finishes responding)
         │
┌─ Stop hook → lib/review.py ────────┐
│  interactive (default):            │
│    VS Code native diff per file    │
│    Per-hunk accept / reject        │
│    Rejections re-engage Claude     │
│  vscode: code --diff --wait        │
│  terminal: colored per-hunk y/n    │
│  summary: +/- counts only          │
└────────────────────────────────────┘
         │
         ▼
  All accepted → session ends
  Any rejected → Claude gets context
                 and iterates

---

Features

• Zero interruptions — edits auto-approved while originals are preserved
• Native VS Code diff — per-hunk accept/reject in VS Code's built-in diff editor (requires Claude Code extension)
• Terminal fallback — git add -p-style per-hunk y/n review when VS Code isn't connected
• Automatic re-engagement — rejections and user modifications are summarised and sent back to Claude
• Multi-round review — previously accepted files are excluded from subsequent rounds
• Shadow baseline modes — round (diff shows only new changes since last review) or session (diff shows all session changes)
• Full event log — every hook and review decision is logged; claude-diff log for real-time debugging
• Two review scopes — batch all diffs at end (session) or open progressively as Claude works (file)
• Fast-save guard — stray Ctrl+S within 2s of diff opening automatically reopens the diff
• Session isolation — concurrent Claude sessions don't interfere
• Binary-safe — binary files tracked but skipped from diffing
• Global pause/resume — claude-diff pause / claude-diff resume to bypass all hooks temporarily

---

Checking the plugin logs

Every hook and review decision is written to an append-only event log for the current session:

claude-diff log           # show last 50 events (color-coded by hook)
claude-diff log -n 100    # show more
claude-diff log -f        # follow in real time while Claude is running

If something looks wrong — a diff didn't open, a decision wasn't recorded, a fallback fired unexpectedly — start here. The log shows exactly what each hook saw and decided.

---

Installation

Via plugin marketplace (recommended)

claude plugin marketplace add https://github.com/Gorluxor/Claude-Code-Diff-Review

Then open /plugins inside Claude Code and install claude-diff-review. Restart Claude Code when prompted.

Test locally without installing

git clone https://github.com/Gorluxor/Claude-Code-Diff-Review.git
claude --plugin-dir ./Claude-Code-Diff-Review

Standalone install (no plugin system)

git clone https://github.com/Gorluxor/Claude-Code-Diff-Review.git
cd Claude-Code-Diff-Review
bash install.sh

Then restart Claude Code.

Manual standalone installation