---
slug: "fractaal-pi-fractal-compact"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/fractaal/pi-extensions@main/README.md"
repo: "https://github.com/fractaal/pi-extensions"
source_file: "README.md"
branch: "main"
---
# pi-extensions

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

## Packages

| Package | What it does |
|---|---|
| [`@fractaal/pi-agentic-processes`](https://github.com/fractaal/pi-extensions/tree/HEAD/packages/agentic-processes) | Background bash tasks, sparse monitors, and headless management APIs (`bash-backgrounding` + `monitor` extensions). |
| [`@fractaal/pi-claude-bridge`](https://github.com/fractaal/pi-extensions/tree/HEAD/packages/claude-bridge) | Runs Claude Code as a Pi provider, with selectable Claude Code or full Pi prompt semantics. |
| [`@fractaal/pi-fractal-compact`](https://github.com/fractaal/pi-extensions/tree/HEAD/packages/fractal-compact) | High-fidelity compaction extension. |
| [`@fractaal/pi-codex-usage-info`](https://github.com/fractaal/pi-extensions/tree/HEAD/packages/codex-usage-info) | Codex/OpenAI usage statusline extension. |
| [`@fractaal/pi-directive-roots`](https://github.com/fractaal/pi-extensions/tree/HEAD/packages/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`](https://github.com/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

```bash
npm install
npm run typecheck
npm test
npm run build
```

Release (per package):

```bash
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](https://github.com/Jonghakseo/pi-extension) and moved here to live under fractaal ownership with proper npm publishing.