@linzumi/cli 1.0.6 → 1.0.8

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
@@ -58,7 +58,7 @@ Install the CLI or run it with `npx`:
58
58
  ```bash
59
59
  npm install -g @linzumi/cli@latest
60
60
  npx -y @linzumi/cli@latest signup
61
- npx -y @linzumi/cli@1.0.6 --version
61
+ npx -y @linzumi/cli@1.0.8 --version
62
62
  linzumi --version
63
63
  ```
64
64
 
@@ -81,6 +81,37 @@ For non-production Linzumi servers, `connect` accepts either API URL flag:
81
81
  linzumi connect --linzumi-url ws://127.0.0.1:4140 --workspace default --allow-port-forwarding-by-default
82
82
  ```
83
83
 
84
+ ## Headless / remote runner auth (device flow)
85
+
86
+ The default `connect` flow opens a browser on the runner machine and waits
87
+ for an OAuth callback on `localhost`. That cannot work on a headless box -
88
+ a VPS, a Windows/SSH session, or any machine with no browser or no loopback
89
+ callback. For those, use `--auth-mode device`: the runner prints a short
90
+ user code plus a verification URL, and you approve it from a browser already
91
+ logged in to Linzumi on any other machine (e.g. your laptop).
92
+
93
+ ```bash
94
+ linzumi connect --workspace <slug> --auth-mode device --api-url wss://serve.linzumi.com
95
+ ```
96
+
97
+ The runner prints:
98
+
99
+ ```
100
+ Authorize this computer:
101
+ Code: 5PYP8PC2
102
+ Open: https://serve.linzumi.com/api/v2/local-codex-runner/device
103
+ ```
104
+
105
+ 1. On any machine where you are signed in to Linzumi, open the `Open:` URL.
106
+ 2. Enter the 8-character `Code:` and approve.
107
+ 3. The runner long-polls, receives a scoped token, and connects - no browser
108
+ or loopback callback needed on the runner itself.
109
+
110
+ The verification URL targets the same server you pass via `--api-url` /
111
+ `--linzumi-url` (defaulting to `wss://serve.linzumi.com`), so the link you
112
+ open always points at the server the runner connected to. The code expires
113
+ in 10 minutes; re-run `connect` to get a fresh one.
114
+
84
115
  ## Agent-first launch path
85
116
 
86
117
  The fastest path is the `npx -y @linzumi/cli@latest signup` command