@juicesharp/rpiv-pi 0.4.1 → 0.4.2
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 +41 -25
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -3,12 +3,12 @@
|
|
|
3
3
|
[](https://www.npmjs.com/package/@juicesharp/rpiv-pi)
|
|
4
4
|
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
|
-
Skill-based development workflow for [Pi](https://github.com/badlogic/pi-mono) — research, design, plan, implement, validate. rpiv-pi extends
|
|
6
|
+
Skill-based development workflow for [Pi Agent](https://github.com/badlogic/pi-mono) — discover, research, design, plan, implement, and validate. rpiv-pi extends Pi Agent with a pipeline of chained AI skills, named subagents for parallel analysis, and session lifecycle hooks for automatic context injection.
|
|
7
7
|
|
|
8
8
|
## Prerequisites
|
|
9
9
|
|
|
10
|
-
- **[Pi
|
|
11
|
-
- **Node.js** — required by Pi
|
|
10
|
+
- **[Pi Agent](https://github.com/badlogic/pi-mono)** — the `pi` command must be available
|
|
11
|
+
- **Node.js** — required by Pi Agent
|
|
12
12
|
- **git** *(recommended)* — rpiv-pi works without it, but branch and commit context won't be available to skills
|
|
13
13
|
|
|
14
14
|
## Quick Start
|
|
@@ -19,15 +19,47 @@ Skill-based development workflow for [Pi](https://github.com/badlogic/pi-mono)
|
|
|
19
19
|
pi install npm:@juicesharp/rpiv-pi
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
2.
|
|
22
|
+
2. Configure a model provider (pick one):
|
|
23
|
+
|
|
24
|
+
- **Subscription login** — start Pi Agent and run `/login` to authenticate with Anthropic Claude Pro/Max, ChatGPT Plus/Pro, GitHub Copilot, or Gemini.
|
|
25
|
+
- **BYOK (API key)** — edit `~/.pi/agent/models.json` and add a provider entry with `baseUrl`, `api`, `apiKey`, and `models[]`. Example (z.ai GLM coding plan):
|
|
26
|
+
|
|
27
|
+
```json
|
|
28
|
+
{
|
|
29
|
+
"providers": {
|
|
30
|
+
"zai": {
|
|
31
|
+
"baseUrl": "https://api.z.ai/api/coding/paas/v4",
|
|
32
|
+
"api": "openai-completions",
|
|
33
|
+
"apiKey": "XXXXXXXXX",
|
|
34
|
+
"compat": {
|
|
35
|
+
"supportsDeveloperRole": false,
|
|
36
|
+
"thinkingFormat": "zai"
|
|
37
|
+
},
|
|
38
|
+
"models": [
|
|
39
|
+
{
|
|
40
|
+
"id": "glm-5.1",
|
|
41
|
+
"name": "glm-5.1 [coding plan]",
|
|
42
|
+
"reasoning": true,
|
|
43
|
+
"input": ["text"],
|
|
44
|
+
"cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
|
|
45
|
+
"contextWindow": 204800,
|
|
46
|
+
"maxTokens": 131072
|
|
47
|
+
}
|
|
48
|
+
]
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
3. Start a Pi Agent session and install sibling plugins:
|
|
23
55
|
|
|
24
56
|
```
|
|
25
57
|
/rpiv-setup
|
|
26
58
|
```
|
|
27
59
|
|
|
28
|
-
|
|
60
|
+
4. Restart your Pi Agent session.
|
|
29
61
|
|
|
30
|
-
|
|
62
|
+
5. *(Optional)* Configure web search:
|
|
31
63
|
|
|
32
64
|
```
|
|
33
65
|
/web-search-config
|
|
@@ -35,7 +67,7 @@ pi install npm:@juicesharp/rpiv-pi
|
|
|
35
67
|
|
|
36
68
|
### First Session
|
|
37
69
|
|
|
38
|
-
On first session start, rpiv-pi automatically:
|
|
70
|
+
On first Pi Agent session start, rpiv-pi automatically:
|
|
39
71
|
- Copies agent profiles to `<cwd>/.pi/agents/`
|
|
40
72
|
- Detects outdated or removed agents on subsequent starts
|
|
41
73
|
- Scaffolds `thoughts/shared/` directories for pipeline artifacts
|
|
@@ -57,7 +89,7 @@ Each skill produces an artifact consumed by the next. Run them in order, or jump
|
|
|
57
89
|
|
|
58
90
|
### Skills
|
|
59
91
|
|
|
60
|
-
Invoke via `/skill:<name>` from inside a Pi session.
|
|
92
|
+
Invoke via `/skill:<name>` from inside a Pi Agent session.
|
|
61
93
|
|
|
62
94
|
#### Research & Design
|
|
63
95
|
|
|
@@ -137,7 +169,7 @@ rpiv-pi/
|
|
|
137
169
|
└── thoughts/shared/ — pipeline artifact store
|
|
138
170
|
```
|
|
139
171
|
|
|
140
|
-
Pi discovers extensions via `"extensions": ["./extensions"]` and skills via `"skills": ["./skills"]` in `package.json`.
|
|
172
|
+
Pi Agent discovers extensions via `"extensions": ["./extensions"]` and skills via `"skills": ["./skills"]` in `package.json`.
|
|
141
173
|
|
|
142
174
|
## Configuration
|
|
143
175
|
|
|
@@ -146,22 +178,6 @@ Pi discovers extensions via `"extensions": ["./extensions"]` and skills via `"sk
|
|
|
146
178
|
- **Agent concurrency** — `@tintinweb/pi-subagents` defaults to 4 concurrent agents; raise via `/agents → Settings → Max concurrency → 48` if skills stall on wide fan-outs
|
|
147
179
|
- **Agent profiles** — editable at `<cwd>/.pi/agents/`; sync from bundled defaults with `/rpiv-update-agents` (overwrites rpiv-managed files, preserves your custom agents)
|
|
148
180
|
|
|
149
|
-
## Upgrading from 0.3.x
|
|
150
|
-
|
|
151
|
-
Tool logic was extracted into sibling plugins in 0.4.0. After upgrading:
|
|
152
|
-
|
|
153
|
-
1. `pi install npm:@juicesharp/rpiv-pi`
|
|
154
|
-
2. Start a Pi session.
|
|
155
|
-
3. Run `/rpiv-setup` to install the four extracted plugins:
|
|
156
|
-
- `@juicesharp/rpiv-ask-user-question`
|
|
157
|
-
- `@juicesharp/rpiv-todo`
|
|
158
|
-
- `@juicesharp/rpiv-advisor`
|
|
159
|
-
- `@juicesharp/rpiv-web-tools`
|
|
160
|
-
4. Restart the session.
|
|
161
|
-
5. Re-run `/advisor` and `/web-search-config` — saved configuration at `~/.config/rpiv-pi/` is no longer read; each plugin now reads from its own config path.
|
|
162
|
-
|
|
163
|
-
The `BRAVE_SEARCH_API_KEY` environment variable continues to work unchanged.
|
|
164
|
-
|
|
165
181
|
## Troubleshooting
|
|
166
182
|
|
|
167
183
|
| Symptom | Cause | Fix |
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@juicesharp/rpiv-pi",
|
|
3
|
-
"version": "0.4.
|
|
4
|
-
"description": "Skill-based development workflow for Pi — research, design, plan, implement,
|
|
3
|
+
"version": "0.4.2",
|
|
4
|
+
"description": "Skill-based development workflow for Pi Agent — discover, research, design, plan, implement, validate",
|
|
5
5
|
"keywords": ["pi-package", "pi-extension", "rpiv", "skills", "workflow"],
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"author": "juicesharp",
|