Review and refine Git diffs before you push

git diff shows changes. difi helps you review them.

• ⚡️ Instant — Built in Go. Launches immediately with no daemon or indexing.
• 🎨 Structured — A clean file tree and focused diffs for fast mental parsing.
• 🧠 Editor-Aware — Jump straight to the exact line in nvim/vim to fix issues.
• ⌨️ Keyboard-First — Navigate everything with h j k l. No mouse required.

(back to top)

brew install difi

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

Binary (pre-built):

pikaur -S difi-bin

Build from source:

pikaur -S difi

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

(back to top)

• Run difi in any Git repository against main:

cd my-project
difi

Piping & Alternative VCS

• You can also pass raw diffs directly into difi via standard input. This is perfect for patch files or other version control systems like Jujutsu:

# Review a saved patch file
cat changes.patch | difi

# Review changes in Jujutsu (jj)
jj diff --git | difi

# Pipe standard git diff output
git diff | difi

(back to top)

(back to top)

• The "Unix philosophy" approach: Uses the industry-standard Git wrapper to provide a robust, side-by-side editing experience.
• Side-by-Side Editing: Instantly opens a vertical split (:Gvdiffsplit!) against the index.
• Merge Conflicts: Automatically detects conflicts and opens a 3-way merge view for resolution.
• Config: Add the line below to if using lazy.nvim.

{
  "tpope/vim-fugitive",
  cmd = { "Gvdiffsplit", "Git" }, -- Add this line
}

Get the ultimate review experience with difi.nvim.

• Auto-Open: Instantly jumps to the file and line when you press e in the CLI.
• Visual Diff: Renders diffs inline with familiar green/red highlights—just like reviewing a PR on GitHub.
• Interactive Review: Restore a "deleted" line by simply removing the - marker. Discard an added line by deleting it entirely.
• Context Aware: Automatically syncs with your difi session target.

(back to top)

To use difi as a native git command (e.g., git difi), add it as an alias in your global git config:

git config --global alias.difi '!difi'

Now you can run it directly from git:

git difi

(back to top)

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

Contributions are especially welcome in:

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

(back to top)

(back to top)

Made with ❤️ by oug-t