# 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