Terminal diffsfor humans & agents

www.hunk.dev · 2026-08-01 · by Long Nguyen ·generic
Hunk is a review-first terminal diff viewer for agent-authored changesets. Multi-file review stream, inline AI annotations, watch mode, and Git/Jujutsu integration.

Terminal diffsfor humans & agents

Terminal diffs

for humans & agents

Hunk is a review-first diff viewer that plays nice with agents. It's fast, it looks good, and it works everywhere.

$npm i -g hunkdiffStar on GitHub8k

hunk diff — split view

Hunk split-view diff in the Graphite theme

GraphiteMidnightEmberZenburnCatppuccin MochaCatppuccin Latte

\# from the community

Watch a video walkthrough.

JHunk changed the way I write and review code with my agent5:14Jilles · watch on YouTubeDI Was Definitely Using The Wrong Terminal Code Reviewer13:33DevOps Toolbox · watch on YouTube

\# what you get

Don't just read code, understand it.

One stream, every file.

The whole changeset reads top to bottom in sidebar order — no flipping between single-file views. File counts at a glance, hunk jumps with \[ and \], and the sidebar takes you straight to any file.

How reviews work →

Hunk's multi-file review stream: a sidebar lists changed files while the main pane shows consecutive file diffs top to bottom

Your agent's reasoning, beside the code it explains.

Agents leave notes in a sidecar; hunk renders each one inside the diff, right above the hunk it annotates — summary, rationale, and author. Step through hunks with \[ and \] and the notes follow.

Agent annotations, in depth →

“

Hunk is very good. It has replaced any other local diff viewer for me.

Mitchell Hashimoto, creator of Ghostty & Vagrant

Keys when you're fast, mouse when you're browsing.

Click a file in the sidebar to jump, wheel-scroll the stream, hover a row to leave a note — or never leave the keyboard. Pipe patches straight in and hunk is your pager, too.

Keyboard & mouse reference →

Split or stack — or let auto decide.

Side-by-side when your terminal is wide, stacked when it's narrow. Auto picks for you; press 1, 2, or 0 to override at any time, with wrapping and line numbers toggled live.

Layout & display options →

“

Love hunk.

DHH, creator of Omarchy and Ruby on Rails

Real syntax highlighting. Dozens of themes.

Understand structure, not just added and removed lines. Ships with its own looks plus the classics — Catppuccin, Dracula, Gruvbox, GitHub, and more — or roll your own in config.

Theme gallery & config →

\# and the rest

Watch mode — reloads as the tree changesExtensions — script Hunk in TypeScriptJujutsu & Sapling — first-class, like GitPager & difftool — pipe any patch inCross-platform — macOS, Linux, WindowsYour own themes — roll a palette in config

\# install

Wherever your terminal lives.

  • npm`npm i -g hunkdiff`
  • Homebrew`brew install hunk`
  • Nix`nix run github:modem-dev/hunk`

Then hunk diff to review your working tree, or hunk show to review a commit. npm installs require Node.js 18 or newer.

Try hunk on your next changeset.

Install hunkRead the quick start

www.hunk.dev · 10 images · 8 videos · 23 links

Comments (0)

No comments yet