@agentoom/pi-reviewer

Post-task multi-area code review extension for pi by agentoom.com.

After every task, pi-reviewer prompts you to run a structured critique across 7 specialised areas — or you can call /review anytime.

v1.3.0 — Review results and fixes now render directly in the chat transcript (via pi.appendEntry entry renderers) so you can read them inline, yet they stay invisible to the LLM on subsequent prompts. Review scope defaults to the last prompt only.

Install

pi install npm:@agentoom/pi-reviewer

Usage

Commands

Command	Description
/review	Open the review area picker and run selected reviews
/review-toggle	Toggle the auto‑offer prompt on/after each task
/review-disable-project	Disable auto-review for the current project (writes .pi/review-config.json)
/review-enable-project	Re-enable auto-review for the current project

Review Scope

Before each review, you're asked to choose the scope:

• Last prompt only (default) — only the most recent user prompt and the agent's response are reviewed. This is the recommended default and avoids reviewing irrelevant context from earlier in the session.
• Entire session — the full conversation from the session (or from the last compaction point) is reviewed.

Apply Review Findings

After the review completes, the results appear directly in the chat transcript as a styled 📋 Code Review Report entry. These entries are rendered in the TUI but do not participate in LLM context — subsequent prompts won't see or be confused by them.

pi-reviewer scans the results for actionable issues (sections marked with ❌ or ⚠️ containing bullet points). If issues are found, you'll be prompted:

• Apply fixes now — the LLM reads the review findings, edits the affected files, and reports what was changed. Fix results appear as a 🔧 Fixes Applied entry in the chat.
• Skip — the review report stays visible but no fixes are applied.

If the review found no issues, the prompt is skipped.

Auto‑offer

By default, pi-reviewer prompts you after every task completes. Choose:

• Review (all 7 areas) — you'll be asked about review scope, then all areas run
• Pick which areas to review — you'll be asked about review scope, then the checkbox picker opens
• Disable auto-offer — switch to manual mode permanently
• Skip — dismiss for this task only

When auto‑offer is disabled, 🔍 auto-review disappears from the footer, and pi-reviewer stays silent until you run /review.

Toggle it back on with /review-toggle.

Disabling Auto-Review

For the current project (persistent)

Run /review-disable-project to write autoReview: false to .pi/review-config.json. The extension will skip auto-offering after each task. Use /review-enable-project to undo.

You can also create .pi/review-config.json manually:

{ "autoReview": false }

For the current session only

Set an environment variable before starting pi:

REVIEWER_DISABLE_SESSION=true pi

This suppresses the auto-review prompt for that session only — other pi sessions (without the env var) are unaffected. The env var takes priority over the project config.

Review Areas

Area	Question
General	Did the implementation satisfy the original task?
Security	Did it introduce vulnerabilities?
Code Quality	Is it maintainable and consistent?
UI/UX	Is the user-facing implementation complete?
Testing	Is it adequately tested?
Performance	Could it cause performance problems?
Scope	Did the agent change more than it should have?

Checkbox Picker

• ↑↓ — navigate
• Space — toggle an area
• a — toggle all areas
• Enter — run selected reviews
• Esc — cancel

Development

pi-reviewer/
├── package.json
├── index.ts          # Extension entry point
└── README.md

Links

• agentoom.com
• npm: @agentoom/pi-reviewer

Run against a local path:

pi install ./pi-reviewer