Stop Diffing Text, Start Diffing Logic.
Note
Diffmantic is under active development and not yet ready for public use. We're getting closer to a public release, but features and internals are still shifting quickly.
Line-based diffs like git diff break down when you refactor code. Move a function down 50 lines, and git shows it as a full Delete and re-add. Rename a parameter, and entire lines light up red and green.
Now with AI tools generating massive PRs with Moved functions and renamed symbols everywhere, the actual Change gets buried in noise. So human reviewers end up just giving in.
diffmantic fixes this by parsing your code into ASTs using Tree-sitter. It tracks structural shifts, so it knows when a function was Moved instead of deleted, and shows exact inline node edits instead of lighting up entire lines.
It works as a standalone CLI, a drop-in for git diff, or a backend for editor plugins via JSON output.
- Move Detection. When you move a function or a block, diffmantic tracks it as a Move. Not a delete + re-add. Moved functions, blocks, and statements are all first-class.
- Update & Rename Detection. Shows exactly what changed inside a syntax node. A variable rename, a string literal swap, a type change, you see the precise edit, not a wall of red and green.
- Git Integration. Run
diffmin any Git repo to stream a pager-backed diff of unstaged changes, staged changes with--cached, or any two revisions. - Inline Diff. Static inline view with syntax highlighting and a 16-color ANSI palette, no special terminal setup needed. Long lines wrap to terminal width with
--wrap, and-pprints agit applycompatible patch. - JSON Output. Stable schema with AST actions, line alignment, and character-level highlight spans. Includes selective
--uiand--fullmodes for editor plugins and frontends. - 16 Core Languages. Go, Java, JavaScript, TypeScript, Python, Rust, Zig, C, C++, PHP, Ruby, JSON, YAML, TOML, HTML, CSS, Lua. Full AST normalization and matching rules powered by Tree-sitter.
- Line Diff Fallback. For unsupported file types or plain text files, Diffmantic automatically falls back to line-based diffing so you can diff any file.
| Language | Extensions |
|---|---|
| Go | .go |
| Java | .java |
| JavaScript | .js .jsx .mjs .cjs |
| TypeScript | .ts .tsx .mts .cts |
| Python | .py |
| Rust | .rs |
| Zig | .zig |
| C | .c .h |
| C++ | .cpp .cc .cxx .hpp .hh |
| PHP | .php |
| Ruby | .rb |
| Format | Extensions |
|---|---|
| JSON | .json |
| YAML | .yaml .yml |
| TOML | .toml |
| HTML | .html .htm |
| CSS | .css |
| Lua | .lua |
Note: Fully supported languages include tailored AST normalization (stripping punctuation noise and flattening comment/string blocks). Other languages built via
make build-coreormake build-allfall back to raw AST matching.
curl -fsSL https://raw.githubusercontent.com/HarshK97/diffmantic/main/install.sh | shThis installs the diffm binary to ~/.local/bin. Make sure it's in your $PATH.
It auto-detects your OS and architecture, grabs the right binary from GitHub Releases, and verifies the SHA256 checksum.
# Install to a specific directory
curl -fsSL https://raw.githubusercontent.com/HarshK97/diffmantic/main/install.sh | sh -s -- --dir=/usr/local/bin
# Install a specific version
curl -fsSL https://raw.githubusercontent.com/HarshK97/diffmantic/main/install.sh | sh -s -- --version=v0.7.0brew install HarshK97/tap/diffmanticPrebuilt binaries for Linux, macOS, and Windows (amd64 + arm64) are on the Releases page.
Requires Go 1.26+ and a C compiler for the native Tree-sitter bridge.
git clone https://github.com/HarshK97/diffmantic.git
cd diffmantic
# Default build: 16 core languages
make build
# Or install directly with Go:
go install github.com/HarshK97/diffmantic/cmd/diffm@latest# Show unstaged changes in any Git repository
diffm
# Show only staged changes
diffm --cached# Diff working tree against HEAD
diffm HEAD
# Diff between two commits, tags, or branches
diffm HEAD~1 HEAD
diffm main...feature-branch# Inline diff with pager (default when a terminal is attached)
diffm before.go after.go
# Wrap long lines to terminal width
diffm before.go after.go --wrap
# Standard patch suitable for git apply
diffm before.go after.go -p
# JSON output for editor plugins and automation
diffm before.go after.go -f json
# Fast UI mode (line alignment and highlight spans without action tree)
diffm before.go after.go -f json --ui
# Full envelope (actions, line alignment, and highlight spans)
diffm before.go after.go -f json --full
# Human-readable action list
diffm before.go after.go -f actionsdiffmantic loads configuration from ~/.config/diffmantic/config.yml (or $XDG_CONFIG_HOME/diffmantic/config.yml).
# Flag defaults
format: inline # "inline" | "json" | "actions"
tab_width: 4 # spaces per tab stop
ignore_comments: false # ignore comments during AST diffing
parse_error_limit: 0 # max parse errors before fallback to line diff
size_limit: 1024 # max file size before fallback to line diff
line_limit: 10000 # max file lines before fallback to line diffdiffmantic matches ASTs in four phases, combining the GumTree algorithm, Zhang-Shasha tree edit distance, and Chawathe edit script generation:
- Top-Down Matching. We look for identical subtrees by height. When we find an exact match, all nodes in the subtree get mapped together.
- Bottom-Up Matching. For unmatched nodes, we look for counterparts of the same type that share already-matched children. If the Dice similarity score is high enough, we match them.
- Recovery. Inside matched containers, we run LCS alignment on unmatched children (first by label, then by structural shape). For small subtrees, Zhang-Shasha (1989) tree edit distance is used as a precise fallback.
- Action Generation & Post-Processing. We produce a raw edit script (insert, delete, update, move) using Chawathe et al. (1996) edit script generation and then refine it. Child edits get collapsed into clean subtree operations, comment changes get normalized, and related moves get grouped.
diffmantic.nvim is the Neovim plugin that started this whole project. It currently ships with its own embedded alpha engine and is being migrated to use the diffm CLI as its backend via JSON output.
Planned. The JSON output is built to support editor integration, so if you want to build one, the plumbing is there.
diffm -f json outputs a stable v1 schema with child-index paths. Take a look at diffm file-a file-b -f json to see the full structure.
MIT. See LICENSE.
The engine is based on foundational research in AST differencing, tree edit distance, and edit script generation:
- GumTree: A Complete Approach for AST Differencing, Falleri et al.
- Beyond GumTree, Huvier et al.
- Simple Fast Algorithms for the Editing Distance Between Trees and Related Problems, Kaizhong Zhang and Dennis Shasha (SIAM Journal on Computing, 1989).
- Change Detection in Hierarchically Structured Information, Sudarshan S. Chawathe, Anand Rajaraman, Hector Garcia-Molina, and Jennifer Widom (ACM SIGMOD, 1996).
- GumTree GitHub Repository