pi-stack

Pi / OMP packages for pi.dev and omp.sh. Each folder under packages/ is its own npm package — install what you need, skip the rest.

Package	Does	Install
pi-papercuts	Agent files friction notes into .papercuts.jsonl and keeps going	pi install npm:pi-papercuts · omp install npm:pi-papercuts
pi-deferred-context-engine	Hides inactive tool/skill noise; promotes matches for one run via search_tools	pi install npm:pi-deferred-context-engine · omp install npm:pi-deferred-context-engine
pi-supernova	One CodeMode invocation with read, edit, write, and bash inside; automatic read batching and ordered mutations	pi install npm:pi-supernova · omp install npm:pi-supernova

If you use deferred-context-engine, install it last so it sees tools other extensions registered. pi-supernova exposes one supernova({code}) tool on Pi and OMP. The four commands live inside CodeMode, not as native-tool replacements. See its README for context, security, and host-verification boundaries.

the UI in the TUI for pi-supernova does NOT look good, i'll try and fix it with Astra

# Pi
pi install npm:pi-supernova
pi install npm:pi-papercuts
pi install npm:pi-deferred-context-engine

# OMP
omp install npm:pi-supernova
omp install npm:pi-papercuts
omp install npm:pi-deferred-context-engine

Needs Pi or OMP and Node 22+. Package details live in each folder's README.

Clone install

git clone https://github.com/AdityaVG13/pi-stack.git

# Pi
pi install ./pi-stack/packages/pi-supernova
pi install ./pi-stack/packages/pi-papercuts
pi install ./pi-stack/packages/pi-deferred-context-engine

# OMP
omp install ./pi-stack/packages/pi-supernova
omp install ./pi-stack/packages/pi-papercuts
omp install ./pi-stack/packages/pi-deferred-context-engine

Pi cannot target one monorepo subfolder over git alone (#4530). Use npm or a path.

Optional: load everything in this repo at once (root package.json declares both "pi" and "omp" extension lists):

pi install git:github.com/AdityaVG13/pi-stack
omp install git:github.com/AdityaVG13/pi-stack

Other Pi stuff

Project	What it does	Links
ast-sgrep	Hybrid lexical + AST graph search -- structure-aware code search, not only text grep	repo · ast-sgrep · Pi: pi-ast-sgrep (pi install npm:pi-ast-sgrep)

npm profile: adityavg13. Gallery search: keywords:pi-package.

Develop

cd packages/pi-papercuts && npm test
cd packages/pi-deferred-context-engine && npm install && npm test
cd packages/pi-supernova && npm test
# all from repo root:
npm test

Opt-in Supernova stress checks (no provider calls; temporary fixtures are retained):

npm run stress:supernova
# Test an isolated npm installation instead of the checkout:
SUPERNOVA_PACKAGE_ROOT=/path/to/install/node_modules/pi-supernova \
SUPERNOVA_STRESS_RUNS=2048 npm run stress:supernova

This exercises concurrent programs, contended commits, cancellation after staged writes, read batching, source fidelity and lookup across 5,000 files.

Publish (each package on its own):

cd packages/pi-papercuts && npm test && npm publish --access public
cd packages/pi-deferred-context-engine && npm test && npm publish --access public
cd packages/pi-supernova && npm test && npm publish --access public

node scripts/release-check.mjs runs a preflight for published packages.

Gotchas

• Deferred-context-engine defaults pin stock Pi tools (read, bash, …) and papercuts when that package is installed. Empty replaceAlwaysActive leaves only search_tools active -- read its README before rewriting config.
• Papercuts only logs when the agent calls it; it does not auto-detect failures. Outside a git repo the log goes to ~/.papercuts/log.jsonl unless you set PAPERCUTS_FILE.
• Longer caveats: docs/RESIDUAL-RISKS.md.

Pi package shape follows packages.md (pi-package keyword, pi.extensions / omp.extensions, host peers as "*").

License

MIT. See each package.