kylon-cli 0.7.10 → 0.7.11-next.1468
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 +76 -28
- package/dist/kylon-bundle.manifest.json +3 -3
- package/dist/kylon-bundle.mjs +3 -3
- package/dist/kylon-core-bundle.mjs +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -42,13 +42,17 @@ The CLI is also published to npm as
|
|
|
42
42
|
[`kylon-cli`](https://www.npmjs.com/package/kylon-cli). The Web UI provides
|
|
43
43
|
two distinct copy-paste entry points:
|
|
44
44
|
|
|
45
|
-
- **Settings → Developer tools → Kylon CLI**
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
the browser
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
45
|
+
- **Settings → Developer tools → Kylon CLI** (also reached from the avatar
|
|
46
|
+
menu's **Install Kylon CLI**) offers two ways in. **Install in terminal**
|
|
47
|
+
shows the hosted install one-liner above for the visitor's OS; installing
|
|
48
|
+
chains straight into the browser sign-in, and on an installed machine
|
|
49
|
+
`kylon login` with no flags does the same and lets the browser approval page
|
|
50
|
+
choose the workspace. Below it, **No browser on this computer?** mints a
|
|
51
|
+
one-time setup-token command (`npx --yes kylon-cli@<tag> auth login
|
|
52
|
+
--setup-token …`) for a terminal nobody can approve from. **Install with AI**
|
|
53
|
+
gives a prompt to paste into a coding agent: it checks `kylon status`,
|
|
54
|
+
installs with `KYLON_INSTALL_NO_LOGIN=1`, signs in with
|
|
55
|
+
`kylon login --workspace <id>`, and then discovers and uses
|
|
52
56
|
`kylon workspace` commands without assuming a provider-specific interface.
|
|
53
57
|
- **An external agent's Profile** shows
|
|
54
58
|
`npx --yes kylon-cli@<version> agent link --url '<one-time link>'`. Custom
|
|
@@ -371,7 +375,7 @@ agent work to finish, installs the managed bundle under `~/.kylon/bin`, and
|
|
|
371
375
|
restarts onto it. The server never requests `--force` automatically.
|
|
372
376
|
|
|
373
377
|
The owner can change the setting under **Settings → Developer tools → Kylon
|
|
374
|
-
CLI →
|
|
378
|
+
CLI → Devices** (open the computer's row), or from that computer:
|
|
375
379
|
|
|
376
380
|
```bash
|
|
377
381
|
kylon gateway auto-update status
|
|
@@ -680,8 +684,8 @@ Two consequences worth knowing:
|
|
|
680
684
|
### Sign in for workspace commands
|
|
681
685
|
|
|
682
686
|
For a person using `kylon workspace ...` from their own terminal, open the
|
|
683
|
-
workspace's **Settings → Kylon CLI** section
|
|
684
|
-
command, or run:
|
|
687
|
+
workspace's **Settings → Kylon CLI** section (or the avatar menu's **Install
|
|
688
|
+
Kylon CLI**) and copy the install command, or run:
|
|
685
689
|
|
|
686
690
|
```bash
|
|
687
691
|
npx --yes kylon-cli@latest auth login --workspace <WORKSPACE_ID>
|
|
@@ -763,10 +767,11 @@ recently authorized entry. If Kylon cannot confirm revocation, it keeps the loca
|
|
|
763
767
|
credential so you can retry. `kylon auth logout --local-only` deliberately skips
|
|
764
768
|
the remote revocation. This logout is deliberately credential-only: it does not
|
|
765
769
|
disconnect the local agent runtime or change connected agents. If that installation
|
|
766
|
-
still runs external agents, it remains listed
|
|
770
|
+
still runs external agents, it remains listed under **Devices** so its
|
|
767
771
|
runtime access can still be removed without signing the CLI in again.
|
|
768
772
|
|
|
769
|
-
You can instead remove
|
|
773
|
+
You can instead remove a device from **Settings → Kylon CLI → Devices** (open
|
|
774
|
+
its row, then **Remove device**).
|
|
770
775
|
After warning about the impact, that workspace-scoped action revokes any active
|
|
771
776
|
installation credential, removes the local runtime access associated with the
|
|
772
777
|
same installation, and disconnects every external agent using it. The device's
|
|
@@ -841,6 +846,9 @@ instead of waiting out inactivity timeouts and heartbeat intervals.
|
|
|
841
846
|
a readiness probe or assignment. Provider authentication and model selection
|
|
842
847
|
remain in Grok's local configuration.
|
|
843
848
|
- `hermes` — Hermes over ACP, using `hermes-acp` or `hermes acp`.
|
|
849
|
+
- `antigravity` — Antigravity CLI over ACP, through the Antigravity ACP server
|
|
850
|
+
that `kylon provider install antigravity` installs. See
|
|
851
|
+
[Antigravity CLI](#antigravity-cli).
|
|
844
852
|
- `openclaw` — OpenClaw CLI using `openclaw agent --message <prompt> --json`.
|
|
845
853
|
A message too large for the command line is delivered as a file via
|
|
846
854
|
`--message-file <path>` instead (requires OpenClaw 2026.6.11 or newer; the
|
|
@@ -936,7 +944,8 @@ back to another saved identity.
|
|
|
936
944
|
or arbitrary error text. Identity and workspace attribution come from server
|
|
937
945
|
authentication, not client fields.
|
|
938
946
|
- **Anonymous** (status (`status`/`auth status`, `gateway status`), `diagnose`,
|
|
939
|
-
the upgrade commands (`upgrade`, `provider update`,
|
|
947
|
+
the upgrade and install commands (`upgrade`, `provider update`,
|
|
948
|
+
`provider install`, `gateway service`)): the
|
|
940
949
|
same URL without a credential, command outcomes only, with an even narrower
|
|
941
950
|
metadata allowlist. The setup commands (`auth login`, `agent link`, `connect`,
|
|
942
951
|
`onboard`) report anonymously only when they fail, with the setup session id
|
|
@@ -1290,6 +1299,30 @@ new production CLI build must be published. Service deployment alone leaves
|
|
|
1290
1299
|
a fresh CLI-only PR from the current `main`, merge it, and dispatch stable
|
|
1291
1300
|
on that commit, keeping `main` still until the CLI is published.
|
|
1292
1301
|
|
|
1302
|
+
- **Run the stable preflight before every stable dispatch.** A stable run
|
|
1303
|
+
needs about an hour and a human approval before it reaches the gates that
|
|
1304
|
+
most often fail, so check them first, read-only:
|
|
1305
|
+
|
|
1306
|
+
```bash
|
|
1307
|
+
node scripts/ci/cli-stable-preflight.mjs --mac-host p2compat@autodeploy-bj
|
|
1308
|
+
```
|
|
1309
|
+
|
|
1310
|
+
It takes the current `main` head (or `--sha <main sha>`) and prints one
|
|
1311
|
+
pass/fail row per gate: the merged main PR behind that commit, the newest
|
|
1312
|
+
production deploy and every changed file since it that is not CLI-only, the
|
|
1313
|
+
merged PR's latest `preview-deploy.yml` run (completed, successful, and
|
|
1314
|
+
merged onto `main`'s exact tree), the package version against npm `@latest`,
|
|
1315
|
+
any stable `cli-publish.yml` run still queued or running, the
|
|
1316
|
+
`p2-external-compat` macOS runner (online and idle; reading runners needs repo
|
|
1317
|
+
admin), and, over SSH with `--mac-host`, the harness `active-run` lock. The
|
|
1318
|
+
harness never steals that lock, so a held or stale one fails the row; recover
|
|
1319
|
+
a stale lock through `external-agent-compat-harness.yml` `recovery_run`,
|
|
1320
|
+
never by deleting it. The preflight dispatches, reruns and deletes nothing,
|
|
1321
|
+
and exits non-zero when any row fails. It cannot see qualification failures,
|
|
1322
|
+
Windows host state, or macOS privacy (TCC) denials for the runner service.
|
|
1323
|
+
On the `publish_cli=true` and `release:cli` paths the production row passes
|
|
1324
|
+
only after that Deploy completes; check the other rows before requesting it.
|
|
1325
|
+
|
|
1293
1326
|
Do not `npm publish` ad hoc: use the stable workflow and its OIDC provenance.
|
|
1294
1327
|
Pushing a version tag alone does not publish.
|
|
1295
1328
|
|
|
@@ -1351,21 +1384,36 @@ request `external-agent:full`. Stable CLI publication always runs fresh full
|
|
|
1351
1384
|
provider/platform qualification after the service deployment, independently
|
|
1352
1385
|
of these cheap checks.
|
|
1353
1386
|
|
|
1354
|
-
###
|
|
1355
|
-
|
|
1356
|
-
|
|
1357
|
-
|
|
1358
|
-
|
|
1359
|
-
|
|
1360
|
-
|
|
1361
|
-
|
|
1362
|
-
|
|
1363
|
-
|
|
1364
|
-
|
|
1365
|
-
|
|
1366
|
-
|
|
1367
|
-
|
|
1368
|
-
|
|
1387
|
+
### Antigravity CLI
|
|
1388
|
+
|
|
1389
|
+
Kylon runs Antigravity CLI through the Antigravity ACP server, a separate
|
|
1390
|
+
download that each Kylon CLI release pins and verifies:
|
|
1391
|
+
|
|
1392
|
+
1. Install the server with `kylon provider install antigravity` (`--json` for
|
|
1393
|
+
one machine-readable result). It downloads the pinned release, checks its
|
|
1394
|
+
sha256 against the pin and, on macOS and Windows, the executables'
|
|
1395
|
+
signature from Google, and unpacks it into
|
|
1396
|
+
`~/.kylon/providers/antigravity-acp/<version>/`. Run again, it verifies the
|
|
1397
|
+
existing install without downloading. Run it with the installed `kylon`
|
|
1398
|
+
(`~/.kylon/bin/kylon` if it is not on your PATH), not through `npx`: it
|
|
1399
|
+
removes server releases older than the one its own version pins, so a newer
|
|
1400
|
+
copy would remove the one the running service starts. `kylon gateway service repair`
|
|
1401
|
+
installs it as well when an Antigravity CLI agent on this computer has no
|
|
1402
|
+
server, or when Kylon's copy no longer matches what it installed.
|
|
1403
|
+
2. Sign in once with `agy`, Antigravity CLI itself, which the server download
|
|
1404
|
+
does not include. If `agy` is missing, `kylon provider install antigravity`
|
|
1405
|
+
prints its installer. The server reuses that sign-in, and a turn it refuses
|
|
1406
|
+
for want of one fails with the instruction to run `agy` once.
|
|
1407
|
+
3. Link the agent with the command Kylon gives you,
|
|
1408
|
+
`kylon agent link --url "<link>"`. `--url` is required, and the provider
|
|
1409
|
+
comes from the link: `kylon agent link --url "<link>" --provider antigravity`
|
|
1410
|
+
restates it, and an agent's link refuses any other provider.
|
|
1411
|
+
|
|
1412
|
+
The launch is built in: `agent configure` cannot override it. An Antigravity
|
|
1413
|
+
CLI agent runs only where the computer's running Kylon CLI reports Antigravity
|
|
1414
|
+
CLI support, so a link to a computer whose service still runs an older Kylon
|
|
1415
|
+
CLI is refused with `EXTERNAL_AGENT_CLI_PROVIDER_UNSUPPORTED` and leaves the
|
|
1416
|
+
link unused. Upgrade with `kylon upgrade`, then run the same setup again.
|
|
1369
1417
|
|
|
1370
1418
|
|
|
1371
1419
|
Project-aware onboarding in CLI 0.6.0 requires an API and browser supporting
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.7.
|
|
3
|
-
"fingerprint": "
|
|
4
|
-
"source_commit": "
|
|
2
|
+
"version": "0.7.11-next.1468",
|
|
3
|
+
"fingerprint": "031d702c2b1a3b48e9cbf881bf32f0286ba236164e13ec0a37414e57534e2788",
|
|
4
|
+
"source_commit": "54a4b165ddc17f682f5c42615d8ab2f4d50dc4fe"
|
|
5
5
|
}
|