scrutiny

Scrutiny

Native plan editor for Claude Code with side-by-side diffs and inline commenting.

Review and refine AI-generated plans with a polished editing experience. Built with Tauri and Rust for native performance.

![Screenshot placeholder]

---

What is Scrutiny?

Scrutiny transforms how you review Claude Code plans. Instead of approving plans in a cramped terminal, you get:

• ✅ Side-by-side diff view — Original plan vs your edits
• ✅ Inline comments — Click any line to add feedback
• ✅ Full editing — CodeMirror editor with syntax highlighting
• ✅ Real-time diff — Changes highlight as you type
• ✅ Native performance — Rust backend, ~8MB binary, 200ms startup
• ✅ Dark theme — Matches VS Code aesthetic

---

Installation

Download Pre-built Binary

Coming soon: Download from Releases

• macOS: Download Scrutiny-macos.dmg
• Linux: Download scrutiny-linux
• Windows: Download scrutiny-windows.exe

Install Claude Plugin

# Clone repository
git clone https://github.com/jackmarketon/scrutiny.git
cd scrutiny

# Install plugin
claude plugins add $(pwd)/claude-plugin

Verify

# Check plugin is installed
claude plugins list | grep scrutiny

# Test the app (macOS example)
open /Applications/Scrutiny.app

---

Usage

When Claude presents a plan:

Scrutiny launches automatically in a native window.

Workflow:

1. Review side-by-side

   • Left pane: Original plan (reference)
   • Right pane: Your edits (fully editable)

2. Make changes (choose one or both):

   • Add inline comments: Click "💬 Add Comment" → Select line → Type feedback
   • Edit directly: Click in right pane → Edit like code → See diff highlight

3. Submit feedback:

   • Approve & Send: Sends your changes + comments to Claude
   • Cancel: Closes without saving

Example

Original plan:

## Step 1: Update database
## Step 2: Deploy to production

Your edits:

## Step 1: Update database with migration script
## Step 2: Test in staging environment
## Step 3: Deploy to production with feature flag

Comments:

• Line 1: "Need rollback strategy for migration"
• Line 3: "How long should we test in staging?"

Claude responds:

Thanks for the feedback! I've updated the plan:

1. Rollback strategy: Using reversible migrations with down.sql scripts
2. Staging duration: Recommend 24-48h with production traffic replay

Does this address your concerns?

---

Features

Feature	Description
Side-by-side diff	Original vs edited, real-time highlighting
Inline comments	Click any line to add context-specific feedback
Full editing	CodeMirror 6 editor with markdown syntax highlighting
Native performance	Rust backend, 200-300ms startup, ~80MB memory
Dark theme	Matches VS Code aesthetic out of the box
Cross-platform	macOS, Linux, Windows

---

Tech Stack

• Backend: Tauri 2.0 (Rust), similar (diff library)
• Frontend: React, TypeScript, CodeMirror 6, Vite
• Bundle size: ~8MB (vs Electron's 100MB+)
• Performance: 200-300ms startup, <10ms diff computation

---

Troubleshooting

App doesn't launch from Claude

Check plugin is installed:

claude plugins list | grep scrutiny

Re-install plugin:

cd scrutiny
claude plugins add $(pwd)/claude-plugin

Comments not showing up

Check feedback file exists:

ls -la /tmp/claude-plans/*.feedback.json

App crashes on startup

Enable debug logging:

# macOS/Linux
RUST_LOG=debug /path/to/scrutiny /tmp/test.md

# Windows
set RUST_LOG=debug
scrutiny.exe C:\Temp\test.md

Can't find binary

Download location:

• macOS: Applications folder or Downloads
• Linux: ~/Downloads/scrutiny (make executable: chmod +x)
• Windows: Downloads folder

---

Development

Want to build from source or contribute? See DEVELOPMENT.md for full details.

Quick: Test Plugin Locally

To test the plugin without installing it globally:

# Run Claude Code with local plugin directory
claude --plugin-dir ${PWD}/claude-plugin

This loads the plugin from your checkout instead of ~/.config/claude/plugins, useful for testing changes.

Prerequisites

1. Rust — Install from https://rustup.rs

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. Node.js — v18+ with npm

3. System dependencies (Linux only):

   # Ubuntu/Debian
   sudo apt install libwebkit2gtk-4.1-dev \
     build-essential \
     curl \
     wget \
     libssl-dev \
     libgtk-3-dev \
     libayatana-appindicator3-dev \
     librsvg2-dev