@keystrokehq/cli 0.0.97 → 0.0.99
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.
|
@@ -22,10 +22,15 @@ keystroke config use cloud # switch back to deployed project
|
|
|
22
22
|
keystroke config use project <id> # swap active cloud project
|
|
23
23
|
keystroke --project <id> workflow run foo --input '{}' # one-off cloud target
|
|
24
24
|
keystroke config show # inspect activeProjectId, apiTarget, dev session
|
|
25
|
+
keystroke project list # platform deploy targets in the active org
|
|
26
|
+
keystroke project create --name "My app" # new target (inactive until deploy)
|
|
27
|
+
keystroke deploy --project <id> # build + upload; activates cloud runtime
|
|
25
28
|
```
|
|
26
29
|
|
|
27
30
|
`keystroke auth login` once — token is shared; switching targets does not require re-auth.
|
|
28
31
|
|
|
32
|
+
**Platform project** = cloud deploy target (managed by the control plane). **Local project** = this repo (`src/`, `keystroke.config.ts`). You need a platform project id before `keystroke deploy`.
|
|
33
|
+
|
|
29
34
|
Full routing rules: [cli skill](.agents/skills/cli/SKILL.md) → [api-targets.md](.agents/skills/cli/references/api-targets.md).
|
|
30
35
|
|
|
31
36
|
## Run locally (fastest path)
|
|
@@ -30,6 +30,19 @@ keystroke config use org # interactive switch
|
|
|
30
30
|
keystroke config use org <id> # switch active org
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
+
## Platform projects
|
|
34
|
+
|
|
35
|
+
A **platform project** is a deploy target on the keystroke control plane — not your local repo directory (`keystroke init` scaffolds the latter).
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
keystroke project list
|
|
39
|
+
keystroke project create --name "My app" --description "Optional"
|
|
40
|
+
keystroke deploy --project <id> # build, upload, activate runtime
|
|
41
|
+
keystroke config use project <id> # set default cloud target (works before deploy)
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
New projects are **inactive** until deploy. You can set the default project before deploy; runtime commands still require an active project. The CLI prints hints when the list is empty or when status is `inactive`.
|
|
45
|
+
|
|
33
46
|
## Quick start
|
|
34
47
|
|
|
35
48
|
**Local development**
|
|
@@ -45,6 +58,7 @@ keystroke agent prompt hello --message "Hi"
|
|
|
45
58
|
|
|
46
59
|
```bash
|
|
47
60
|
keystroke auth login
|
|
61
|
+
keystroke project list # or: project create --name "My app"
|
|
48
62
|
keystroke deploy --project <project-id>
|
|
49
63
|
keystroke workflow run greeting --input '{"name":"Ada"}' # hits cloud after deploy
|
|
50
64
|
keystroke trigger list
|
|
@@ -93,6 +107,7 @@ Full detail: [api-targets.md](references/api-targets.md).
|
|
|
93
107
|
| Command | Typical target |
|
|
94
108
|
| ------------------------------------------------------------------ | ---------------------------------------------------------- |
|
|
95
109
|
| `dev`, `start`, `build` | Local project only |
|
|
110
|
+
| `project list`, `project create` | Platform control plane (org-scoped) |
|
|
96
111
|
| `deploy` | Platform (sets `activeProjectId` + `apiTarget=platform`) |
|
|
97
112
|
| `workflow`, `agent`, `trigger`, `credentials`, `connect`, `health` | Follows resolved target |
|
|
98
113
|
| `auth login` | Web dashboard (`webUrl`); token reused for cloud API calls |
|
|
@@ -58,6 +58,19 @@ keystroke --project proj_xyz workflow runs list my-workflow
|
|
|
58
58
|
| `--local` | Force local `serverUrl` for this command |
|
|
59
59
|
| `--project <id>` | Force platform runtime for that project; does not update `activeProjectId` |
|
|
60
60
|
|
|
61
|
+
## Platform projects
|
|
62
|
+
|
|
63
|
+
Platform projects are deploy targets on the control plane. List or create them before the first deploy:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
keystroke project list
|
|
67
|
+
keystroke project create --name "My app"
|
|
68
|
+
keystroke deploy --project <id> # activates runtime; sets activeProjectId
|
|
69
|
+
keystroke config use project <id> # swap default cloud target
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
New projects start **inactive**. The CLI hints with `keystroke deploy --project <id>` when appropriate.
|
|
73
|
+
|
|
61
74
|
## When agents should choose local
|
|
62
75
|
|
|
63
76
|
- User is editing `src/` and wants to test a workflow or agent change
|