prune — Lossless Conversation Compactor

Trim conversation to essentials. Search everything.

Overview

prune is a deterministic compaction extension for pi:

• structured sections for goals, files, blockers, preferences
• brief transcript with stable #N refs
• raw JSONL recall via prune_recall after prune compaction
• no LLM call for compaction summary

Commands

| Command | Description | |----------|-------------| | /prune | Run compaction now | | /prune-recall <query> | Search session history |

Tool

prune_recall is registered but only exposed to the agent after a prune compaction exists in the current branch.

prune_recall({ query: "auth token" })
prune_recall({ query: "auth token", scope: "all" })
prune_recall({ query: "auth token", expand: [12, 14] })

Output Format

[Session Goal]
- Fix the auth bug
- [Scope change]
- also update token refresh logic

[Files And Changes]
- Modified: session.ts

[Outstanding Context]
- lint still failing

---
[user]
Fix the auth bug (#1)
* read "src/auth/session.ts" (#3)

Use prune_recall to search for prior work, decisions, and context from before this summary.
Do not redo work already completed.

Testing

bun install

bun test              # fast default: unit + harness, no network
bun run test:unit     # pure funcs only
bun run test:harness  # pi-test-harness extension wiring
bun run test:watch    # watch fast tests
bun run test:coverage # coverage for fast tests

bun run test:real     # real MiniMax integ test, costs quota
bun run test:all      # fast tests + real MiniMax

Notes:

• bun test intentionally excludes __tests__/real/ → no skipped real test in normal runs.
• test:real uses only MiniMax, temp cwd/agentDir/session, noExtensions: true, only prune loaded.

Demo