A pi package that adds a planner mode.

• pi starts in PLAN mode by default
• /plan switches pi into planning mode
• /build switches pi back into implementation mode
• in PLAN mode, mutating system actions are blocked
• the active toolset is reduced to read-only tools
• current mode is shown in the footer status line
• planner mode is restored from session history

Install from GitHub:

pi install git:github.com/bwks/pi-planner

Install into the current project while developing from this repo:

pi install -l .

Load it for one run only from GitHub:

pi -e git:github.com/bwks/pi-planner

Or load this local repo for one run only:

pi -e .

After installing, reload pi if needed:

/reload

pi starts in PLAN mode by default.

Switch modes with:

/plan
/build

When PLAN mode is active:

• write, edit, bash, and other non-read-only tools are blocked
• user ! and !! shell commands are blocked
• pi is instructed to analyze, inspect, and plan instead of making changes

Read-only tools allowed in PLAN mode:

• read
• grep
• find
• ls

Run tests:

npm test

Test the package directly:

pi -e .