@agimon-ai/po-plan
Reviewable Pi planning mode that removes file-editing tools and persists implementation plans.
Package details
Install @agimon-ai/po-plan from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@agimon-ai/po-plan- Package
@agimon-ai/po-plan- Version
0.0.0-alpha.183- Published
- Nov 22, 2026
- Downloads
- 31.4K/mo · 5,080/wk
- Author
- agiflow-ai
- License
- BUSL-1.1
- Types
- extension
- Size
- 620.2 KB
- Dependencies
- 8 dependencies · 4 peers
Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@agimon-ai/po-plan
Explore a repository read-only, save a plan, and ask for explicit approval before implementation.
The seeded presets.yaml selects Plan in default.packages. It starts inactive and requires Node.js 24 or newer.
Planning and approval
Normal planning explores the repository and delegates where available. Debug planning separates verified evidence from hypotheses. Code Review planning reports actionable findings and proposes scoped fixes. All use the same stored-plan and explicit exit-approval flow.
Plan withholds edit and write, including from its delegated agents, but leaves other capabilities such as Bash available. Read-only exploration is an instruction, not OS isolation: Plan is not a sandbox or a repository permission boundary.
Present a complete Markdown plan with an H1, then call write_plan. It saves a unique file under the session artifact folder's plans/ directory when artifacts are available. Otherwise it uses plansDirectory, defaulting to ~/.po/plans.
After saving, complete_plan asks whether to start implementation or continue planning. Only the person's explicit exit approval ends planning. A model-restoration failure leaves Plan active and reports the failure.
Review and edit
The Activity dock's Plan row opens the saved document. Its source view saves edits back to that file and rejects a stale save instead of overwriting a newer version. The agent rereads the saved plan on each turn. The row remains available after implementation starts.
The session API is mounted under /api/workspaces/<workspace-id>/sessions/<session-id>/plugins/plans. Rebuild and reload the owning host after package changes; editing source alone does not update a running client.
Configuration
Set planning models and fallback storage in host ~/.po/config.yaml or repository .po/config.yaml:
modes:
planning:
main:
model: provider/planning-model
thinking: high
subagents:
model: provider/research-model
thinking: medium
plansDirectory: ~/.po/plans
main controls the planner and subagents the delegated research defaults. Provider calls consume quota. The fallback directory can be absolute, repository-relative, or under ~; session artifacts take precedence.
Development
Run pnpm build, pnpm typecheck, pnpm test, and pnpm lint from this package.
License
Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See LICENSE and https://agimon.ai/licensing.