GitHub - Ch00k/claude-review: Collaborate and iterate on documents with Claude Code

3 min read Original article ↗

codecov

claude-review

claude-review is a lightweight companion for working on documents with Claude Code. It lets you review a Markdown document in the browser, leave inline comments, and hand those comments back to the same Claude Code session that created the document.

claude-review interface showing inline comments on a Markdown document

Motivation

When working with Claude Code to generate documents in Markdown format, the typical workflow involves switching back and forth between reviewing the Markdown document and the Claude Code session. You read through the document, switch back to the Claude Code session, and manually describe which sections need changes - often copying and pasting text snippets to provide context.

claude-review streamlines this process by enabling inline comments directly in the browser, similar to Atlassian Confluence or Google Docs. You can highlight any portion of the rendered Markdown and add contextual feedback. The same Claude Code instance that generated the document can then fetch these comments, understand exactly what needs to change, and update the document automatically. Comments support threaded discussions - Claude Code can reply to your feedback to ask clarifying questions or confirm understanding before making changes. Since the browser view refreshes on file changes, you see your edits immediately without any manual intervention.

This keeps you in flow: the agent retains full context of the document it generated, your comments are precisely anchored to specific sections, threaded discussions enable back-and-forth clarification, and the feedback loop happens in seconds rather than minutes.

How it fits into your workflow

  1. Ask Claude Code to create a Markdown document (e.g. PLAN.md)
  2. Run /cr-review PLAN.md in Claude Code and open the URL it returns
  3. Highlight portions of the document and add contextual comments
  4. Run /cr-address PLAN.md in your Claude Code session
    • Claude Code will see all comment threads and their replies
    • It can discuss your feedback by replying to threads
    • It can make changes and resolve threads when complete
  5. Continue the discussion by adding replies to comment threads in the browser
  6. Repeat steps 4-5 until the document matches your intent

Requirements

  • Linux or macOS
  • Claude Code CLI
  • A modern web browser

Installation

Automated (recommended)

curl -fsSL https://github.com/Ch00k/claude-review/releases/latest/download/install.sh | bash

The installer will:

  • Download and install the claude-review binary to ~/.local/bin/
  • Install the /cr-review and /cr-address slash commands to ~/.claude/commands/

Manual

  1. Download the binary for your platform from the latest release
  2. Make it executable and move it to your PATH: 
    chmod +x claude-review-<os>-<arch>
mv claude-review-<os>-<arch> ~/.local/bin/claude-review
  3. Install the slash commands:

Make sure ~/.local/bin is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Uninstallation

To completely remove claude-review from your system:

  1. Stop the daemon if it's running:

    claude-review server --stop

  2. Uninstall the slash commands:

  3. Remove the binary:

    rm ~/.local/bin/claude-review

  4. (Optional) Remove the data directory (contains comments database, PID file, and logs):

    rm -rf ~/.local/share/claude-review

Architecture

For a detailed overview of the architecture, see ARCHITECTURE.