+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
#463In-diff content search with match-to-match navigation9 comments · 2026-06-20#115Support replying to inline agent comments and route replies back to the agent8 comments · 2026-03-24#646Support Github "Viewed" behavior in hunk6 comments · 2026-07-30#113Persist live comments so a Hunk review session can be continued after quit6 comments · 2026-03-24#556Every invocation leaks a 3.6MB dylib into tmpdir5 comments · 2026-07-17#415Expose Shiki's bundled themes (and custom theme files) via a top-level syntax_theme5 comments · 2026-06-11#213Feature: Sidebar-based lazy Git staging & committing (à la lazygit)5 comments · 2026-04-24#247Proposal: Streaming pager mode for `git log -p` and other large patch streams4 comments · 2026-05-08
Latest release
v0.25.0 v0.25.0 2026-11-11What'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