♻️ Refactor Loop

Iterative refactoring pipeline for pi. Runs analyze → refactor → verify cycles with a TUI progress widget, optional git commit-and-push per completion, and a bundled skill that guides the model through each pass.

Install

pi install npm:pi-refactor-loop

What it does

Registers a /refactor command that walks you through a setup dialog, then drives the agent through up to N simplification passes on a target (file, function, module, etc.). Each pass the agent:

1. Analyses the target and identifies one focused simplification
2. Applies the change
3. Runs your test command (if provided)
4. Calls the refactor_pass tool to report results and continue

The loop stops when the agent declares the code clean (done: true) or the pass limit is reached.

Commands

Command	Description
/refactor [target]	Start a refactoring pipeline. Prompts for target, test command, pass limit, and auto-commit if no args given
/refactor-stop	Stop the active pipeline immediately

Setup dialog

On /refactor, you are prompted for:

Prompt	Description
Target	File path, function name, or module to refactor
Test command	Shell command to run after each pass (e.g. bun test, pytest) — leave empty to skip
Max passes	3 / 5 / 10 / 20
Auto commit & push	Automatically git commit and git push when the pipeline completes

Tool: refactor_pass

The agent calls this after each pass to report what changed.

Parameter	Type	Description
change	string	What was changed in this pass
reason	string	Why this simplification improves the code
remaining	string	What simplification opportunities remain (empty if done)
done	boolean	true if the code is clean and no more passes are needed

Bundled skill

The extension ships with a SKILL.md that is automatically loaded into the session. It provides detailed instructions on the analyze → refactor → verify cycle, what counts as a good simplification, and when to stop.

TUI widget

While the pipeline is active, a widget shows the current pass, target, and completed changes.