# pi-boomerang > Token-efficient autonomous task execution with context collapse for pi coding agent - **URL**: https://www.freshcrate.ai/projects/pi-boomerang - **Author**: nicobailon - **Category**: AI Agents - **Latest version**: `v0.6.6` (2026-05-20) - **License**: Unknown - **Source**: https://github.com/nicobailon/pi-boomerang - **Language**: TypeScript - **GitHub**: 130 stars, 14 forks - **Registry**: github - **Tags**: `typescript` ## Description Token-efficient autonomous task execution with context collapse for pi coding agent ## Recent releases | Version | Date | Urgency | Changes | | --- | --- | --- | --- | | `v0.6.6` | 2026-05-20 | High | ### Fixed - Delay fallback summary auto-refresh until Pi reports idle; session replacements cancel stale handoffs, while idle timeouts warn and still send the hidden handoff. - Queue chained boomerang steps as follow-ups so they advance from Pi 0.75.4 `agent_end` handlers without busy-agent errors. - Document the correct `pi install npm:pi-boomerang` install command. - Preserve much longer validation commands and failure details in boomerang summaries while still bounding huge logs. | | `v0.6.5` | 2026-05-03 | High | ## [0.6.5] - 2026-05-03 ### Fixed - Auto-refresh fallback boomerang summaries with `/reload`, including shortcut-first auto mode before any `/boomerang` command has initialized a command context, so stale raw branch content is not left visible after the summary appears. - Preserve draft editor text while auto-refreshing shortcut-first fallback summaries through the temporary `/reload` editor path. - Removed the duplicate visible `boomerang-summary` message; the branch summary remains the single | | `v0.4.5` | 2026-05-01 | High | ### Fixed - Expanded completed boomerang branch summaries by default so users no longer need to press Ctrl+O to reveal details. - Avoided expanding the UI if a rethrow collapse is cancelled before boomerang still owns the collapse. | | `v0.4.4` | 2026-04-23 | High | ### Fixed - Migrated extension tool schemas from `@sinclair/typebox` to `typebox` 1.x so packaged installs follow Pi's current extension runtime contract. ### Changed - Added `typebox` as a runtime dependency for packaged installs. | | `v0.4.3` | 2026-04-04 | High | ## [0.4.3] - 2026-04-04 ### Changed - Added a `promptSnippet` for the `boomerang` tool so Pi 0.59+ includes it in the default tool prompt section and reliably discovers it during autonomous runs. | | `v0.4.2` | 2026-04-04 | Medium | ### Fixed - Boomerang branch summaries now keep the full `Outcome` text instead of truncating at 500 characters, so collapsed context preserves complete results for future turns. - Preserved assistant formatting in `Outcome` summaries by normalizing line endings without flattening multiline content. | | `v0.4.1` | 2026-04-03 | Medium | ### Changed - Migrated boomerang session reset handling to the `session_start` lifecycle event and removed the legacy `session_switch` hook. - Clarified `--rethrow` and `--loop` boomerang behavior in the README, including count requirements, alias precedence, and pass-by-pass execution details. | | `v0.4.0` | 2026-03-19 | Low | ### Added - **`--rethrow N` syntax** — Run full multi-pass boomerang execution with context collapse between rethrows (for example `/boomerang /task --rethrow 3`) - **Synchronous rethrow execution model** — Rethrows run in-command via `waitForIdle`, with per-rethrow collapse and accumulated summaries - **Boomerang tool accepts a task parameter** — When enabled, the agent can call `boomerang({ task: "fix bugs --rethrow 3" })` to queue tasks with full rethrow/chain/template support ### Changed | | `v0.2.1` | 2026-03-10 | Low | ### Fixed - Added missing `pi` manifest to package.json so pi can auto-discover the extension | | `v0.2.0` | 2026-03-05 | Low | ### Added - **Chain execution** - Run multiple templates in sequence with `/boomerang /scout -> /planner -> /impl -- "task"`. Each step can have its own args, model, skill, and thinking level. Context collapses after the final step. - **Prompt template execution** - `/boomerang /