pi-review

Review current pi work in a new branch with conversation context

Package details

extension

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

$ pi install npm:pi-review
Package
pi-review
Version
1.0.0
Published
Apr 28, 2026
Downloads
141/mo · 141/wk
Author
akuzmenko
License
MIT
Types
extension
Size
656.7 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-review

Run a strict maintainer review in a new pi coding agent branch.

Preview

Example pi-review output showing prioritized findings and recommendations

What it does

Adds a /review command that starts a new branch from the current conversation and asks pi to review the available work. The review includes user and assistant conversation messages from the current branch, with thinking and tool calls removed.

The reviewer focuses on concrete, high-confidence issues in correctness, security, performance, operability, and maintainability. If nothing material stands out, it reports looks good.

Installation

pi install npm:pi-review

Or try it temporarily:

pi -e npm:pi-review

Usage

/review

Add optional focus text:

/review focus on release safety and backward compatibility

How it works

  1. Waits for the current agent turn to finish if needed
  2. Extracts user and assistant text from the active branch
  3. Switches thinking level to high for the review turn
  4. Creates a new branch from the current conversation
  5. Sends a maintainer-style review prompt with optional focus text
  6. Restores your previous thinking level when the review turn ends

Review output

Findings are sorted by priority:

  • [P0] severe breakage, data loss, or security issue
  • [P1] likely user-facing breakage or major regression
  • [P2] limited-scope correctness, performance, or maintainability issue
  • [P3] minor but real issue

Each finding includes location, summary, affected behavior/invariant/code path, and a specific recommendation.

License

MIT