@bacnh85/pi-review
v0.2.19
Published
Pi extension for isolated or local read-only code review.
Maintainers
Readme
@bacnh85/pi-review
Read-only local code review for Pi. /review uses the isolated reviewer role from pi-subagent when available and falls back to a corrected one-turn review in the parent session.
Install
pi install npm:@bacnh85/pi-subagent
pi install npm:@bacnh85/pi-reviewpi-subagent is optional; without it, /review still works locally.
Usage
/review
/review xhigh main...my-feature
/review focus on auth/session regressionsSupported effort tokens: off, minimal, low, medium, high, xhigh, max.
In TUI mode, bare /review asks for uncommitted, branch, or custom scope. Without UI it uses the default branch/local-change scope.
Behavior
- Parent gathers compact read-only Git status/diff evidence.
- Isolated review runs in a lean child with read/search tools but no mutators or shell.
- Each confirmed finding is a structured actionable issue with severity, file/line, reproduction or evidence, expected behavior, suggested fix, acceptance criteria, and
blocking. - Only compact findings return to the parent;
/agentretains the child thread. REVIEW.md, when present, is passed as bounded review guidance.- Isolated reviews use a 3-minute activity-resettable inactivity window and a 20-minute absolute cap. All progress events (including
pi-subagenttransport heartbeats) count as activity and reset the window; only the 20-minute cap bounds a hung-but-heartbeating child.
The local fallback preserves active safe research tools (Serena, FFF, web, and Munin reads), blocks mutators and unsafe Bash, chains review guidance into the per-turn system prompt, and restores tools/thinking once on agent_settled.
Changelog
See CHANGELOG.md for release history.
Automation
pi-review exposes the pi-review:run event used by pi-plan's Implement, verify, and review approval choice. If isolated review is unavailable, the automated workflow stops instead of treating the review as clean.
