@mammothb/pi-memory

VCC conversation compaction for Pi, backed by mm-cli. Replaces Pi core's default LLM-based compaction with structured summaries produced by the mm binary.

Commands

Command	Description
/mm-compact	Compact conversation with mm-cli structured summary. Accepts keep:N and a follow-up prompt.
/mm-recall	Search session history. Defaults to active lineage; add scope:all for off-lineage branches.

Tools

Tool	Description
mm_recall	Search session history programmatically. Supports regex queries, paging, and expand indices.

Architecture

The extension is a thin TypeScript shim over the mm-cli Rust binary:

/mm-compact  ──>  before-compact hook  ──>  compile()  ──>  mm pi (subprocess)
/mm-recall   ──>  recall pipeline     ──>  session JSONL parsing + BM25 search
mm_recall    ──>  recall pipeline     ──>  (same pipeline as /mm-recall)

All heavy computation (message normalization, noise filtering, section extraction, brief compilation, merge with previous summary) is handled by mm-cli. The shim only wraps the subprocess call and handles session file reading/searching.

Settings

Configured via ~/.pi/agent/pi-memory.json:

Key	Type	Default	Description
overrideDefaultCompaction	boolean	false	When true, mm-compact handles ALL compactions (/compact, auto threshold, overflow). When false, only /mm-compact.
debug	boolean	false	Write debug snapshot to /tmp/mm-compact-debug.json on each compaction.

Usage

cd packages/pi-memory
pi -e ./index.ts

Then in a pi session:

/mm-compact                        # basic compaction
/mm-compact keep:3                 # keep last 3 user turns
/mm-compact keep:2 continue        # keep 2 turns + send follow-up prompt
/mm-recall                         # show recent history
/mm-recall "refactor|rewrite"      # regex search
/mm-recall login scope:all         # search all branches