copilotkit 4.25.1 → 4.26.0
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 +15 -10
- package/cli-build-info.json +6 -6
- package/index.js +795 -716
- package/onboarding/index.json +2 -2
- package/onboarding/prompts/authenticate/start.md +13 -13
- package/onboarding/prompts/conversion/plan.md +3 -3
- package/onboarding/prompts/credentials/finalize-plan.md +13 -13
- package/onboarding/prompts/credentials/plan.md +23 -23
- package/onboarding/prompts/credentials/settle-credentials.md +8 -7
- package/onboarding/prompts/credentials/write-plan.md +7 -7
- package/onboarding/prompts/deployment/choose-local.md +10 -10
- package/onboarding/prompts/deployment/local-evaluation.md +7 -7
- package/onboarding/prompts/fallback/best-effort.md +6 -6
- package/onboarding/prompts/feature/a2ui/implement.md +4 -4
- package/onboarding/prompts/feature/a2ui/plan.md +3 -3
- package/onboarding/prompts/feature/a2ui/proof.md +5 -5
- package/onboarding/prompts/feature/a2ui/start.md +8 -8
- package/onboarding/prompts/feature/channels/implement.md +6 -6
- package/onboarding/prompts/feature/channels/plan.md +3 -3
- package/onboarding/prompts/feature/channels/proof.md +5 -5
- package/onboarding/prompts/feature/channels/start.md +8 -8
- package/onboarding/prompts/feature/chat-suggestions/implement.md +4 -4
- package/onboarding/prompts/feature/chat-suggestions/plan.md +3 -3
- package/onboarding/prompts/feature/chat-suggestions/proof.md +5 -5
- package/onboarding/prompts/feature/chat-suggestions/start.md +8 -8
- package/onboarding/prompts/feature/complete.md +2 -2
- package/onboarding/prompts/feature/learning/implement.md +12 -12
- package/onboarding/prompts/feature/learning/plan.md +4 -4
- package/onboarding/prompts/feature/learning/proof.md +12 -12
- package/onboarding/prompts/feature/learning/start.md +8 -8
- package/onboarding/prompts/feature/open-generative-ui/implement.md +4 -4
- package/onboarding/prompts/feature/open-generative-ui/plan.md +3 -3
- package/onboarding/prompts/feature/open-generative-ui/proof.md +5 -5
- package/onboarding/prompts/feature/open-generative-ui/start.md +8 -8
- package/onboarding/prompts/feature/realtime-sync/implement.md +5 -5
- package/onboarding/prompts/feature/realtime-sync/plan.md +3 -3
- package/onboarding/prompts/feature/realtime-sync/proof.md +5 -5
- package/onboarding/prompts/feature/realtime-sync/start.md +7 -7
- package/onboarding/prompts/feature/rich-threads/implement.md +6 -6
- package/onboarding/prompts/feature/rich-threads/plan.md +3 -3
- package/onboarding/prompts/feature/rich-threads/proof.md +5 -5
- package/onboarding/prompts/feature/rich-threads/start.md +7 -7
- package/onboarding/prompts/feature/stop.md +4 -4
- package/onboarding/prompts/feature/voice/implement.md +4 -4
- package/onboarding/prompts/feature/voice/plan.md +4 -4
- package/onboarding/prompts/feature/voice/proof.md +5 -5
- package/onboarding/prompts/feature/voice/start.md +8 -8
- package/onboarding/prompts/framework/ag2.md +2 -2
- package/onboarding/prompts/framework/agno.md +2 -2
- package/onboarding/prompts/framework/built-in.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-python.md +2 -2
- package/onboarding/prompts/framework/claude-sdk-typescript.md +2 -2
- package/onboarding/prompts/framework/crewai-flows.md +3 -3
- package/onboarding/prompts/framework/custom-ag-ui.md +3 -3
- package/onboarding/prompts/framework/deep-agents.md +2 -2
- package/onboarding/prompts/framework/google-adk.md +2 -2
- package/onboarding/prompts/framework/langgraph-fastapi.md +2 -2
- package/onboarding/prompts/framework/langgraph-python.md +2 -2
- package/onboarding/prompts/framework/langgraph-typescript.md +2 -2
- package/onboarding/prompts/framework/llamaindex.md +2 -2
- package/onboarding/prompts/framework/mastra.md +2 -2
- package/onboarding/prompts/framework/ms-agent-dotnet.md +4 -4
- package/onboarding/prompts/framework/ms-agent-harness-dotnet.md +4 -4
- package/onboarding/prompts/framework/ms-agent-python.md +2 -2
- package/onboarding/prompts/framework/pydantic-ai.md +2 -2
- package/onboarding/prompts/framework/strands-python.md +2 -2
- package/onboarding/prompts/framework/strands-typescript.md +2 -2
- package/onboarding/prompts/frontend/angular.md +4 -4
- package/onboarding/prompts/frontend/nextjs.md +4 -4
- package/onboarding/prompts/frontend/plan.md +8 -8
- package/onboarding/prompts/frontend/react-native.md +3 -3
- package/onboarding/prompts/frontend/react-spa.md +3 -3
- package/onboarding/prompts/frontend/vue.md +3 -3
- package/onboarding/prompts/implementation/build-and-validate.md +10 -10
- package/onboarding/prompts/proof/complete.md +3 -3
- package/onboarding/prompts/proof/oss-baseline.md +5 -5
- package/onboarding/prompts/proof/round-trip.md +10 -10
- package/onboarding/prompts/research/gather.md +8 -8
- package/onboarding/prompts/research/merge.md +3 -3
- package/onboarding/prompts/research/preflight.md +2 -2
- package/onboarding/prompts/research/route.md +4 -4
- package/onboarding/prompts/setup/questions.md +31 -29
- package/onboarding/prompts/starter/clone.md +23 -23
- package/onboarding/prompts/stopped/run-failed.md +3 -3
- package/onboarding/prompts/subagent/create-plan.md +9 -5
- package/onboarding/prompts/subagent/implement-and-validate.md +6 -3
- package/onboarding/prompts/subagent/inspect-repository.md +1 -1
- package/onboarding/prompts/subagent/prove-oss-baseline.md +1 -1
- package/onboarding/prompts/subagent/prove-round-trip.md +5 -5
- package/onboarding/prompts/unsupported/no-validated-path.md +3 -3
- package/package.json +1 -1
package/onboarding/index.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"graphTree": "
|
|
2
|
+
"graphTree": "62f012b65ba17a579b853bdbbd55bc81dc4759ac",
|
|
3
3
|
"intentRoots": {
|
|
4
4
|
"add-a2ui": "feature/a2ui/start",
|
|
5
5
|
"add-chat-suggestions": "feature/chat-suggestions/start",
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
"add-rich-threads": "feature/rich-threads/start",
|
|
10
10
|
"add-voice": "feature/voice/start"
|
|
11
11
|
},
|
|
12
|
-
"packageSpec": "copilotkit@4.
|
|
12
|
+
"packageSpec": "copilotkit@4.26.0",
|
|
13
13
|
"root": "authenticate/start",
|
|
14
14
|
"prompts": [
|
|
15
15
|
{
|
|
@@ -13,7 +13,7 @@ Intelligence has a free Developer plan, and this run needs no paid subscription.
|
|
|
13
13
|
|
|
14
14
|
Run each CLI call exactly as written, as its own command: no pipe, `tee`, `&&`, redirect,
|
|
15
15
|
or variable prefix. Every CLI call in this run matches the prefix rule
|
|
16
|
-
`["npx", "--prefer-offline", "--yes", "copilotkit@4.
|
|
16
|
+
`["npx", "--prefer-offline", "--yes", "copilotkit@4.26.0"]`. If a command can request
|
|
17
17
|
escalation with a prefix rule, request this one on the `onboard identify` call. If your
|
|
18
18
|
harness asks the developer to approve commands, tell them one approval of that prefix covers
|
|
19
19
|
every CLI call. Say then that the install, the dev servers, `curl` to the local app, and
|
|
@@ -23,7 +23,7 @@ Never add or edit a permission rule or a settings file yourself. That choice bel
|
|
|
23
23
|
the developer.
|
|
24
24
|
|
|
25
25
|
If your harness refuses a CLI call without asking the developer, do not retry it or run it
|
|
26
|
-
another way. Report the pause: `npx --prefer-offline --yes copilotkit@4.
|
|
26
|
+
another way. Report the pause: `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer`.
|
|
27
27
|
Name the refused command, ask the developer to approve it or to switch to a
|
|
28
28
|
mode that asks them, and end your turn. When they answer, run it once more.
|
|
29
29
|
That refusal is a pause, not a stop.
|
|
@@ -33,7 +33,7 @@ That refusal is a pause, not a stop.
|
|
|
33
33
|
Run this first, before the welcome message below:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard identify --coding-agent <coding-agent-slug> --model <model-id> --model-family <model-family>
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
Report your product slug, such as `codex` or `claude-code`.
|
|
@@ -76,18 +76,18 @@ you here. Otherwise you hear from me next when the app is running and I hand you
|
|
|
76
76
|
To self-host on your machine with Docker, say so before you sign in.
|
|
77
77
|
|
|
78
78
|
That message belongs to the run. Send it only once, including after a second read of this prompt.
|
|
79
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
79
|
+
Then run `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase welcome-sent`.
|
|
80
80
|
|
|
81
81
|
## Report a stop, wherever it happens
|
|
82
82
|
|
|
83
83
|
If you stop this run at any point, send one short report before you stop. This includes
|
|
84
84
|
unexpected stops and stops caused by your harness.
|
|
85
85
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
86
|
-
Report the pause: `npx --prefer-offline --yes copilotkit@4.
|
|
86
|
+
Report the pause: `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer`.
|
|
87
87
|
A terminal that sends the report itself, or says to file none, overrides this.
|
|
88
88
|
|
|
89
89
|
```text
|
|
90
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
90
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
91
91
|
```
|
|
92
92
|
|
|
93
93
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -105,15 +105,15 @@ rule that stopped you says next: send the report, then stop.
|
|
|
105
105
|
Take the local route only when the developer already asked to run CopilotKit locally,
|
|
106
106
|
with Docker, or self-hosted: in their request, the copied prompt, or a later reply, or
|
|
107
107
|
when this run already recorded local. Then run
|
|
108
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
108
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read deployment/choose-local` instead.
|
|
109
109
|
|
|
110
110
|
Otherwise keep managed. Do not ask the developer to choose. Run
|
|
111
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
111
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard deployment --choice managed`, then continue with
|
|
112
112
|
“Check sign-in”. If it refuses because of a local stack, take the local route.
|
|
113
113
|
|
|
114
114
|
## Check sign-in
|
|
115
115
|
|
|
116
|
-
Run `npx --prefer-offline --yes copilotkit@4.
|
|
116
|
+
Run `npx --prefer-offline --yes copilotkit@4.26.0 login --json` before any project work. It checks the
|
|
117
117
|
session and starts sign-in only as needed. Treat this as a long-lived
|
|
118
118
|
streaming process. Do not wait for the command to exit before you read its standard output.
|
|
119
119
|
|
|
@@ -147,11 +147,11 @@ Read each JSON Lines record as it arrives:
|
|
|
147
147
|
7. If that process emits `type: failed`, report the error and stop onboarding. On
|
|
148
148
|
`reason: repeated_expiry`, rerun `login` with `--force` only if the developer asks.
|
|
149
149
|
|
|
150
|
-
On `type: completed`, run `npx --prefer-offline --yes copilotkit@4.
|
|
150
|
+
On `type: completed`, run `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase sign-in-settled`
|
|
151
151
|
before you continue.
|
|
152
152
|
|
|
153
153
|
If your harness ends the login process or your turn before the process emits
|
|
154
|
-
`type: completed` or `type: failed`, that is a pause, not a failed sign-in. Report the pause: `npx --prefer-offline --yes copilotkit@4.
|
|
154
|
+
`type: completed` or `type: failed`, that is a pause, not a failed sign-in. Report the pause: `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer`.
|
|
155
155
|
If the process
|
|
156
156
|
still runs, end your turn and wait for the developer to say they signed in, then read the
|
|
157
157
|
same process. If the process ended without emitting `type: failed`, run `login --json`
|
|
@@ -162,9 +162,9 @@ conversation.
|
|
|
162
162
|
|
|
163
163
|
Research reads only this project and needs no account. Start it as soon as the session is
|
|
164
164
|
valid or the developer has the sign-in page, and keep monitoring the login process while it
|
|
165
|
-
runs: `npx --prefer-offline --yes copilotkit@4.
|
|
165
|
+
runs: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read research/gather`. If this run already
|
|
166
166
|
started the research, do not start it again.
|
|
167
167
|
|
|
168
168
|
If sign-in stops onboarding, run
|
|
169
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
169
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read stopped/run-failed`. It does not judge
|
|
170
170
|
this project's stack.
|
|
@@ -100,7 +100,7 @@ of this journey, and a drawer that lists nothing is not a reason to mint one. Li
|
|
|
100
100
|
tokens stay a self-hosted concern.
|
|
101
101
|
|
|
102
102
|
Where this journey's frontend framework ships no threads drawer -- React Native --, the
|
|
103
|
-
fifth item is proved by `npx --prefer-offline --yes copilotkit@4.
|
|
103
|
+
fifth item is proved by `npx --prefer-offline --yes copilotkit@4.26.0 verify --round-trip`, which sends a
|
|
104
104
|
real request and reads the answer back off the thread it landed on. The run says which of
|
|
105
105
|
the two it proved. Do not send a run to the managed Intelligence dashboard to prove this.
|
|
106
106
|
An authenticated browser session at a hosted dashboard is the one thing an agent-driven run
|
|
@@ -116,7 +116,7 @@ and passed -- so a run scored on either one was scored on the same fact. Every r
|
|
|
116
116
|
resolves that condition from, while `licenseStatus` is a compatibility projection of it
|
|
117
117
|
for older thread surfaces and outlives them only until those surfaces go.
|
|
118
118
|
|
|
119
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
119
|
+
Then run `npx --prefer-offline --yes copilotkit@4.26.0 onboard read credentials/finalize-plan`.
|
|
120
120
|
|
|
121
121
|
If a selected page does not load after the second method, run
|
|
122
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
122
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read unsupported/no-validated-path`.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Select the Intelligence project
|
|
2
2
|
|
|
3
3
|
For a recorded local choice, run
|
|
4
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
4
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read deployment/local-evaluation`.
|
|
5
5
|
That path obtains approval and connects the local project. Skip hosted selection.
|
|
6
6
|
Keep the implementation and feature-proof requirements.
|
|
7
7
|
|
|
@@ -17,7 +17,7 @@ evidence in one sentence. Keep plan approval a separate, later question.
|
|
|
17
17
|
Before you end your turn to wait for the developer, report the pause:
|
|
18
18
|
|
|
19
19
|
```text
|
|
20
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
20
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
## Record the audit cell
|
|
@@ -35,7 +35,7 @@ Choose the starting state from the repository findings:
|
|
|
35
35
|
A run served `proof/oss-baseline` records one of the last two.
|
|
36
36
|
|
|
37
37
|
```text
|
|
38
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
38
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard classify --starting-state <starting-state> --agent-framework <agent-framework> --frontend <frontend> --model-vendor <model-vendor> --model-vendor-choice <model-vendor-choice>
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
`<model-vendor>` is `openai`, `anthropic`, `google`, or `other`. `<model-vendor-choice>` is
|
|
@@ -52,7 +52,7 @@ runtime `.env` file, that directory is the target, not the repository root. Do n
|
|
|
52
52
|
the developer to another terminal.
|
|
53
53
|
|
|
54
54
|
```text
|
|
55
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
55
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --json
|
|
56
56
|
```
|
|
57
57
|
|
|
58
58
|
Every credential this run writes goes to the environment path: the target's `.env`, or
|
|
@@ -87,7 +87,7 @@ unless the developer says that it is this app's.
|
|
|
87
87
|
Before you end your turn to wait for the developer, report the pause:
|
|
88
88
|
|
|
89
89
|
```text
|
|
90
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
90
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
91
91
|
```
|
|
92
92
|
|
|
93
93
|
If no developer answers, create with the derived name in `suggestedName`. Never select a
|
|
@@ -96,9 +96,9 @@ project from a listing without an answer that names it.
|
|
|
96
96
|
`--runtime-url` is the URL port research settled, mount path included:
|
|
97
97
|
|
|
98
98
|
```text
|
|
99
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
99
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --create <name> \
|
|
100
100
|
--runtime-url http://localhost:<port>/api/copilotkit --json
|
|
101
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
101
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --project <slug-or-id> \
|
|
102
102
|
--runtime-url http://localhost:<port>/api/copilotkit --json
|
|
103
103
|
```
|
|
104
104
|
|
|
@@ -110,12 +110,12 @@ show only what they asked for, and do not order it by creation time:
|
|
|
110
110
|
Before you end your turn to wait for the developer, report the pause:
|
|
111
111
|
|
|
112
112
|
```text
|
|
113
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
113
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
114
114
|
```
|
|
115
115
|
|
|
116
116
|
```text
|
|
117
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
118
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
117
|
+
npx --prefer-offline --yes copilotkit@4.26.0 project list --json
|
|
118
|
+
npx --prefer-offline --yes copilotkit@4.26.0 project list --search <query> --json
|
|
119
119
|
```
|
|
120
120
|
|
|
121
121
|
`app-directory` means that the key landed where no app reads it. Pick the directory in
|
|
@@ -130,11 +130,11 @@ developer answered that line itself. For a line that is still open, ask the deve
|
|
|
130
130
|
`question.ask` in those words. When `question.alternative` is present, the question offers
|
|
131
131
|
two choices. If the developer chose `question.alternative`, here or in the setup message,
|
|
132
132
|
run the same command again with `question.alternative.rerun` added. The CLI adds
|
|
133
|
-
`question.alternative.
|
|
133
|
+
`question.alternative.ignoreLines` itself, and later steps keep that file without the flag.
|
|
134
134
|
If they approve the untrack, add
|
|
135
135
|
`question.ignoreLine` to `question.ignoreFile`. If `question.untrack` is present, run it
|
|
136
136
|
too. Or the developer does both. Report the pause with
|
|
137
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
137
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer`, end your
|
|
138
138
|
turn, and wait for the answer. Then run the same command again. Write the key only to
|
|
139
139
|
`question.file`, or to `question.alternative.file` by rerunning with
|
|
140
140
|
`question.alternative.rerun`.
|
|
@@ -147,4 +147,4 @@ turn, and wait for the answer. Then run the same command again. Write the key on
|
|
|
147
147
|
reused. The round-trip proof later runs the authenticated Intelligence checks, so record
|
|
148
148
|
the reused project credentials as unverified in the plan until those checks pass.
|
|
149
149
|
|
|
150
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
150
|
+
Then run `npx --prefer-offline --yes copilotkit@4.26.0 onboard read credentials/settle-credentials`.
|
|
@@ -10,7 +10,7 @@ session, do not guess. Ask the framework and model provider lines in one message
|
|
|
10
10
|
the framework that the repository findings show, or, for an empty project, a documented
|
|
11
11
|
default. For the provider, offer the vendors the framework's CopilotKit pages document.
|
|
12
12
|
Report the pause with
|
|
13
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
13
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer`, then end your
|
|
14
14
|
turn and wait for the answer. A route that records no framework or vendor on purpose is not
|
|
15
15
|
this case: an empty project with Slack or Microsoft Teams, a "Project-defined" vendor, or
|
|
16
16
|
"The agent's own" vendor.
|
|
@@ -34,7 +34,7 @@ Microsoft Teams docs page, do not ask the framework question. So does an empty p
|
|
|
34
34
|
whose frontend `setup/questions` recorded as Slack or Microsoft Teams: it recorded no
|
|
35
35
|
framework. The Channel starter brings its own agent, so an answer here decides nothing. Tell the developer that the Channel
|
|
36
36
|
starter decides the agent, then run
|
|
37
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read frontend/plan`.
|
|
38
38
|
|
|
39
39
|
## Route on the recorded framework
|
|
40
40
|
|
|
@@ -43,27 +43,27 @@ The framework and vendor come from `setup/questions`, with how the vendor was ch
|
|
|
43
43
|
|
|
44
44
|
Use exactly one matching internal route:
|
|
45
45
|
|
|
46
|
-
1. AG2: `npx --prefer-offline --yes copilotkit@4.
|
|
47
|
-
2. Agno: `npx --prefer-offline --yes copilotkit@4.
|
|
48
|
-
3. Built-in CopilotKit agent: `npx --prefer-offline --yes copilotkit@4.
|
|
49
|
-
4. Claude Agent SDK Python: `npx --prefer-offline --yes copilotkit@4.
|
|
50
|
-
5. Claude Agent SDK TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
51
|
-
6. CrewAI Flows: `npx --prefer-offline --yes copilotkit@4.
|
|
52
|
-
7. Existing AG-UI agent: `npx --prefer-offline --yes copilotkit@4.
|
|
53
|
-
8. Deep Agents: `npx --prefer-offline --yes copilotkit@4.
|
|
54
|
-
9. LangGraph Python: `npx --prefer-offline --yes copilotkit@4.
|
|
55
|
-
10. LangGraph FastAPI: `npx --prefer-offline --yes copilotkit@4.
|
|
56
|
-
11. LangGraph TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
57
|
-
12. LlamaIndex: `npx --prefer-offline --yes copilotkit@4.
|
|
58
|
-
13. ADK: `npx --prefer-offline --yes copilotkit@4.
|
|
59
|
-
14. Microsoft Agent Framework Python: `npx --prefer-offline --yes copilotkit@4.
|
|
60
|
-
15. Microsoft Agent Framework .NET: `npx --prefer-offline --yes copilotkit@4.
|
|
61
|
-
16. Mastra: `npx --prefer-offline --yes copilotkit@4.
|
|
62
|
-
17. MS Agent Harness .NET: `npx --prefer-offline --yes copilotkit@4.
|
|
63
|
-
18. Pydantic AI: `npx --prefer-offline --yes copilotkit@4.
|
|
64
|
-
19. Strands Agents Python: `npx --prefer-offline --yes copilotkit@4.
|
|
65
|
-
20. Strands Agents TypeScript: `npx --prefer-offline --yes copilotkit@4.
|
|
46
|
+
1. AG2: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/ag2`
|
|
47
|
+
2. Agno: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/agno`
|
|
48
|
+
3. Built-in CopilotKit agent: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/built-in`
|
|
49
|
+
4. Claude Agent SDK Python: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/claude-sdk-python`
|
|
50
|
+
5. Claude Agent SDK TypeScript: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/claude-sdk-typescript`
|
|
51
|
+
6. CrewAI Flows: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/crewai-flows`
|
|
52
|
+
7. Existing AG-UI agent: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/custom-ag-ui`
|
|
53
|
+
8. Deep Agents: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/deep-agents`
|
|
54
|
+
9. LangGraph Python: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/langgraph-python`
|
|
55
|
+
10. LangGraph FastAPI: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/langgraph-fastapi`
|
|
56
|
+
11. LangGraph TypeScript: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/langgraph-typescript`
|
|
57
|
+
12. LlamaIndex: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/llamaindex`
|
|
58
|
+
13. ADK: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/google-adk`
|
|
59
|
+
14. Microsoft Agent Framework Python: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/ms-agent-python`
|
|
60
|
+
15. Microsoft Agent Framework .NET: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/ms-agent-dotnet`
|
|
61
|
+
16. Mastra: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/mastra`
|
|
62
|
+
17. MS Agent Harness .NET: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/ms-agent-harness-dotnet`
|
|
63
|
+
18. Pydantic AI: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/pydantic-ai`
|
|
64
|
+
19. Strands Agents Python: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/strands-python`
|
|
65
|
+
20. Strands Agents TypeScript: `npx --prefer-offline --yes copilotkit@4.26.0 onboard read framework/strands-typescript`
|
|
66
66
|
|
|
67
67
|
If the project has an agent in another framework that does not speak AG-UI, or no
|
|
68
68
|
listed framework fits, keep the developer's current agent and run
|
|
69
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
69
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read unsupported/no-validated-path`.
|
|
@@ -21,7 +21,7 @@ The plan names the model credential variables. Run this from the directory that
|
|
|
21
21
|
`environmentPath` in the project step's result, with one `--model-key` for each variable:
|
|
22
22
|
|
|
23
23
|
```text
|
|
24
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
24
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --model-key <variable> --json
|
|
25
25
|
```
|
|
26
26
|
|
|
27
27
|
If `setup/questions` recorded a key file, add `--env-path <file>` to the first check.
|
|
@@ -35,21 +35,22 @@ never prints a value. Read `status`:
|
|
|
35
35
|
- `ready`: continue. Name each `unsupported` or `undetermined` `reason` in `modelKeys` in
|
|
36
36
|
the closing report. Name each `copiedKeys` entry with the outcome `kept` or `no-value`
|
|
37
37
|
too: that service does not get the checked key. When `outsideRepository` names a file, the app does not load it by
|
|
38
|
-
itself. By default, plan to copy the key into the app's env file
|
|
38
|
+
itself. By default, plan to copy the key into `environmentPath`, the app's env file that git ignores.
|
|
39
39
|
The copy is a file the run writes itself, so list the copy under
|
|
40
40
|
`Files the run writes itself`.
|
|
41
41
|
The developer's approval of the plan is their consent to the copy. After the approval,
|
|
42
42
|
copy the key with the command that `next` names. It has this form:
|
|
43
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
44
|
-
|
|
43
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --model-key <variable> --env-path <file> --copy-to <env file> --json`.
|
|
44
|
+
`<env file>` is `environmentPath`, never the tracked `.env` of a run that chose
|
|
45
|
+
`question.alternative.file`. It writes the key without printing it. Do not copy the key
|
|
45
46
|
yourself, and do not write a `sed`, `grep`, or `cat` command for it. If you cannot run
|
|
46
47
|
the command, for example because a sandbox refuses the path, ask the developer to run it.
|
|
47
48
|
Give them exactly this one line, with `<app directory>` as the directory that holds
|
|
48
49
|
`environmentPath`:
|
|
49
|
-
`! cd <app directory> && npx --prefer-offline --yes copilotkit@4.
|
|
50
|
+
`! cd <app directory> && npx --prefer-offline --yes copilotkit@4.26.0 onboard credentials --model-key <variable> --env-path <file> --copy-to <env file>`.
|
|
50
51
|
The command needs no input. Without `!`, they run the same command in a terminal.
|
|
51
52
|
Report the pause with
|
|
52
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
53
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-model-credential`,
|
|
53
54
|
end your turn, and wait. When they reply, run the same command with `--json` and read `copiedKeys`.
|
|
54
55
|
If the developer declines the copy, the plan has the app read the key from an
|
|
55
56
|
environment variable that the developer sets. The plan then says how to set it. Never
|
|
@@ -88,4 +89,4 @@ Never read a file outside the project directory to find a credential: a key foun
|
|
|
88
89
|
bills another project. Asking for a path is not requesting a secret. A path the developer
|
|
89
90
|
names is theirs to give, including one outside the project. A path this run finds is not.
|
|
90
91
|
|
|
91
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
92
|
+
Then run `npx --prefer-offline --yes copilotkit@4.26.0 onboard read credentials/write-plan`.
|
|
@@ -11,7 +11,7 @@ friction command follows the telemetry setting the developer already chose, so i
|
|
|
11
11
|
separate question.
|
|
12
12
|
|
|
13
13
|
```text
|
|
14
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
14
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -72,7 +72,7 @@ page is selected yet, add the one for the frontend selected above to the same li
|
|
|
72
72
|
Native, so the planner proves the thread with `verify --round-trip` instead.
|
|
73
73
|
|
|
74
74
|
Spawn one planning subagent. Tell it to run
|
|
75
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
75
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read subagent/create-plan` first and follow the
|
|
76
76
|
prompt it returns. Tell it to return at once, and say so, if that read is refused or fails,
|
|
77
77
|
and not to wait for an approval. If it returns that way, stop that subagent. Run the same
|
|
78
78
|
command yourself, then spawn a fresh subagent with the returned prompt and the same handoff.
|
|
@@ -87,7 +87,7 @@ subagent to finish.
|
|
|
87
87
|
Continue only if the planning result starts with `Status: passed`. For `Status: failed`,
|
|
88
88
|
send the result back to the planning subagent for repair, up to three attempts. For
|
|
89
89
|
`Status: blocked`, or a third failed result, run
|
|
90
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
90
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read stopped/run-failed`. A plan this run cannot
|
|
91
91
|
write is a run that broke, not a stack the documentation does not cover. The exception is
|
|
92
92
|
a blocked result that names `unsupported/no-validated-path`: the planning subagent found
|
|
93
93
|
that no page supports the plan, so take the no-supported-path route at the end of this
|
|
@@ -136,17 +136,17 @@ Before you end your turn to wait for the answer, report the pause, each time you
|
|
|
136
136
|
plan:
|
|
137
137
|
|
|
138
138
|
```text
|
|
139
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
139
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-plan-approval
|
|
140
140
|
```
|
|
141
141
|
|
|
142
142
|
After the approval, run the same `onboard credentials --model-key` check again when the plan
|
|
143
143
|
carries a missing model key. On `ready`, continue. If the key is still missing, ask the
|
|
144
144
|
developer `question.ask` in those words. Report the pause with
|
|
145
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
145
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-model-credential`, end
|
|
146
146
|
your turn, and run the check again when they answer.
|
|
147
147
|
|
|
148
148
|
If the developer approves the plan, run
|
|
149
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
149
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read implementation/build-and-validate`.
|
|
150
150
|
|
|
151
151
|
If no exact supported path or documentation URL exists, run
|
|
152
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
152
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read unsupported/no-validated-path`.
|
|
@@ -9,15 +9,15 @@ A local request can arrive after this run created a hosted project: `init --crea
|
|
|
9
9
|
Tell the developer that this run already created a hosted project, so it stays managed.
|
|
10
10
|
Return to the step you were on.
|
|
11
11
|
|
|
12
|
-
First run `npx --prefer-offline --yes copilotkit@4.
|
|
12
|
+
First run `npx --prefer-offline --yes copilotkit@4.26.0 local --help`. If it does not list `setup`
|
|
13
13
|
("Configure model access and install or resume the local stack"), this release has no
|
|
14
14
|
local evaluation. Tell the developer so, and keep managed. If this run has not recorded
|
|
15
|
-
managed yet, run `npx --prefer-offline --yes copilotkit@4.
|
|
15
|
+
managed yet, run `npx --prefer-offline --yes copilotkit@4.26.0 onboard deployment --choice managed`.
|
|
16
16
|
Then return to “Check sign-in” in the start prompt. If a login process from it still
|
|
17
17
|
runs, keep reading that process and start no second one. Otherwise record the choice:
|
|
18
18
|
|
|
19
19
|
```text
|
|
20
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
20
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard deployment --choice local
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Explain these conditions before sign-in:
|
|
@@ -46,10 +46,10 @@ and Learning starts its first run only after 15 conversations. Offer these choic
|
|
|
46
46
|
|
|
47
47
|
1. Configure later, the default. Install with `--defer-model`. In the closing report, write
|
|
48
48
|
"Learning configuration incomplete". Name the command that adds the model later:
|
|
49
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
49
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 local setup`, run in a terminal in the app directory.
|
|
50
50
|
2. Guided setup. If the developer named Learning as a goal, offer it first. Install
|
|
51
51
|
the stack with `--defer-model`. After the stack is ready, the developer runs
|
|
52
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
52
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 local setup` in their own terminal window, in the app
|
|
53
53
|
directory. Never give it as a `!` line: its guided prompt needs a terminal, and a coding
|
|
54
54
|
agent's shell has none. The prompt asks for the model and its key, and it saves them
|
|
55
55
|
privately. On a running stack, it restarts only Learning. Do not ask the developer to
|
|
@@ -60,7 +60,7 @@ and Learning starts its first run only after 15 conversations. Offer these choic
|
|
|
60
60
|
Before you end your turn to wait for the developer, report the pause:
|
|
61
61
|
|
|
62
62
|
```text
|
|
63
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
63
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
Record the model choice, and any candidate path, in the plan, but no secret values.
|
|
@@ -74,7 +74,7 @@ If the managed sign-in message was already sent, send this once and no other sig
|
|
|
74
74
|
message: “You asked to run it locally, so this project gets no managed CopilotKit project.
|
|
75
75
|
Signing in only gets the renewable evaluation license.”
|
|
76
76
|
|
|
77
|
-
Otherwise run `npx --prefer-offline --yes copilotkit@4.
|
|
77
|
+
Otherwise run `npx --prefer-offline --yes copilotkit@4.26.0 login --json`. Follow the streaming sign-in
|
|
78
78
|
protocol from “Check sign-in” in the start prompt: open the first authentication URL
|
|
79
79
|
once, keep the same process running, and continue only after its completed record.
|
|
80
80
|
When the first authentication URL arrives, send this message in place of the managed
|
|
@@ -82,9 +82,9 @@ sign-in message: “Sign in to get the renewable evaluation license. Your local
|
|
|
82
82
|
will use CLI approval.”
|
|
83
83
|
On failed or declined sign-in, take the failure path below.
|
|
84
84
|
|
|
85
|
-
After sign-in completes, report it: `npx --prefer-offline --yes copilotkit@4.
|
|
85
|
+
After sign-in completes, report it: `npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase sign-in-settled`.
|
|
86
86
|
Then continue with
|
|
87
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
87
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read research/gather`, unless research already started.
|
|
88
88
|
If it already started, return to the step you were on. `starter/clone` and
|
|
89
89
|
`credentials/finalize-plan` each have a branch for a recorded local choice.
|
|
90
90
|
Keep the local choice and collected paths in the run's plan and worker context.
|
|
@@ -92,4 +92,4 @@ Keep the local choice and collected paths in the run's plan and worker context.
|
|
|
92
92
|
## Failure path
|
|
93
93
|
|
|
94
94
|
If sign-in fails or is declined, stop before cluster creation.
|
|
95
|
-
Run `npx --prefer-offline --yes copilotkit@4.
|
|
95
|
+
Run `npx --prefer-offline --yes copilotkit@4.26.0 onboard read stopped/run-failed`.
|
|
@@ -25,7 +25,7 @@ does not authorize replacing an existing app's connection.
|
|
|
25
25
|
Before you end your turn to wait for the developer, report the pause:
|
|
26
26
|
|
|
27
27
|
```text
|
|
28
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
28
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
29
29
|
```
|
|
30
30
|
|
|
31
31
|
## Run the shared installer
|
|
@@ -33,7 +33,7 @@ npx --prefer-offline --yes copilotkit@4.25.1 onboard checkpoint --phase awaiting
|
|
|
33
33
|
From the exact app directory, use the collected model choice:
|
|
34
34
|
|
|
35
35
|
```text
|
|
36
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
36
|
+
npx --prefer-offline --yes copilotkit@4.26.0 local setup --defer-model --json
|
|
37
37
|
```
|
|
38
38
|
|
|
39
39
|
For supplied model access, replace `--defer-model` with `--model-config <private-file>`.
|
|
@@ -51,7 +51,7 @@ A copied app needs explicit `--share-stack`. Do not infer sharing from a copied
|
|
|
51
51
|
After setup reports the stack ready, run the approved connection step from that directory:
|
|
52
52
|
|
|
53
53
|
```text
|
|
54
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
54
|
+
npx --prefer-offline --yes copilotkit@4.26.0 local connect --approve-connection --json
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
Read the local `.copilotkit/project.json` for its project ID and slug. Do not run hosted
|
|
@@ -71,7 +71,7 @@ stack is ready. Then:
|
|
|
71
71
|
Ask the developer to run this command in their own terminal window, in the app directory:
|
|
72
72
|
|
|
73
73
|
```text
|
|
74
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
74
|
+
npx --prefer-offline --yes copilotkit@4.26.0 local setup
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
Do not give it as a `!` line, and do not run it yourself. Its guided model prompt needs a
|
|
@@ -80,9 +80,9 @@ changes nothing. The prompt asks for the model and its key, and it saves them pr
|
|
|
80
80
|
On a running stack, it restarts only Learning. Do not ask for a model file.
|
|
81
81
|
|
|
82
82
|
Say that the run continues when they reply or resume this session. Report the pause with
|
|
83
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
83
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-model-credential`, end your
|
|
84
84
|
turn, and wait. When the developer replies, run
|
|
85
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
85
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 local status --json` and read `learning.configuration`.
|
|
86
86
|
|
|
87
87
|
If the model is still missing or was deferred, report “Learning configuration incomplete”
|
|
88
88
|
and name the same command, run in a terminal window. No Learning run is required to finish
|
|
@@ -96,6 +96,6 @@ must not block Threads, the dashboard, or later Learning configuration.
|
|
|
96
96
|
If the developer cancels the connection, run `local cancel --json` from the app directory.
|
|
97
97
|
Report conflict names only. Keep the stack unless deletion is separately confirmed.
|
|
98
98
|
|
|
99
|
-
Continue with `npx --prefer-offline --yes copilotkit@4.
|
|
99
|
+
Continue with `npx --prefer-offline --yes copilotkit@4.26.0 onboard read credentials/settle-credentials`.
|
|
100
100
|
For this local route, skip the hosted selection-result checks and use the local project
|
|
101
101
|
record. Continue the existing implementation and proof paths against local endpoints.
|
|
@@ -14,7 +14,7 @@ you stop. The friction command follows the telemetry setting the developer alrea
|
|
|
14
14
|
so it needs no separate question.
|
|
15
15
|
|
|
16
16
|
```text
|
|
17
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
17
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard friction --phase stop --category <slug> --message "<sentences>"
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
`--message` takes one or two sentences: the step you stopped at and what stopped it.
|
|
@@ -61,7 +61,7 @@ or frontend, stop onboarding.
|
|
|
61
61
|
If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of a
|
|
62
62
|
step, show the developer the list it printed, and run what they choose:
|
|
63
63
|
the `onboard restore` command the tripwire stop prints, which names each deleted file, or
|
|
64
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
64
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard tripwire --continue`. Then read the step again. If
|
|
65
65
|
you cannot ask, stop onboarding. Never repair, reset, or revert a file the developer changed
|
|
66
66
|
outside this run.
|
|
67
67
|
|
|
@@ -110,16 +110,16 @@ that the selected documentation proved an inferred step.
|
|
|
110
110
|
Record what the proof returned before you complete:
|
|
111
111
|
|
|
112
112
|
```text
|
|
113
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
113
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard proof --step round-trip --outcome <passed|failed|skipped>
|
|
114
114
|
```
|
|
115
115
|
|
|
116
|
-
When the proof is complete, run `npx --prefer-offline --yes copilotkit@4.
|
|
116
|
+
When the proof is complete, run `npx --prefer-offline --yes copilotkit@4.26.0 onboard complete`, carrying the
|
|
117
117
|
surface-check result the proof subagent returned. Pass exactly one of `--visual-check` or
|
|
118
118
|
`--device-check`, matching this journey's surface:
|
|
119
119
|
|
|
120
120
|
```text
|
|
121
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
122
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
121
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard complete --visual-check <outcome>
|
|
122
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard complete --device-check <outcome>
|
|
123
123
|
```
|
|
124
124
|
|
|
125
125
|
`--visual-check` is for a web frontend and takes `performed`, `skipped-no-browser-tool`, or
|
|
@@ -24,7 +24,7 @@ That result is a question for the developer. Name the file and why the work need
|
|
|
24
24
|
Before you end your turn to wait for the developer, report the pause:
|
|
25
25
|
|
|
26
26
|
```text
|
|
27
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
27
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Then end your turn and wait for the developer's answer. If they allow it, spawn a fresh
|
|
@@ -34,16 +34,16 @@ cannot ask, or the developer declines, take the feature stop route below.
|
|
|
34
34
|
If the CLI prints `## Stop: this run deleted or moved the developer's work` instead of
|
|
35
35
|
a step, show the developer the list it printed, and run what they choose:
|
|
36
36
|
the `onboard restore` command the tripwire stop prints, which names each deleted file, or
|
|
37
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
37
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard tripwire --continue`. Then read the step again.
|
|
38
38
|
|
|
39
39
|
To route out and stop:
|
|
40
40
|
|
|
41
41
|
```text
|
|
42
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
42
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard read feature/stop
|
|
43
43
|
```
|
|
44
44
|
|
|
45
45
|
If validation cannot pass, or this intent needs a prerequisite the app does not have, use
|
|
46
46
|
the feature stop route above without further changes.
|
|
47
47
|
|
|
48
48
|
Otherwise run
|
|
49
|
-
`npx --prefer-offline --yes copilotkit@4.
|
|
49
|
+
`npx --prefer-offline --yes copilotkit@4.26.0 onboard read feature/a2ui/proof`.
|
|
@@ -12,7 +12,7 @@ The approval is a wait for the developer. Before you end your turn to wait, repo
|
|
|
12
12
|
pause:
|
|
13
13
|
|
|
14
14
|
```text
|
|
15
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
15
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-developer
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
A turn that ends while the run waits is a pause, not a stop, even when your harness ends it.
|
|
@@ -49,7 +49,7 @@ renders a compact visible surface. Ask for approval as its own question.
|
|
|
49
49
|
Before you end your turn to wait for the developer, report the pause:
|
|
50
50
|
|
|
51
51
|
```text
|
|
52
|
-
npx --prefer-offline --yes copilotkit@4.
|
|
52
|
+
npx --prefer-offline --yes copilotkit@4.26.0 onboard checkpoint --phase awaiting-plan-approval
|
|
53
53
|
```
|
|
54
54
|
|
|
55
55
|
Ask the developer before you edit a file that has uncommitted changes. List those files in
|
|
@@ -57,4 +57,4 @@ the plan under `Uncommitted files`, each with one sentence explaining why, or wr
|
|
|
57
57
|
`git status` names them. The CLI records no consent: the approved plan is the record. The
|
|
58
58
|
plan must not delete, move, or rename one of those files.
|
|
59
59
|
|
|
60
|
-
Then run `npx --prefer-offline --yes copilotkit@4.
|
|
60
|
+
Then run `npx --prefer-offline --yes copilotkit@4.26.0 onboard read feature/a2ui/implement`.
|