---
slug: "pi-plan-build"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/vskrch/pi-plan-build@main/README.md"
repo: "https://github.com/vskrch/pi-plan-build"
source_file: "README.md"
branch: "main"
---
# pi-plan-build

Plan/Build mode toggle for [pi CLI](https://pi.dev) — opencode-style read-only plan ↔ full build mode.

## Install

```bash
pi install npm:pi-plan-build
```

## Usage

| Action | Effect |
|--------|--------|
| **Tab** | Toggle plan ↔ build mode |
| `/plan` | Toggle plan mode |
| `/todos` | Show plan progress |

**Plan mode** — read-only. Agent analyzes code and creates numbered plans. Only `read`, `bash` (safe commands), `grep`, `find`, `ls` available.

**Build mode** — full access. Agent executes the plan with `edit`, `write`, and all bash commands.

After creating a plan, a popup asks: *Execute / Stay / Refine*. Choosing "Execute" switches to build mode and tracks `[DONE:n]` markers with a progress widget.

## Author

Venkata Sai Chirasani

## License

MIT