Claude Review

Local code review workflow for AI-assisted development. Track, review, and manage file changes like a PR review — entirely within VS Code.

Features

• File-level review tracking — Mark changed files as "viewed", just like GitHub PR reviews
• Automatic change detection — Files are automatically marked as "outdated" when their diff changes after you've reviewed them
• Staged/Unstaged grouping — Files are organized by git staging area with independent review state per area
• Progress tracking — See review progress at a glance in the tree view header
• Stage reviewed files — Stage individual files or batch-stage all reviewed files directly from the review panel
• Diff viewing — Open the VS Code diff editor for any changed file with a single click
• File decorations — Reviewed and outdated files are badged in the Explorer
• Persistent state — Review state survives VS Code restarts via workspace storage

Commands

All commands are available from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) with the Claude Review: prefix.

How It Works

Claude Review tracks a simple three-state lifecycle for each changed file:

┌─────────────┐     review      ┌──────────┐
│ unreviewed  │ ──────────────► │  viewed   │
│   ○         │                 │    ✓      │
└─────────────┘                 └──────────┘
                                     │
                                     │ diff changes
                                     ▼
                                ┌──────────┐
                                │ outdated  │
                                │    ⚠      │
                                └──────────┘

1. Unreviewed — A new or unreviewed changed file
2. Viewed — You've reviewed the file's diff. The extension records a SHA-256 hash of the diff content.
3. Outdated — The file changed since you last reviewed it (the diff hash no longer matches)

Files can exist independently in both the staged and unstaged areas. Staging or unstaging a file from the review panel moves it between groups while preserving its review state.

Requirements

• VS Code 1.85 or later
• Git — The workspace must contain a git repository
• vscode.git — The built-in Git extension must be enabled (it is by default)

Privacy

Claude Review is fully local and privacy-respecting:

• No data collection — The extension collects no telemetry, analytics, or usage data
• No network access — The extension makes zero HTTP requests. All data stays on your machine.
• No webviews — No HTML content is rendered, eliminating XSS risks
• Zero production dependencies — The published extension contains only its own bundled code
• Local storage only — Review state is stored in VS Code's workspace state, which lives in your local VS Code profile

License

MIT