# hunk - 面向 AI Agent 的终端 Diff 审查工具 5.7k Stars

> 本地独立工具，不需要接大模型，终端输入命令就能像VS Code一样逐文件逐行看代码改动

## hunk - 面向 AI 编码代理的终端 Diff 审查工具

Review-first 的终端 diff 查看器，专为 AI Agent 生成的代码变更设计。5.7k Stars，MIT 开源，TypeScript 编写。

### 核心亮点

- **多文件审查流 + 侧边栏导航** - 一次审完整批变更，不漏文件
- **内联 Agent/AI 注释** - 在代码旁边直接看 AI 的修改说明
- **响应式布局** - split / stack / 自动适配，窄终端自动堆叠
- **Watch 模式** - 文件变化自动刷新，边改边审
- **键盘 + 鼠标 + Pager + Git difftool** - 全输入方式支持

### 基本用法

```bash
npm i -g hunkdiff        # 或 brew install modem-dev/tap/hunk

hunk diff                # 审查当前工作区变更
hunk diff --watch        # 自动刷新
hunk show                # 审查最新 commit
hunk show HEAD~1         # 审查历史 commit
hunk diff before.ts after.ts  # 直接对比两个文件
```

### Agent 集成

1. 开一个终端跑 `hunk diff` 或 `hunk show`
2. 让代理加载 `hunk skill path` 返回的 skill 文件
3. 代理可对 live session 实时添加注释和标记

### Git/JJ/Sl 集成

可设为 Git pager（`git config core.pager "hunk pager"`），也原生支持 Jujutsu 和 Sapling revset。

### 自定义主题

内置 GitHub Dark/Light 主题，支持自定义 Catppuccin 等配色方案，`theme = "auto"` 自动跟随终端背景。

### 与同类工具对比

在交互式审查 UI、多文件流、Agent 注释、响应式布局、鼠标支持上全面领先 delta、difftastic 等传统 diff 工具。

---

**分类**：软件
**标签**：终端 · 审查 · hunk
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1858