🔄 Agent Loop

General-purpose loop extension for pi. Repeats agent turns automatically in three modes: until a goal is met, for a fixed number of passes, or through a sequence of named pipeline stages.

Install

pi install npm:pi-agent-loop

What it does

Registers a /loop command and a loop_control tool. On each iteration, the agent does its work then calls loop_control to either advance to the next iteration (next) or declare the goal complete (done). The loop context is injected into the system prompt automatically so the agent always knows where it is.

Commands

Command	Description
/loop goal <description>	Repeat until the LLM declares the goal met (open-ended)
/loop passes <N> <task>	Run exactly N passes
/loop pipeline <s1|s2|s3> <goal>	Run named stages sequentially, stop after the last
/loop-stop	Stop the active loop immediately

Shortcut

Shortcut	Description
Ctrl+Shift+X	Emergency abort — stops the loop and cancels the current turn

Tool: loop_control

The LLM calls this tool to signal progress. It is only active during a loop.

Parameter	Type	Description
status	"next" | "done"	Advance to next iteration or declare completion
summary	string	Brief summary of what was accomplished this iteration
reason	string?	Why the goal is met (used with "done")

Examples

/loop goal Refactor all test files to use the new assertion API
/loop passes 3 Review and improve the README
/loop pipeline analyze|implement|test Write and test the new auth module

TUI widget

While a loop is active, a status bar entry and widget show the current mode, goal, and iteration count.