@mammothb/pi-memory1.2.5
VCC conversation compaction for Pi, backed by mm-cli
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
@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