pi-hunk

Review changes and commits in full-screen Hunk from Pi and OMP

Packages

Package details

extension

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
  1. Comment on lines with Hunk's usual keys.
  2. 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.

License

MIT