Crit
Reviewing agent output in a terminal is painful. You can't point at a specific line and say "change this." When your agent updates the file, you re-read the whole thing to figure out what changed.
Crit opens your file in a browser with GitHub-style inline comments. Leave feedback, hit Finish, and your agent is notified automatically. When the agent edits, Crit shows a diff between rounds - you see exactly what it addressed.
Works with Claude Code, Cursor, GitHub Copilot, Aider, Cline, Windsurf and any other agent.
Why Crit
- Browser UI, not terminal. A persistent tab with rendered markdown and visual diffs. No tmux, no TUI.
- Single binary, zero dependencies.
brew install and you're done. No Docker, no MCP.
- Round-to-round diffs. See exactly what your agent changed between iterations. Previous comments show as resolved or still open.
- Works with any agent. Not locked to one editor or AI provider.
Install
brew install tomasz-tomczyk/tap/crit
Also available via Go, Nix, or binary download.
Demo
A 5-minute walkthrough of plan review and branch review.
Usage
crit # auto-detect changed files in your repo
crit plan.md # review a specific file
crit plan.md api-spec.md # review multiple files
When you finish a review, Crit writes .crit.json - structured comment data your agent reads and acts on. Add it to your .gitignore:
echo '.crit.json' >> .gitignore
Features
File review
Pass specific files to review them directly: crit plan.md api-spec.md. Markdown files render as formatted documents with per-line commenting. Code files show as syntax-highlighted source. Both support the same inline comment workflow and multi-round iteration.
Git review
Run crit with no arguments. Crit auto-detects changed files in your repo and opens them as syntax-highlighted git diffs. A file tree on the left shows every file with its status (added, modified, deleted) and comment counts. Toggle between split and unified diff views.
Round-to-round diff
After your agent edits the file, Crit shows a split or unified diff of what changed - toggle it in the header.
Split view
Unified view
Inline comments: single lines and ranges
Click a line number to comment. Drag to select a range. Comments are rendered inline after their referenced lines, just like a GitHub PR review.
Suggestion mode
Select lines and use "Insert suggestion" to pre-fill the comment with the original text. Edit it to show exactly what the replacement should look like. Your agent gets a concrete before/after.
Finish review: agent notified automatically
When you click "Finish Review", Crit writes .crit.json and notifies your agent via crit listen. If your agent was listening, it picks up the prompt automatically — no copy-paste needed. A fallback "Copy prompt" button is available if the agent wasn't listening.
Programmatic comments
AI agents can use crit comment to add inline review comments without opening the browser UI or constructing JSON manually:
crit comment src/auth.go:42 'Missing null check'
crit comment src/handler.go:15-28 'Error handling issue'
crit comment --output /tmp/reviews src/auth.go:42 'comment' # custom output dir
crit comment --clear # remove .crit.json
Comments are appended to .crit.json - created automatically if it doesn't exist.
Mermaid diagrams
Architecture diagrams in fenced ```mermaid blocks render inline. You can comment on the diagram source just like any other block.
Share for Async Review
Want a second opinion before handing off to the agent? Click the Share button to upload your review and get a public URL anyone can open in a browser, no install needed. Each reviewer's comments are color-coded by author. Unpublish anytime.