pi-vcc
FreeEfficiencyApache-2.0
Lossless session compaction. No LLM call, no hallucination - same input always produces the same compact transcript. Active history stays searchable after compaction.
Capabilities
- Algorithmic extraction replaces LLM summarization - zero API calls, deterministic output.
- 35–99% token reduction on real sessions.
- Typically under 100 ms compaction latency.
- Active lineage stays searchable via vcc_recall after compaction - nothing is gone.
- Repeated compactions merge and accumulate sections instead of rewriting and risking loss.
Installation Instructions
Install
pi install npm:@bastilleworks/pi-vccUsage Instructions
Pi command
/pi-vccPi command
/pi-vcc keep:N [prompt]Pi command
/pi-vcc-recall <query>keep:1 is the default (keeps the last user turn). Add scope:all to recall to search across all lineages. The config file lives at ~/.pi/agent/extensions/pi-vcc.json.
Uninstall
Uninstall this extension
pi uninstall npm:@bastilleworks/pi-vccNotes
- Free and open-source (Apache-2.0). BASTILLE fork of @sting8k/pi-vcc (MIT).
- To let pi-vcc handle /compact and auto-threshold compactions too, set overrideDefaultCompaction: true in the config.
Source and full reference in thepublic repository.