pi-hunk
Review changes and commits in full-screen Hunk from Pi and OMP
Package details
Install pi-hunk from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-hunk- Package
pi-hunk- Version
2.0.1- Published
- Nov 16, 2026
- Downloads
- 663/mo · 523/wk
- Author
- igas
- License
- MIT
- Types
- extension
- Size
- 69.7 KB
- Dependencies
- 0 dependencies · 5 peers
Pi manifest JSON
{
"extensions": [
"./dist/pi.js"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-hunk
Review your agent's changes in Hunk without leaving Pi or Oh My Pi. Leave comments and the agent gets them.
Install
You need Node.js 22.19+ and Hunk 0.25.0+ on your PATH.
omp plugin install pi-hunk # Oh My Pi
pi install npm:pi-hunk # Pi
Restart your agent afterwards. After upgrading Hunk, run hunk daemon restart so an older Hunk
daemon left running does not replace pi-hunk's status line.
Use
Press Ctrl + Space, let go, then press:
| Key | Opens |
|---|---|
| h | Uncommitted changes |
| s | Latest commit |
| l | Commit history |
| b | Everything on your branch since main |
| c | The whole codebase |
- Comment on lines with Hunk's usual keys.
- Press q to close Hunk. Your saved comments go to the agent.
In history, select commits and press Enter to review them. q takes you back to the list; quit the list to send everything.
Only saved comments are sent. Closing Hunk with no comments sends nothing.
Hunk beside the agent
In Tern, Rex, or Herdr, set the mode to multiplexer in /hunk config. Hunk then opens in a pane
next to the agent, and each comment goes to the agent as soon as you save it. Press r in
Hunk to see the agent's latest changes.
Configure
Run /hunk config to change the keys, the mode, or what happens if the agent is busy when your
comments arrive:
| Setting | Your comments... |
|---|---|
steer (default) |
join the turn that's running |
followUp |
wait until the turn finishes |
interrupt |
stop the turn and are sent straight |
If your main branch isn't main or master, add "base": "develop" (for example) to
~/.omp/agent/pi-hunk.json or ~/.pi/agent/pi-hunk.json.
If your OS already uses Ctrl + Space, pick another prefix.
To tell the agent how to handle your reviews, put it in AGENTS.md or a skill.
Contributing
See CONTRIBUTING.md.