# hunk for git
Review Git changes
without leaving the terminal.
Hunk turns Git changes into one review-first terminal UI: a multi-file stream, file navigation, split or stack layouts, expandable context, watch mode, and inline agent notes. Run Hunk directly for a complete changeset, or connect it to Git as a pager or difftool.
Start reviewing
Run these commands inside a Git workspace:
hunk diff
hunk diff --staged
hunk show HEAD~1
hunk stash showReview the whole working tree
hunk diff includes tracked changes and untracked files in one ordered review stream. Add --exclude-untracked when you only want files Git already knows about.
Review staged work, commits, and stashes
Use hunk diff --staged, hunk show <ref>, or hunk stash show [stash]. Pathspecs after -- narrow the input without changing Hunk's review navigation.
Pager or difftool
Pager mode lets git diff and git show open in Hunk. Git difftool integration is pair-oriented because Git invokes it once per file; use hunk diff for Hunk's native full-changeset stream.
Use Hunk from Git commands
git config --global core.pager "hunk pager"
git config --global difftool.hunk.cmd 'hunk difftool "$LOCAL" "$REMOTE" "$MERGED"'
git config --global difftool.prompt falseWhat to know
Git controls the input in pager mode, so untracked files are not synthesized there. Use `hunk diff` when you want Hunk to assemble the complete working-tree review.