kylon-cli 0.2.2-next.312 → 0.2.2-next.317

package/README.md

@@ -24,7 +24,17 @@ two distinct copy-paste entry points:
   workspace for confirmation, registers this installation as a computer,
   assigns the agent, and starts the host daemon. The credential expires after
   30 minutes and can be redeemed only once; rerunning the same installation's
-  interrupted redemption is idempotent.
+  interrupted redemption is idempotent. Because the link carries the
+  credential, treat the command as a secret until it is used or expires.
+
+A machine may be registered with one Kylon server and workspace at a time.
+Equivalent spellings of the same server (`https://dev.purework.ai/api` and
+`https://api.purework.ai`, `https://app.kylon.io/api` and
+`https://api.kylon.io`) count as the same registration; preview environments
+never do, even though they serve the same workspace ids as dev. Run
+`kylon computer unlink` to point a machine somewhere else — it forgets the
+local registration only, revoking nothing in the workspace and unassigning no
+agent.
 
 `auth login` browser-authenticates the human operator for `kylon workspace`
 commands. `agent link` authenticates only the link operation with its embedded
@@ -265,6 +275,7 @@ instead of waiting out inactivity timeouts and heartbeat intervals.
 | Command | Description |
 |---|---|
 | `kylon connect` | **Recommended.** Register this computer (browser auth + enrollment) and run the host daemon. `--url` also assigns one agent. |
+| `kylon computer unlink` | Forget this machine's saved computer registration so it can be linked elsewhere. Local only: revokes nothing and unassigns no agent. |
 | `kylon gateway run` | Run the host daemon from the saved computer registration (service entrypoint). |
 | `kylon keep-awake [mode]` | Show or set macOS sleep prevention (`always` (default) / `while-busy` / `off`). |