@agimon-ai/po-plan

Reviewable Pi planning mode that removes file-editing tools and persists implementation plans.

Packages

Package details

extension

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.