Skip to content

Install

Hunk runs on macOS, Linux, and Windows. npm installs require Node.js 18 or newer; Homebrew, mise, and Nix installs are self-contained binaries. Git is recommended for the most common review workflows.

npm

Section titled “npm”

Install the published hunkdiff package globally:

Terminal window
npm install --global hunkdiff
hunk --version

The package exposes both hunk and hunkdiff; the docs use hunk.

Homebrew

Section titled “Homebrew”
Terminal window
brew install hunk
hunk --version

If you previously used the old modem-dev/tap formula, remove it before installing from Homebrew core:

Terminal window
brew uninstall modem-dev/tap/hunk
brew install hunk

mise

Section titled “mise”

mise knows Hunk by the short name hunk (alias hunkdiff) and installs the prebuilt binary on macOS and Linux:

Terminal window
mise use -g hunk
hunk --version

Hunk also ships as a default tool in Omarchy, which installs it through mise.

Nix

Section titled “Nix”

The repository exports a default package from flake.nix. From a clone of Hunk:

Terminal window
nix build
./result/bin/hunk --version

See the repository's nix/README.md for Home Manager and development-shell details.

Verify the install

Section titled “Verify the install”
Terminal window
hunk --help

You should see Usage: hunk <command> [options]. If the shell cannot find Hunk, ensure your global npm, Homebrew, or mise binary directory is on PATH, then open a new shell.

Next, review your first working tree.