pi-mplan0.2.3
Plan + AGENTS.md generator extension for Pi. Automates creating plan.md and AGENTS.md for your projects from your own templates
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-mplan
Plan + AGENTS.md generator extension for Pi.
pi-mplan creates plan.md and AGENTS.md for a project from your templates.
It first writes a deterministic scaffold from real repository facts (scripts,
layout, README), then hands the agent a refinement instruction so it completes
the files with actual project knowledge. The scaffold is always written, so you
get a usable result even without an LLM turn.
Features
/mplancommand andcreate_plantool- Templates resolved from project, user, then bundled defaults
- Multi-toolchain detection (npm, Cargo, Go, Python, Make)
- LLM refinement of leftover placeholders
- Verify, sync, and safe atomic writes
Install
pi install npm:pi-mplan
From a local checkout:
pnpm build
pnpm pack
pi install ./pi-mplan-0.1.0.tgz
Usage
| Command | Action |
|---|---|
/mplan |
Generate + refine both files |
/mplan plan |
Generate/refine plan.md only |
/mplan agents |
Generate/refine AGENTS.md only |
/mplan init |
Copy templates into .pi/pimplan/ |
/mplan scaffold |
Deterministic scaffold only |
/mplan verify |
Report leftover placeholders |
/mplan sync |
Pull personal templates from the agentic repo |
/mplan help |
Show help |
The create_plan tool lets the agent generate files too. Call it with
target: all | plan | agents (optionally scaffoldTemplates: true).
Development
pnpm install # install deps
pnpm check # typecheck + lint
pnpm test # run vitest
pnpm build # bundle with tsup
The Makefile mirrors these (make check, make test, make build, ...).
See CONFIG.md for template resolution details, the placeholder reference, toolchain detection, and the extend-your-own layout guide.
License
MIT