@burneikis/pi-plan 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +14 -10
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,6 +1,14 @@
1
1
  # Pi Plan
2
2
 
3
- A [pi](https://github.com/badlogic/pi-mono) extension that adds a `/plan` command for structured plan-driven development. The agent creates a plan, you review and edit it, then the agent executes it in a fresh session.
3
+ A [pi](https://github.com/badlogic/pi-mono) extension that brings Claude Code-style plan mode to pi. Run `/plan`, let the agent explore your codebase and draft a step-by-step plan, review and refine it, then execute in a clean session with full context.
4
+
5
+ ## Features
6
+
7
+ - **Claude Code-style plan mode** — Agent analyzes your codebase read-only, then produces an actionable plan before touching anything
8
+ - **Fresh context execution** — Plans execute in a new session so the agent starts clean, with only the plan as context
9
+ - **Manual editing via `$EDITOR`** — Open the plan in your preferred editor (vim, nvim, etc.) for hands-on changes
10
+ - **Conversational edits** — Describe changes in natural language and the agent rewrites the plan for you
11
+ - **Persistent plans** — Plans are saved to `~/.pi/agent/plans/<session_id>/plan.md` and survive restarts
4
12
 
5
13
  ## Installation
6
14
 
@@ -22,17 +30,13 @@ pi -e npm:@burneikis/pi-plan
22
30
 
23
31
  ## Flow
24
32
 
25
- 1. **Plan** — You run `/plan <description>`. The agent explores the codebase and writes a `plan.md` file.
33
+ 1. **Plan** — You run `/plan <description>`. The agent explores the codebase (read-only) and writes a `plan.md` file.
26
34
  2. **Review** — You're prompted with options:
27
- - **Ready** — Execute the plan in a new session
28
- - **Edit** — Describe changes, agent rewrites the plan
29
- - **Open in $EDITOR** — Edit the plan file manually
35
+ - **Ready** — Execute the plan in a new session with cleared context
36
+ - **Edit** — Describe changes in natural language, agent rewrites the plan
37
+ - **Open in $EDITOR** — Edit the plan file manually in your terminal editor
30
38
  - **Cancel** — Discard and return to normal mode
31
- 3. **Execute** — A new session starts with the plan as context and full tool access.
32
-
33
- ## Plan Storage
34
-
35
- Plans are stored at `~/.pi/agent/plans/<session_id>/plan.md` and persist across restarts.
39
+ 3. **Execute** — A fresh session starts with only the plan as context and full tool access.
36
40
 
37
41
  ## Plan Format
38
42
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@burneikis/pi-plan",
3
- "version": "1.0.0",
4
- "description": "A pi extension for structured plan-driven development",
3
+ "version": "1.0.1",
4
+ "description": "Claude Code-style plan mode for pi — create, review, edit, and execute structured plans in a fresh context",
5
5
  "keywords": [
6
6
  "pi-package"
7
7
  ],