difi/README.md

difi

A calm, focused way to review Git diffs.

Why difi?

• ⚡️ Instant startup — Built in Go, no background daemon.
• 🎨 Structured review — Tree view + side-by-side diffs.
• 🧠 Editor-aware — Jump to the exact line in nvim / vim.
• ⌨️ Keyboard-first — Designed for h j k l, no mouse.

Why not git diff?

• git diff is powerful, but it’s optimized for output — not review.
• difi is designed for the moment before you push or open a PR:

Installation

Homebrew (macOS & Linux)

brew tap oug-t/difi
brew install difi

Go Install

go install github.com/oug-t/difi/cmd/difi@latest

Manual (Linux / Windows)

• Download the binary from Releases and add it to your $PATH.

Workflow

• Run difi in any Git repository.
• By default, it compares your current branch against main.

cd my-project
difi

Controls

Key	Action
Tab	Toggle focus between File Tree and Diff View
j / k	Move cursor down / up
h / l	Focus Left (Tree) / Focus Right (Diff)
e / Enter	Edit file (opens editor at selected line)
?	Toggle help drawer
q	Quit

(back to top)

Contributing

git clone https://github.com/oug-t/difi
cd difi
go run cmd/difi/main.go

Contributions are especially welcome in:

• diff rendering edge cases
• UI polish and accessibility
• Windows support

(back to top)

Star History

(back to top)

---

Made with ❤️ by oug-t