Skip to content
Projects

amalucelli/dffy has 31 GitHub stars and 2 forks. GitHot measured +9 stars in 24 hours. Last checked 2026-11-18 17:48 UTC. Last push 2026-11-18.

How these counts are measured

31 stars2 Forks +9 in 24h

What you can do

  • ⚡ Opens the Linux v6.0..v6.1 diff in less than 10ms and loads the rest in the background.
  • 👀 --watch repaints as you edit, stage and commit.
  • 🪟 Split or unified, picked by terminal width.
  • 🌈 Syntax highlighting for 30 languages, with changed words emphasized.

Measured star growth

in 24h
+9
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

A fast terminal diff viewer for git, built for large repositories, written in Rust

Developer Tools

README.md

Original

dffy

dffy

A terminal diff viewer for git, written in Rust.

Built for large repositories, up to the size of the Linux kernel.

dffy                   # everything you haven't committed
dffy main..HEAD        # any revision git understands

dffy reviewing the Linux v6.0..v6.1 diff

Install

brew install --cask amalucelli/tap/dffy
# or
curl -fsSL https://raw.githubusercontent.com/amalucelli/dffy/main/install.sh | sh
# plus the experimental renderers: … | sh -s -- --plugin markdown --plugin mermaid

Then try it in any repository: dffy HEAD~10.

About

dffy is a diff viewer for the terminal. Run it in a git repository and it opens a full-screen view of your changes: a file tree on the left, the diff on the right, split or unified. Pipe it, and it prints the diff instead.

It's built for big diffs. Instead of computing the whole diff up front, dffy shows the first files as soon as it finds them and works on the rest in the background, so a 13,000-file change opens as fast as a one-line fix.

It fits into how you already work. Every action is a single key, the layout adapts from a wide monitor down to a phone over SSH, and dffy can stand in for git's pager, git add -p filter and difftool. Settings live in a plain config file you can keep with your dotfiles.

Why dffy

dffy builds on tools I like: the terminal review flow of lumen, the review UX of hunk, and the rendering of diffs.com (Pierre's @pierre/diffs). None of them fit how I work. lumen centers on AI features I didn't want in a diff viewer. hunk is TypeScript on a JavaScript runtime, and I wanted a single native binary that stays fast on huge repos. diffs.com runs in the browser. So I built a native terminal diff viewer that works the same on a laptop and over SSH from a phone.

Features

Fast

Reading diffs

Navigation

Git

Anywhere

Scripts and agents

  • 🧱 --json: the diff as JSON Lines, with each line's kind and whether it moved or was only reformatted.
  • 🤖 dffy mcp: an MCP server that lets coding agents list a change's files and read its diffs a page at a time.

Usage

dffy                        # staged, unstaged and untracked changes
dffy --staged               # what's staged (git diff --cached)
dffy HEAD~3                 # a revision against the working tree
dffy main...feature         # changes since the merge base
dffy show HEAD              # a commit with its message
dffy main.. -- src/         # limited to paths
dffy a.txt b.txt            # two files or folders, no repository needed
dffy --watch                # refresh on every change
dffy --syntax v6.0 v6.1     # diff by syntax
dffy --stat main..          # also --name-only, --name-status, --exit-code
dffy --json main..          # JSON Lines for scripts and agents
dffy mcp                    # an MCP server for coding agents

With git:

git config --global core.pager dffy
git config --global interactive.diffFilter "dffy --color-only"

In the viewer, n/N move between changes, f/F between files, / searches, o finds a file, space lists commands and q quits. ~/.config/dffy/config holds key = value lines; dffy config --default lists every key with its default.

Comparison

dffy hunk lumen difftastic delta diff-so-fancy diff
Interactive viewer with a file tree ✅ ✅ ✅ ❌ ❌ ❌ ❌
Watch mode ✅ ✅ ✅ ❌ ❌ ❌ ❌
git's pager (reads a diff on stdin) ✅ ✅ ❌ ❌ ✅ ✅ ❌
git add -p filter ✅ ❌ ❌ ❌ ✅ ✅ ❌
Syntax highlighting ✅ ✅ ✅ ✅ ✅ ❌ ❌
Changed-word emphasis ✅ ✅ ✅ ✅ ✅ 🟡 ❌
Syntax-aware diff ✅ ❌ ❌ ✅ ❌ ❌ ❌
Split and unified, picked by width ✅ ✅ ❌ 🟡 🟡 ❌ 🟡
Mouse ✅ ✅ ✅ ❌ ❌ ❌ ❌
Compares files outside a repository ✅ 🟡 ❌ ✅ ✅ 🟡 ✅
Plugins or extensions 🟡 🟡 ❌ ❌ ❌ ❌ ❌
Single native binary ✅ 🟡 ✅ ✅ ✅ ❌ ✅
AI or agent annotations ❌ ✅ 🟡 ❌ ❌ ❌ ❌
Other VCSs (Jujutsu, Mercurial, Sapling) ❌ ✅ ✅ ✅ ✅ 🟡 —

🟡 means partial support. All seven are open source. GNU diff is GPL-3.0-or-later and the rest are MIT. Checked against hunk 0.25.0, lumen 2.32.0, difftastic 0.72.0, delta 0.20.1, diff-so-fancy 1.4.14 and GNU diffutils 3.10, with a source for every cell.

Benchmarks

Opening Linux v6.0..v6.1 (13,168 changed files, a 48MB patch) in a viewer, time until the first changed line is on screen:

dffy lumen 2.32.0 hunk 0.25.0
The v6.0..v6.1 range 8.1ms 12.5s 18.1s
The working tree (5 files changed) 77ms 1.11s 733ms
As a pager, git diff v6.0 v6.1 | … 210ms n/a 15.2s
Memory, opening the range 99MB 676MB 4.39GB

As git's pager, dffy streams the whole 48MB patch in 3.1MB of its own memory, about as fast as plain git diff.

Architecture

dffy is written in Rust.

Docs

The documentation covers every key, flag and setting: installation, usage, the viewer, keys, configuration, themes, git integration, watch mode, renderer plugins, JSON output, the MCP server, troubleshooting, architecture and benchmarks.

License

MIT