kylon-cli 0.7.10 → 0.7.11-next.1473

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 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** shows the hosted install
46
- one-liner above; installing chains straight into the browser sign-in, and
47
- on an installed machine `kylon login` with no flags does the same and lets
48
- the browser approval page choose the workspace. An **Advanced** expander
49
- keeps the setup-token and `npx --yes kylon-cli@<tag> auth login` fallbacks
50
- for machines that cannot run the script. Its **Use with Your Agents**
51
- prompt teaches Claude Code, Codex, Grok Build, Hermes, or OpenClaw to discover and use
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 → Authorized devices**, or from that computer:
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, expand it, and copy its setup
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 as an **Authorized device** so its
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 an **Authorized device** from **Settings → Kylon CLI**.
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`, `gateway service`)): the
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
- ### Gemini CLI
1355
-
1356
- Install stable Gemini CLI 0.58.0 or newer with
1357
- `npm install -g @google/gemini-cli@latest`, then run `gemini` interactively to
1358
- configure persistent Google sign-in or a securely stored API key. Select Gemini
1359
- CLI in Kylon and run its Connect command. Kylon launches the installed
1360
- `gemini --acp` through the shared ACP executor; the launch cannot be overridden
1361
- with `agent configure`. Older installs receive an upgrade remedy. A successful
1362
- handshake reports authentication as unverified until a real turn succeeds.
1363
-
1364
- Session loading, workspace MCP tools, streamed text/tool activity and
1365
- cancellation use ACP. Kylon does not populate Gemini's global skill directories
1366
- or forward arbitrary Google credential variables from the daemon environment.
1367
- The model/effort picker, provider update command and Gemini quota display are
1368
- not available for this provider.
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.10",
3
- "fingerprint": "55ea4526a571d7bf6bfe5208f7afbc9a906d2bf9c6e0c7bcb9f8dbb2b061e562",
4
- "source_commit": "463880e40a8deef3aed33e447509f52710bd021e"
2
+ "version": "0.7.11-next.1473",
3
+ "fingerprint": "c566becb0780ccc44f7b6d5cc685ad468081fdc47cc88a28c38e4cd543ddf5c8",
4
+ "source_commit": "fecda88d2cdb3fd2cffd171cf49e4c21dec44e52"
5
5
  }