@piewf/cli 5.15.0 → 5.16.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 +43 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,43 @@
1
+ # @piewf/cli
2
+
3
+ Terminal commands for [pi-extensible-workflows](https://github.com/vekexasia/pi-extensible-workflows): `pi-role` starts Pi as a role, `piewf` operates workflows.
4
+
5
+ Requires Node.js 22.19 or newer and the `pi` command on `PATH`. This is trusted host code with the same filesystem and process access as Pi.
6
+
7
+ ```sh
8
+ npm install -g @piewf/cli
9
+ ```
10
+
11
+ ## pi-role
12
+
13
+ Start a regular Pi session with a role's model, tools, skills, extensions, and system prompt. Everything after the role name goes to Pi unchanged.
14
+
15
+ ```sh
16
+ pi-role # list the available roles
17
+ pi-role reviewer # interactive Pi as the reviewer role
18
+ pi-role scout -p "Where is the retry logic?" # one-shot prompt
19
+ pi-role developer --continue # resume the last session as the developer role
20
+ pi-role reviewer --approve # trust the project so its roles and settings apply
21
+ npx -p @piewf/cli pi-role oracle # without installing
22
+ ```
23
+
24
+ Roles come from the bundled starter roles, `~/.pi/agent/pi-extensible-workflows/roles/*.md`, and, in trusted projects, `.pi/pi-extensible-workflows/roles/*.md`. The [roles guide](https://vekexasia.github.io/pi-extensible-workflows/roles.html#pi-role) lists what each role field becomes on the Pi command line and the launcher's limits; the [role file reference](https://vekexasia.github.io/pi-extensible-workflows/roles.html#files) covers writing your own.
25
+
26
+ ## piewf
27
+
28
+ ```sh
29
+ piewf doctor [--role <role>] [--prompt <text>] [--json]
30
+ piewf doctor cleanup [--older-than-days <days>] [--yes]
31
+ piewf inspect [session-id] [--json|--summary] [--failed]
32
+ piewf transcript <session-file>
33
+ piewf run <workflow-name> [workflow arguments]
34
+ piewf run --script <workflow.js> [--name <workflow-name>] [--input <json>]
35
+ piewf export <workflow-name> [--name <command>] [--output <path>] [--force]
36
+ piewf bundle <workflow-name> [--name <command>] [--output <directory>] [--force]
37
+ ```
38
+
39
+ See [CLI operations](https://vekexasia.github.io/pi-extensible-workflows/developers.html#operations).
40
+
41
+ ## License
42
+
43
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@piewf/cli",
3
- "version": "5.15.0",
3
+ "version": "5.16.1",
4
4
  "description": "CLI for pi-extensible-workflows",
5
5
  "homepage": "https://vekexasia.github.io/pi-extensible-workflows/",
6
6
  "repository": {
@@ -45,7 +45,7 @@
45
45
  "@earendil-works/pi-coding-agent": "0.85.0",
46
46
  "@earendil-works/pi-server": "0.85.0",
47
47
  "@earendil-works/pi-tui": "0.85.0",
48
- "pi-extensible-workflows": "5.15.0",
48
+ "pi-extensible-workflows": "5.16.1",
49
49
  "typebox": "1.3.7"
50
50
  },
51
51
  "publishConfig": {