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

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

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

核心亮点

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

基本用法

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 工具。