You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 34066ff
Browse filesBrowse the repository at this point in the historyBrowse files
Add opencode pairing runbook and opencode-link CLI helper
opencode web's username/password sign-in has a known upstream auth loop
(anomalyco/opencode#19920). Document the one-time pairing-link flow
(open from the web terminal or mint locally with opencode-link), which
signs the browser in with a 30-day session cookie. The link is minted
where the user is already authenticated - never in GitHub Actions.
Copy file name to clipboardExpand all lines: docs/workstation.md
+14Lines changed: 14 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -164,6 +164,20 @@ scripts/workstation opencode main
164
164
165
165
Browse to either URL and accept the self-signed certificate warning. Both apps run plain on localhost; Caddy terminates TLS and authenticates the browser, so the workstation stores only a bcrypt hash of the password. The plaintext password is kept in the Google Cloud Secret Manager secret `workstation-NAME-web-terminal-password`. The workflow identity can create this secret and append versions, but cannot read its values. Use Secret Manager in the Google Cloud console to see the active password.
166
166
167
+
opencode keeps its own sign-in, whose username/password prompt has a known upstream auth loop ([#19920](https://github.com/anomalyco/opencode/issues/19920)). Sign the browser in with a **one-time pairing link** instead — from your laptop:
168
+
169
+
```sh
170
+
scripts/workstation opencode-link main --project PROJECT --zone ZONE
171
+
```
172
+
173
+
or from inside the workstation (web terminal at `:8443`), as `developer`:
Open the printed link within 5 minutes (single use); Caddy asks for `workstation` + the shared password once more, then opencode signs the browser in with a 30-day session cookie. Rotating the browser-apps password signs opencode sessions out.
180
+
167
181
`start` rotates the password after a stopped VM resumes; `web-terminal` and `opencode` rotate it on demand. `create` without those flags keeps both ports closed. Browser access is public on ports 8443 and 8444 when enabled; protect the Google Cloud project and Secret Manager permissions and avoid leaving expensive API credentials in unattended sessions. Consider narrowing the firewall source range when practical.
web-terminal enables the code-server browser editor; opencode enables the opencode web UI.
23
23
Both are served by Caddy on https://IP:8443 and :8444 behind one browser-apps password.
24
+
opencode-link prints a one-time pairing link that signs the browser into opencode web.
24
25
configure applies one or more environments (comma-separated) from environments/NAME.sh, in order.
25
26
idle-shutdown installs the auto-shutdown watchdog (also run automatically after setup).
0 commit comments