Pi Boomerang
Extension
Runs an autonomous task or template chain and collapses the raw intermediate turns into a compact summary on the session tree.
By Nico Bailon · git:github.com/nicobailon/pi-boomerang · View source
What it does
Autonomous loops burn context fast: dozens of file reads, test runs, and retries stay in history long after the task is done. Pi Boomerang records an anchor before the task starts, lets the agent execute the full loop on disk, and then rewinds the conversation tree back to the anchor—replacing the raw turns with a concise handoff summary.
It supports plain tasks, slash prompt templates (/boomerang /template), sequential pipelines (/step-1 -> /step-2), and iterative --rethrow N loops where each pass builds on the previous summary. You can also toggle one-shot auto mode with Ctrl+Alt+B so your next ordinary message runs as a boomerang.
When to reach for it
Invocation: Run /boomerang <task> or press Ctrl+Alt+B before sending a self-contained implementation or refactoring task.
- Noisy implementation or test-fixing loops
- Keep the code changes on disk while collapsing dozens of tool calls into a single summary of outcomes, changed files, and validation commands.
- Multi-stage template pipelines
- Chain prompt templates with -> or repeat a refinement pass with --rethrow N under a shared summary anchor.
What it adds
- /boomerang and /boomerang-cancel commands, plus Ctrl+Alt+B to toggle one-shot auto mode.
- Session tree rewinding that preserves all filesystem edits while replacing raw intermediate turns with a structured summary.
- Support for prompt template chains (->), iterative loops (--rethrow / --loop), and shared summary anchors (/boomerang anchor).
Commands: /boomerang <task>, /boomerang --rethrow N <task>, /boomerang auto on, /boomerang anchor, /boomerang-cancel
How it fits
- Pi Progress Bar — Progress Bar tracks requirement completion across turns, while Boomerang collapses the noisy intermediate turns of a self-contained loop into one summary.
- Pi Interactive Shell — Boomerang runs inside the current session and rewinds history, whereas Interactive Shell spawns separate background Pi processes.
Good to know
- Boomerang rewinds conversation history only—it never reverts git or jj working-copy changes on disk.
Source and setup
- Loaded via
git:github.com/nicobailon/pi-boomerang- Attribution
- By Nico Bailon