modem-dev /hunk

Review-first terminal diff viewer for agentic coders

★ 9,835⑂ 335👁 11⑃ 1,034● 249▤ 77
TypeScriptMITCreated 2026-03-17hunk.dev
下载:v0.25.0v0.25.0 ↓0.25.02026-11-11
+5
日增长
9,835
stars
335
forks
11
watchers
1,034
prs
249
issues
77
releases

README

Hunk is an interactive terminal diff viewer for reviewing code changes, built on OpenTUI and Pierre diffs.

hunk.dev · Documentation






- multi-file review stream with sidebar navigation
- inline AI and agent annotations beside the code
- split, unified, and responsive auto layouts
- watch mode for auto-reloading file and Git-backed reviews
- keyboard, mouse, pager, and Git difftool support


 
   
     
     
     Split view with sidebar and inline AI notes
   
   
     
     
     Unified view and mouse-selectable menus
   
 


 Install

On macOS and Linux, install the standalone binary:

bash
curl -fsSL https://hunk.dev/install.sh | sh


Windows users can install with npm or mise. Other installation methods are also available:

bash
npm i -g hunkdiff                     macOS, Linux, or Windows; requires Node.js 22+
brew install hunk                     macOS or Linux
mise use -g hunk                      macOS, Linux, or Windows


 [!NOTE]
 If you previously installed hunk via modem-dev/tap, be sure to uninstall it first with brew uninstall modem-dev/tap/hunk.

Windows requires mise 2026.8.6 or newer. Nix users can use the default package exported in flake.nix; see the Nix guide for details. Hunk also ships as a default tool in Omarchy, installed through mise.

Requirements:

- macOS (arm64, x64), Linux (arm64, x64; glibc), or Windows (x64); prebuilt binaries are not published for Windows on arm64 or musl-based Linux such as Alpine
- On x86-64, a CPU with SSE4.2 (Intel Nehalem 2008+, AMD Bulldozer 2011+); arm64 has no CPU feature floor
- Node.js 22+ for the npm install; the install script, Homebrew, mise, and Nix ship a standalone binary that does not require Node.js
- Git recommended for most workflows

 Update Hunk

For npm, Homebrew, and default install-script installs (Hunk 0.20+):

bash
hunk update           install the newest release
hunk update --check   check without installing
hunk update 0.20.0    select an exact npm or default install-script release


On an older release, update once with the installer or package manager that installed Hunk, then use hunk update going forward. Custom HUNK_INSTALL_DIR installs must re-run the installer with the same directory; mise, Nix, and source installs use their owning tools instead.

 Quick start

bash
hunk            show help
hunk --version  print the installed version


 Working with Git

Use familiar Git commands to open changes in Hunk:

bash
hunk diff                       review current repo changes, including untracked files
hunk diff --watch               auto-reload as the working tree changes
hunk show                       review the latest commit
hunk show HEAD~1                review an earlier commit
hunk log                        browse history on a terminal; print when redirected
hunk log --static               force static output, paging when needed
hunk status                     view workspace status and sibling worktrees (Git)
hunk status --static            print one 

Top issues

Latest release

v0.25.0 v0.25.0 2026-11-11
What's Changed
 docs(website): list hunk-workspace in the extension directory by @GopinathMR in https://github.com/modem-dev/hunk/pull/1204
 Remove the deprecated --fast flag by @masonmcelvain in https://github.com/modem-dev/hunk/pull/1207
 docs(release): publish 0.24.1 changelog by @benvinegar in https://github.com/modem-dev/hunk/pull/1228
 chore(website): limit Vercel deployments to main by @benvinegar in https://github.com/modem-dev/hunk/pull/1229
 fix(website): make brand logo downloads visible in any viewer by @benvinegar in https://github.com/modem-dev/hunk/pull/1230
 fix(skills): fall b

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON