pi-extensions

fractaal's Pi extension monorepo — agentic QoL extensions published to npm under @fractaal.

Packages

Package	What it does
@fractaal/pi-agentic-processes	Background bash tasks, sparse monitors, and headless management APIs (bash-backgrounding + monitor extensions).
@fractaal/pi-claude-bridge	Runs Claude Code as a Pi provider, with selectable Claude Code or full Pi prompt semantics.
@fractaal/pi-fractal-compact	High-fidelity compaction extension.
@fractaal/pi-codex-usage-info	Codex/OpenAI usage statusline extension.
@fractaal/pi-directive-roots	Directive-root loading and mid-turn discovery for CLAUDE.md, AGENTS.md, MEMORY.md, and shared skill directories.

Consumption

Packages ship built JavaScript for programmatic hosts and a Pi loader entry from the same source implementation. Most packages expose compiled dist/ factories while Claude Bridge ships its upstream-compatible bundle plus an isolated-runtime entry for hosts with sibling Pi registries. Build artifacts are generated by prepack and are never committed.

The publishing pattern is documented in the reference implementation: @fractaal/pi-cross-agent-memory — see its "Publishing a Pi extension properly" README section. dist/ is never committed; no git-SHA tarball pins; no .ts paths resolved out of node_modules at runtime.

Development

npm install
npm run typecheck
npm test
npm run build

Release (per package):

cd packages/<name>
npm version minor
npm publish   # prepack builds dist/

Provenance

agentic-processes, fractal-compact, and codex-usage-info were originally canonicalized inside a fork of Jonghakseo/pi-extension and moved here to live under fractaal ownership with proper npm publishing.