@diegopetrucci/pi-review

A standalone pi extension that adds /review and /end-review commands adapted from mitsuhiko/agent-stuff.

Packages

Package details

extension

Install @diegopetrucci/pi-review from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@diegopetrucci/pi-review
Package
@diegopetrucci/pi-review
Version
0.1.16
Published
Oct 19, 2026
Downloads
267/mo · 8/wk
Author
diegopetrucci
License
Apache-2.0
Types
extension
Size
78.2 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

review

A standalone pi review extension that adds /review and /end-review, adapted from the upstream mitsuhiko/agent-stuff implementation.

Install

Install the standalone package:

pi install npm:@diegopetrucci/pi-review

Then reload pi:

/reload

Usage

  • /review — open the interactive selector
  • /review uncommitted — review uncommitted changes
  • /review branch main — review against a base branch
  • /review commit <sha> — review a specific commit
  • /review pr <number-or-url> — fetch and review a GitHub pull request
  • /review folder src docs — review one or more folders/files as a snapshot
  • /review --extra "focus on performance regressions" — add one-off instructions
  • /end-review — return from the review branch and optionally summarize or queue fixes

Notes

  • /review requires interactive mode (TUI); /end-review requires a UI.
  • This fork adds loop fixing, custom review instructions persisted in the session, a blocking-findings parser, and /end-review handoff modes (return only, return and summarize, or return and fix findings). Loop fixing cycles until the parser reports no blocking findings: tagged P0–P2 items, or a "needs attention" verdict when no priority tags are present. Commit review is excluded from loop fixing.
  • Loop fixing always uses Empty branch mode and skips the Empty branch / Current session choice.
  • PR review requires gh access and a clean working tree for tracked files.
  • If the project is trusted and a REVIEW_GUIDELINES.md file exists next to the repo's <pi-config-dir> directory, its contents are appended to the review prompt. <pi-config-dir> is Pi's runtime config directory name (CONFIG_DIR_NAME; .pi by default).

License and attribution

This package vendors and adapts extensions/review.ts from mitsuhiko/agent-stuff under the Apache-2.0 license. See LICENSE.