difi/README.md
2026-01-30 15:32:49 -05:00

2.2 KiB
Raw Permalink Blame History

difi

A calm, focused way to review Git diffs.
Review code with clarity. Polish before you push.

difi demo

Why difi?

  • Blazing Fast — Built in Go. Starts instantly.
  • 🎨 Semantic UI — Split-pane layout with syntax highlighting and Nerd Font icons.
  • 🧠 Context Aware — Opens your editor (nvim/vim) at the exact line you are reviewing.
  • ⌨️ Vim Native — Navigate with h j k l. Zero mouse required.

Installation

Homebrew (macOS & Linux)

brew tap oug-t/difi
brew install difi

Installation

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

Contributing

  • PRs are welcome!
  • We use Bubble Tea for the TUI.
git clone https://github.com/oug-t/difi
cd difi
go run cmd/difi/main.go

Made with ❤️ by oug-t