revu

Interactive terminal diff reviewer. Annotate diffs, export reviews to Markdown.

Install

npm install -g @kud/revu-cli

Usage

# Review staged/unstaged changes in the current repo
revu

# Review a specific file
revu src/foo.ts

# Review all commits between a branch and HEAD (PR mode)
revu --against main

Keys

Key	Action
↑↓ / j k	Move cursor
shift+↑↓	Select range
↵	Annotate line / range
d	Delete annotation
] [	Next / prev hunk
c C	Next / prev annotation
n p	Next / prev file
{ }	Scroll annotation preview
←	Back to file tree
e	Export annotations to revu-review.md (prompts for an optional AI context header)
s	Settings (theme, view)
q	Quit

Files

File	Purpose
.revu.json	Autosaved annotations (JSON). Persists across sessions. Compatible with the revu VSCode extension. Do not edit manually.
revu-review.md	Markdown export for human and AI review. Generated by pressing e. Safe to delete after use.

Config

Press s inside revu to open settings. Changes are saved automatically to ~/.config/revu/settings.json (theme and view mode).