wow-pi

A small extension pack for the pi coding agent.

Install for local development

bun install
pi install <wow-pi directory>

Or test once:

pi -e <wow-pi directory>

Configuration

wow-pi reads JSON or YAML config from both global and project locations, in order:

1. ~/.pi/agent/wow.json, ~/.pi/agent/wow.yaml, ~/.pi/agent/wow.yml
2. <project>/.pi/wow.json, <project>/.pi/wow.yaml, <project>/.pi/wow.yml

Project config extends global config. Array fields are merged and de-duplicated; object fields are shallow-merged. statusline accepts a boolean or a partial config object — see wow.example.yaml for the full surface.

Packages

This repo is organized as a workspace monorepo:

• packages/wow-core: shared config, module registry, logger, UI helpers, and ${protocol:value} resolvers.
• packages/wow-contexts: self-registering Markdown context injector with /wow:contexts:list, /wow:contexts:reload, and /wow:init.
• packages/wow-inject: self-registering env loader that reads .env files and resolves ${file:...} / ${env:...} into process.env.
• packages/wow-pi: pi extension entry point; imports feature packages for side-effect registration, then runs registered modules.
• packages/wow-statusline: customized statusline/footer module built on pi's supported UI APIs.

Logs are written to ~/.pi/agent/wow/logs/.