delta-review

Review Claude Code plans block by block in your browser — and only re-review what actually changed.

A Claude Code skill that turns plan markdown files into an interactive review page. Send feedback per block, watch Claude incorporate it live, and approve the plan when you're happy. Read once, stays read: after a revision, only changed or new blocks come back for review.

Deutsche Version →

Why

Claude Code loves handing you long plan.md files to review. Reading walls of raw markdown is painful, chat feedback like "in section 3, second bullet…" is worse, and after a revision you have to re-read everything to find what changed. delta-review fixes all three.

Features

• 🧩 Block-by-block review — every H1–H3 section becomes a card with its own read-toggle and feedback field
• ⚡ Live feedback loop — a local server delivers each comment straight to Claude; it's incorporated immediately and the page refreshes itself
• 🔁 Delta tracking — blocks are tracked by content hash; after a revision only changed/new blocks return as unread
• ✅ Explicit approval — the review ends when you approve the plan, not when Claude thinks it's done; tab and server clean themselves up
• 📊 Process diagrams — ```mermaid blocks render as flowcharts right inside the plan
• 🌗 Dark by default — theme toggle included, preference remembered
• 🪶 Zero dependencies — one Python 3 stdlib script, no npm, no pip

How it works

sequenceDiagram
    participant You as You (browser)
    participant Server as Local review server
    participant Claude as Claude Code

    Claude->>Server: serve plan.md
    Server->>You: opens review page
    You->>Server: 📨 comment on block "Step 2"
    Server->>Claude: wait returns the event
    Claude->>Claude: edits plan.md
    Server-->>You: page auto-reloads — block shows as "changed"
    You->>Server: ✅ approve plan
    Server->>Claude: approved — server shuts down

Loading

Every block is hashed over its content. Read marks are stored per hash in a small state file next to the plan — so when Claude edits a block, its hash changes and it automatically returns as changed / unread, while everything you already read stays green.

Install

Requires Claude Code and Python 3 (macOS/Linux ship it).

# 1. Clone wherever you keep tools
git clone https://github.com/Tim1990/delta-review.git

# 2. Link it into your personal skills folder
ln -sfn "$(pwd)/delta-review" ~/.claude/skills/delta-review

That's it — the skill is now available in every Claude Code project. Because it's a symlink, updating is just:

git -C delta-review pull

To install for a single project only, link into <project>/.claude/skills/ instead.

Use

In any Claude Code session:

review the plan with delta-review

Claude starts the local server, your browser opens, and the ping-pong begins:

1. Read blocks, mark them as read, type feedback into any block and hit Send
2. Claude incorporates it immediately — the page refreshes and the block comes back as changed
3. When everything is green, click Approve plan — done

Works in English and German (--lang en|de — Claude picks the language you're chatting in). If you prefer no server, there's a copy-paste fallback (generate) where feedback travels via clipboard.

See SKILL.md for the full workflow Claude follows, and scripts/plan_review.py --help for the CLI.

License

MIT

---

🤖 Built with Claude Code