Pi Extensions — Dev Collection

Local development workspace for Pi Coding Agent extensions.

What this is

This repo (C:/10x001/pi extensions/) is the dev workspace. Extensions are edited and type-checked here, then the user copies them to the Pi runtime folder and restarts Pi.

• Dev workspace: C:/10x001/pi extensions/
• Runtime folder: ~/.pi/agent/extensions/
• Extensions are not installed via pi install from this workspace.

See AGENTS.md and docs/pi-workflow.md for the full workflow.

Active extensions

a-rewind          — guard against fake tool-call announcements; manual rewind
auto-trust        — auto-approve safe commands
context-guard     — prompt cleanup, tool gating, skill control
context-trim      — manual superseded full-read trim for cold starts (/trim)
grep-tool         — project-wide grep override
model-manager     — dynamic provider/model registration, /mm TUI
pi-multi-edit     — exact-replacement edit, batch, and insert tools
pi-session-memory — semantic search over past sessions via 0x010
pi-web-search     — web search/fetch/code search via 0x010 MCP
read-mode         — mode-aware read tool (overview/section/grep/headtail/raw)
role-sw           — role injection and persistence
simple-gate       — path/command permission gate
sub-agents        — child pi agents (/handoff, /sub-agents)
tool-timestamps   — TUI-only tool execution timestamps (inline entry renderers)

Each active extension is documented in docs/extensions/<name>.md.

Archived extensions

The following extensions were moved to Inactive/ by the user and are no longer active:

• agent-browser — gated browser automation wrapper.
• context-compressor — lightweight same-model context compression with KEY FACTS.
• pi-project-memory — vector project facts + todos via 0x010.
• strip-cache-retention — single-file experiment altering cache_control retention.

Do not treat their docs/extensions/<name>.md pages as current source of truth unless they are explicitly re-activated.

Type-checking

npm run typecheck

Run this before committing code or package changes. Pure documentation changes do not require it, but run it if unsure.

Dependencies

• Pi core packages (@earendil-works/*, typebox) are listed as peerDependencies in each extension and provided by Pi at runtime.
• Normal npm packages used by an extension are installed once in the shared runtime: ~/.pi/agent/.
• Dev types are installed in the local node_modules/ from the root package.json.

Tests

python scripts/run-tests.py

Compiles and runs the unit-test suite in tests/unit/. Run it alongside npm run typecheck for code changes.

Scripts

Utility scripts live in scripts/:

• scripts/run-tests.py — compile and run unit tests.
• scripts/check-pi-sync.py — Pi CLI upgrade compatibility check.
• scripts/pi_session_inspect.py — session log forensics.
• scripts/pi-session-compressor-tune.py — tuning helper for the archived context-compressor extension (kept for reference).

Skills

skills/ holds development copies of Pi agent skills (currently kimi-webbridge and skill-craft). They are edited here and copied to ~/.pi/agent/skills/ manually, just like extensions.

Documentation

AGENTS.md is the single index (auto-loaded by Pi): rules, map, commands, and the full docs table with "read when" triggers.

Entry points:

• AGENTS.md — quick rules and navigation.
• docs/pi-workflow.md — dev vs runtime, sync, dependencies.
• docs/interactions.md — cross-extension and runtime wiring map.
• docs/extensions/<name>.md — per-extension agent guide.
• docs/git-policy.md — how agents commit in this shared repo.

Git

Agents manage git locally: small prefixed commits, no push. See docs/git-policy.md.

Extension lifecycle (enable, disable, copy to runtime, archive) is managed by the user, not by agents.