revise

README

revise

A terminal UI for reviewing local git changes and sending feedback to Claude Code.

revise gives you a split-pane interface for browsing git diffs in the terminal — file list on the left, diff on the right. Add inline comments, stage or discard individual hunks, and cycle between branch, staged, and unstaged views. It's designed for reviewing your own changes before committing or sharing them with an AI assistant.

Installation

Homebrew

brew install justincampbell/tap/revise

Go

go install github.com/justincampbell/revise@latest

Binary releases

Download a prebuilt binary from the GitHub Releases page.

Usage

Run from within a git repository:

revise

• On a feature branch, revise shows all changes compared to the merge base (as if opening a PR).
• On the default branch, it shows staged, unstaged, and untracked changes.

Diff Modes

Cycle through modes with Tab / Shift+Tab:

Mode	What it shows
Branch	Committed + staged + unstaged + untracked (broadest; default on feature branches)
Staged	Staged + unstaged + untracked
Unstaged	Unstaged + untracked only (narrowest)

File Review

Review any file with comments:

revise <file>
revise --output comments.md <file>

Opens the file in a read-only review mode — all lines shown as context, git-specific keys disabled. Add comments, then quit — comments are printed to stdout on exit. Use --output <file> to write comments to a file instead.

Comments are also output on exit in normal git diff mode.

Subcommands

Command	Description
revise <file>	Review a file with comments
revise setup-cache	Enable git's core.untrackedCache for faster refreshes
revise styles	Show file status color matrix for all staging states
revise update [--pre]	Update to the latest version

Features

• Diff review -- split-pane file list and diff viewer with color-coded diffs
• Inline comments -- add comments on any diff line, export for AI feedback
• Hunk staging -- stage, unstage, or discard individual hunks or entire files
• File status colors -- status indicators change color based on staging state (dim=branch, yellow=unstaged, green=staged, cyan=partial)
• Mouse support -- click to select files, scroll to navigate
• NO_COLOR -- respects the NO_COLOR environment variable

Key Bindings

Press ? inside revise to see the help overlay.

General

Key	Action
← (h)	Focus file list
→ (l)	Focus diff view
n / N	Next / prev file
Tab / Shift+Tab	Cycle diff mode
f	Toggle fullscreen diff
Esc	Back to file list
?	Toggle help
q	Quit

File List

Key	Action
j / k, ↑ / ↓	Navigate files
Enter	Select file and focus diff
s	Stage file
u	Unstage file
D	Discard file

Diff View

Key	Action
j / k, ↑ / ↓	Move cursor
} / { (] / [)	Next / prev hunk
+ / -	More / fewer context lines
w	Toggle hide whitespace
g / G	Top / bottom
Fn+↓ / Fn+↑	Page down / up
Enter / c	Add/edit comment on line
d	Delete comment on line
s / S	Stage hunk / file
u / U	Unstage hunk / file
D	Discard hunk

Global

Key	Action
e	Export comments to clipboard
!	Report issue on GitHub

Inspiration

• difit -- browser-based local diff viewer with comment/copy-prompt features
• gitui -- fast terminal UI for git

License

MIT