# Install hunk with Homebrew

Review-first terminal diff viewer for agent-authored changesets. Version 0.17.6 via Homebrew; verified 2026-07-25.

## Install

```sh
sudo av install brew:hunk
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install hunk
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:hunk
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/hunk>
- **Version:** 0.17.6
- **Source summary:** Review-first terminal diff viewer for agent-authored changesets
- **Homepage:** <https://hunk.dev/>
- **Repository:** <https://github.com/modem-dev/hunk>
- **Upstream docs:** <https://github.com/modem-dev/hunk#readme>
- **License:** MIT
- **Source archive:** <https://github.com/modem-dev/hunk/archive/refs/tags/v0.17.6.tar.gz>
- **Last updated:** 2026-07-25T03:21:50Z
- **Generated:** 2026-07-25T07:20:51+00:00

## Executables

- hunk (cli)
- hunk (alias)

## Build dependencies

- bun
- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-25
- Package-manager version: 0.17.6
- Package-manager updated: 2026-07-25
- Local data: ok
- Upstream repository: https://github.com/modem-dev/hunk
- Upstream latest detected: v0.17.6 (current)
## Project history and usage

hunk is a review-first terminal diff viewer for agent-authored changesets. It sits in the developer-tools package niche around Git diffs, terminal UIs, code review, and AI-agent review workflows.

### Project history

The official GitHub repository was created on 2026-03-17, and its README describes Hunk as a review-first terminal diff viewer built on OpenTUI and Pierre diffs.

The README documents multi-file review navigation, inline AI and agent annotations, split and stacked layouts, watch mode, keyboard and mouse support, pager support, Git difftool support, Jujutsu and Sapling integration, and an OpenTUI component export.

### Adoption history

Hunk's official homepage positions it as a diff viewer for humans and agents, with install paths through npm, Homebrew, and Nix.

The changelog shows rapid early adoption of package-manager concerns in spring 2026: Homebrew tap automation, prebuilt Windows support, npm packaging fixes, Nix outputs, release benchmarks, and performance work for large reviews.

### How it is used

The README documents hunk diff for current repository changes, hunk show for commits, hunk patch for patch input, hunk pager for Git pager integration, and hunk session commands for live agent review workflows.

Preferences can be persisted in ~/.config/hunk/config.toml or .hunk/config.toml, including theme, layout mode, VCS override, watch behavior, line numbers, wrapping, menu bar, agent notes, and transparent background.

### Why package nerds care

hunk is package-nerd significant because it packages a modern terminal review UI across npm, Homebrew, and Nix while also publishing prebuilt artifacts and an embeddable OpenTUI component.

Its focus on agent-authored changesets makes it part of the 2020s shift from plain diff pagers toward review tools that can display machine-written context beside code.

### Timeline

- 2026-03-17: The official GitHub repository was created.
- 2026-03-20: The changelog lists the 0.1.0 release.
- 2026-05-12: Version 0.12.0 added Homebrew tap release automation, Windows support, Nix outputs, and npm packaging improvements.
- 2026-06-19: GitHub releases list v0.16.0.

### Related projects

- The README compares Hunk with lumen, difftastic, delta, diff-so-fancy, and GNU diff.
- The project is built on OpenTUI and Pierre diffs and integrates with Git, Jujutsu, and Sapling.

### Sources

- <https://api.github.com/repos/modem-dev/hunk>
- <https://api.github.com/repos/modem-dev/hunk/releases?per_page=10>
- <https://github.com/modem-dev/hunk>
- <https://hunk.dev/>
- <https://raw.githubusercontent.com/modem-dev/hunk/main/CHANGELOG.md>
- <https://raw.githubusercontent.com/modem-dev/hunk/main/README.md>


## Security Notes

No matching local secret-handling manifest was found for hunk. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/hunk/config.toml, .hunk/config.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** hunk
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [bun](https://www.automicvault.com/pkg/brew/bun/) - Build dependency declared by Homebrew.
- [node](https://www.automicvault.com/pkg/brew/node/) - Build dependency declared by Homebrew.
- [diffr](https://www.automicvault.com/pkg/brew/diffr/) - Shares av.db curated category or tags: cli, code-review, developer-tools, diff, git.
- [gerrit-tools](https://www.automicvault.com/pkg/brew/gerrit-tools/) - Shares av.db curated category or tags: cli, code-review, developer-tools, git.
- [diff-so-fancy](https://www.automicvault.com/pkg/brew/diff-so-fancy/) - Shares av.db curated category or tags: cli, developer-tools, diff, git, terminal.
- [diffnav](https://www.automicvault.com/pkg/brew/diffnav/) - Shares av.db curated category or tags: cli, developer-tools, diff, git, tui.
- [difi](https://www.automicvault.com/pkg/brew/difi/) - Shares av.db curated category or tags: cli, code-review, developer-tools, diff, git.
- [git-split-diffs](https://www.automicvault.com/pkg/brew/git-split-diffs/) - Shares av.db curated category or tags: cli, developer-tools, diff, git, terminal.
- [gitlogue](https://www.automicvault.com/pkg/brew/gitlogue/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, tui.
- [gitu](https://www.automicvault.com/pkg/brew/gitu/) - Shares av.db curated category or tags: cli, developer-tools, git, terminal, tui.

## Combined YAML source

View the package source record on GitHub. [combined/hunk.yml](https://github.com/automic-vault/db/blob/main/combined/hunk.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
