@workser/cli 0.6.12 → 0.6.13
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/AGENTS.md +7 -0
- package/dist/index.js +282 -206
- package/package.json +1 -1
- package/skills/workser/SKILL.md +14 -12
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@workser/cli",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.13",
|
|
4
4
|
"description": "Workser CLI — give your local AI agent native DevOps & infrastructure on Workser. The agent runs `workser …` to provision, deploy, and manage real apps.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
package/skills/workser/SKILL.md
CHANGED
|
@@ -30,7 +30,7 @@ load.
|
|
|
30
30
|
| Build an automation, or use Gmail/Slack/Stripe/Sheets | `workflow …`, `app …` | `workser help automation` |
|
|
31
31
|
| Generate an image | `image …` | `workser help images` |
|
|
32
32
|
| Hand a subtask to another agent | `agent …` | `workser help roles` |
|
|
33
|
-
|
|
|
33
|
+
| Recall across conversations; leave this task's team a fact | `memory …`, `workser note` | `workser help memory` |
|
|
34
34
|
| Record finished output, or ask the user a question | `artifact …`, `ask` | `workser help deliverables` |
|
|
35
35
|
| Control this machine — files, shell, screen, browser | `tool …` | `workser help computer-use` |
|
|
36
36
|
|
|
@@ -43,7 +43,7 @@ come from the CLI itself, so they match the version you are running.
|
|
|
43
43
|
workser status # connection + pinned project + latest deploy
|
|
44
44
|
workser whoami # who am I / which workspace
|
|
45
45
|
workser project show # the project pinned to this directory
|
|
46
|
-
workser project list #
|
|
46
|
+
workser project list # your organization's projects
|
|
47
47
|
workser verify # run typecheck/lint/build — gate "done" on this
|
|
48
48
|
workser doctor # resolved endpoint, mode, token presence, project
|
|
49
49
|
workser login # authenticate outside Orbit (CI/standalone)
|
|
@@ -52,24 +52,26 @@ workser logout # clear a saved standalone session
|
|
|
52
52
|
|
|
53
53
|
## Scope (read this)
|
|
54
54
|
|
|
55
|
-
You operate on **
|
|
55
|
+
You operate on **a project's own infrastructure**. You *can* provision and use it:
|
|
56
56
|
create the Neon database, read its connection string, browse its tables / rows / run
|
|
57
57
|
SQL, provision the bucket + auth, deploy, set env vars, manage files. Sensitive
|
|
58
|
-
actions are **gated**
|
|
59
|
-
(exit 5); say so, stop, don't loop (rule 5).
|
|
58
|
+
actions are **gated** (`awaiting_approval`, exit 5) — see rule 5.
|
|
60
59
|
|
|
61
60
|
What you **cannot** do is administer the project set or destroy config:
|
|
62
61
|
`project create` · `project use` · `env rm` · `domain set` return
|
|
63
62
|
`error.code = "owner_only"` (exit 6). Tell the user it's an owner action to do in
|
|
64
|
-
Orbit, then continue
|
|
65
|
-
|
|
63
|
+
Orbit, then continue.
|
|
64
|
+
|
|
65
|
+
**One organization.** The folder (or the project open in Workser) sets it. You
|
|
66
|
+
may move between its projects — `--project <id>`, or `cd`. Another org
|
|
67
|
+
returns `error.code = "out_of_scope"` (exit 7) and runs nothing.
|
|
66
68
|
|
|
67
69
|
## Golden rules
|
|
68
70
|
|
|
69
71
|
1. **Always pass `--json`.** Output is then a single stable line:
|
|
70
72
|
`{"ok":true,"data":...}` or `{"ok":false,"error":{"code","message",...}}`. Parse it.
|
|
71
73
|
2. **Orient first.** Run `workser status --json` to see the connection, the pinned
|
|
72
|
-
project, and the latest deploy before acting.
|
|
74
|
+
project, and the latest deploy before acting.
|
|
73
75
|
For anything beyond a trivial edit, also read what the project already knows:
|
|
74
76
|
`workser decision list --json` (what was already decided, so you don't quietly
|
|
75
77
|
reverse it), and `workser design show --json` before writing UI. This project
|
|
@@ -80,10 +82,10 @@ pick or switch it.
|
|
|
80
82
|
`doc create`, plus `decision create` for a real tradeoff. A plan in your
|
|
81
83
|
reply alone is gone when the conversation scrolls. How to correct a wrong
|
|
82
84
|
row, and what not to link: `workser help sdlc-entities`.
|
|
83
|
-
4. **Stay in your lane.** `
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
85
|
+
4. **Stay in your lane.** On `owner_only` (exit 6) or `out_of_scope` (exit 7),
|
|
86
|
+
don't retry or look for a workaround — tell the user, then continue.
|
|
87
|
+
Provisioning the *pinned project's own* db / bucket / auth is allowed (it may
|
|
88
|
+
be approval-gated, not owner-only).
|
|
87
89
|
5. **Approvals are normal — likely unattended, nobody watching.** An action may
|
|
88
90
|
return `{"error":{"code":"awaiting_approval"}}` (exit 5). Say so, **stop this
|
|
89
91
|
turn** — never a retry loop or sleep-and-recheck, it just times out. Works next
|