@lebronj/pi-suite 0.1.9 → 0.1.11
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.
- package/README.md +46 -9
- package/extensions/autogoal.ts +1302 -0
- package/package.json +1 -1
- package/prompts/commit.md +83 -0
- package/prompts/review.md +67 -0
- package/scripts/bootstrap.sh +4 -0
- package/skills/pi-skill/SKILL.md +19 -2
package/README.md
CHANGED
|
@@ -7,9 +7,6 @@ JHP's Pi extension suite for team coding workflows.
|
|
|
7
7
|
```bash
|
|
8
8
|
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
|
|
9
9
|
pi install npm:@lebronj/pi-suite
|
|
10
|
-
pi install npm:pi-web-access
|
|
11
|
-
pi install npm:pi-mcp-adapter
|
|
12
|
-
pi install npm:pi-subagents
|
|
13
10
|
```
|
|
14
11
|
|
|
15
12
|
Or use the bootstrap script to install Pi, configure the team OpenAI-compatible endpoint, install this suite, and set up Bun + qmd for memory search:
|
|
@@ -20,17 +17,25 @@ curl -fsSL https://registry.npmjs.org/@lebronj/pi-suite/-/pi-suite-0.1.8.tgz | t
|
|
|
20
17
|
|
|
21
18
|
## What Is Included
|
|
22
19
|
|
|
23
|
-
- Local extensions: goal mode, pet, prompt URL widget, TUI redraw stats, snake, TPS notifications.
|
|
24
|
-
- Prompts: changelog audit, issue analysis, PR review, wrap workflow.
|
|
20
|
+
- Local extensions: autogoal, goal mode, pet, prompt URL widget, TUI redraw stats, snake, TPS notifications.
|
|
21
|
+
- Prompts: changelog audit, issue analysis, PR review, review workflow, commit workflow, wrap workflow.
|
|
25
22
|
- Skills: provider checklist, weather, LeetCode array practice, Pi capability reference, image-to-editable-PPT workflow.
|
|
26
23
|
- Vendored package: `@jhp/pi-memory`, including qmd search, external curator service, and memory/skill-draft versioning.
|
|
27
24
|
|
|
28
|
-
|
|
25
|
+
`pi-mcp-adapter`, `pi-subagents`, and `pi-web-access` are loaded by this suite. Do not install them separately unless you filter suite resources, because duplicate extension tools/flags can conflict.
|
|
26
|
+
|
|
27
|
+
Figma is not installed or loaded by default. Enable it only when needed:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
pi install npm:pi-mono-figma
|
|
31
|
+
# then run /reload or restart pi
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
Disable Figma later with:
|
|
29
35
|
|
|
30
36
|
```bash
|
|
31
|
-
pi
|
|
32
|
-
|
|
33
|
-
pi install npm:pi-subagents
|
|
37
|
+
pi remove npm:pi-mono-figma
|
|
38
|
+
# then run /reload or restart pi
|
|
34
39
|
```
|
|
35
40
|
|
|
36
41
|
Debug-only extensions are intentionally excluded:
|
|
@@ -39,6 +44,30 @@ Debug-only extensions are intentionally excluded:
|
|
|
39
44
|
- `zz-full-session-log.ts`
|
|
40
45
|
- `agentmemory`
|
|
41
46
|
|
|
47
|
+
## Autogoal
|
|
48
|
+
|
|
49
|
+
`/autogoal <task>` starts a bounded autonomous coding run. It persists the objective, auto-continues with loop budgets, checkpoints at high context usage, and can continue in a fresh session when the context window gets tight.
|
|
50
|
+
|
|
51
|
+
Useful commands:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
/autogoal <task>
|
|
55
|
+
/autogoal status
|
|
56
|
+
/autogoal pause
|
|
57
|
+
/autogoal resume
|
|
58
|
+
/autogoal checkpoint optional reason
|
|
59
|
+
/autogoal drop
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Behavior:
|
|
63
|
+
|
|
64
|
+
- 60% context: prepare and stay concise.
|
|
65
|
+
- 75% context: write a structured checkpoint soon.
|
|
66
|
+
- 85% context: checkpoint and switch to a new session.
|
|
67
|
+
- Completion requires current-state evidence: changed files read after edits and a passing validation command.
|
|
68
|
+
- Subagents are optional and budgeted; worker subagents must use worktree isolation.
|
|
69
|
+
- Run artifacts are written under `~/.pi/agent/workflow-runs/autogoal-<run-id>/`.
|
|
70
|
+
|
|
42
71
|
## Team Model Setup
|
|
43
72
|
|
|
44
73
|
The bootstrap script can be run with `curl | bash`: it reads the API key from the terminal instead of stdin. It asks for an API key and writes:
|
|
@@ -81,6 +110,14 @@ Useful commands:
|
|
|
81
110
|
|
|
82
111
|
Memory evolution is local-only by default and does not configure a shared remote. If a user wants backup sync, set `PI_EVOLUTION_REMOTE` to their own private repo before bootstrap/setup, or add a personal remote later with `git -C ~/.pi/agent/evolution remote add origin <url>`. Set `PI_EVOLUTION_AUTO_PUSH=1` only if automatic remote sync is desired.
|
|
83
112
|
|
|
113
|
+
## Review And Commit Workflows
|
|
114
|
+
|
|
115
|
+
Use `/review [target] [--fix] [--comment] [--summary]` to inspect current diffs, branch ranges, or PRs with findings first and a verdict last. It is local-only by default: GitHub comments are drafted first and posted only after explicit confirmation.
|
|
116
|
+
|
|
117
|
+
Use `/commit [message|split|pr|apply]` to inspect current changes, warn about mixed concerns, draft commit messages, suggest split points, or draft PR text. It does not stage, commit, or push unless you explicitly confirm the exact action.
|
|
118
|
+
|
|
119
|
+
These workflows are prompt-template workflows only. They do not merge read behavior, add tool discovery, rewrite memory/skills, or run as hidden background processes.
|
|
120
|
+
|
|
84
121
|
## Goal Mode
|
|
85
122
|
|
|
86
123
|
Use `/goal <objective>` to keep Pi working on one task until it is verified complete. Goal mode injects hidden task context, enables a `goal` tool for completion/drop/resume, and auto-continues between turns instead of stopping at a minimal implementation.
|