pi-simplify

pi-simplify

A Pi extension that reviews recently changed code for clarity, consistency, and maintainability improvements.

Installation

pi install npm:pi-simplify

Usage

Review all uncommitted changes

/simplify

Review only staged changes

/simplify --staged

Review specific files

/simplify src/foo.ts src/bar.ts

Diff against a specific branch

/simplify --ref=main

What it does

When invoked, /simplify detects changed files and line ranges (via git diff) and instructs the agent to review only those changed lines with these principles:

• Preserve functionality: never change what the code does
• Apply project standards: follow conventions from CLAUDE.md / AGENTS.md
• Enhance clarity: reduce complexity, eliminate redundancy, improve naming
• Maintain balance: avoid over-simplification

The agent may read surrounding code for context, but edits stay within the changed line ranges. Newly added files are reviewed in full. It applies improvements one file at a time, runs tests to verify nothing breaks, and summarises the changes.

License

MIT