← Commit history

workspace skill: document the webview restart recipe flags (PR #11)

Colby Knox ·75dd89556f ·1mo ago ·parent fbe864e
2 files changed +37−1
package.json+1−1
@@ -1,6 +1,6 @@ {   "slug": "adom-cli",-  "version": "4.3.9",+  "version": "4.3.10",   "type": "app",   "org": "adom",   "description": "Adom CLI \u2014 platform binary for containers, repos, workspaces, orgs, SSH keys, Hydrogen settings, and more",
skills/adom-cli/workspace/SKILL.md+36
@@ -194,6 +194,42 @@ adom-cli hydrogen webview open-or-refresh \  Response includes `"action": "created"` or `"action": "refreshed"` so you know which path ran. If the tab was closed, the next call recreates it (requires `--panel-id` again). +### Say how to restart a page you serve yourself (0.7.9+)++A page served from the workspace (`localhost`, `127.0.0.1`, `0.0.0.0`,+`[::1]`, `<port>.localhost`) dies when the laptop sleeps: WSL restarts the+workspace, code-server comes back, and any server an AI thread started by+hand does not. The tab is then a white "can't reach this page" with nobody+named to ask. Hydrogen cannot guess the command, so SAY IT when you open+the tab:++```bash+adom-cli hydrogen webview open-or-refresh \+  --name "Octolux" \+  --url "http://localhost:8830/dashboard/" \+  --ai-thread "ntx embedded" \+  --reason "the Octolux dashboard for this session" \+  --restart "octolux serve" \+  --restart-cwd "$HOME/project/ntx-embedded"+```++Hydrogen Desktop 1.0.430+ then, after a wake, either runs the command and+reloads the tab once the port answers, or covers the pane with a note+naming your thread, and reloads by itself once the server is back (each+repair has a switch in Settings > Recovery).++The outcome rides the response as `_restart`: `recorded: true` with the+thread and command, or `recorded: false` with the reason, which is+`"this Hydrogen build has no /api/webview-origins route"` on cloud+Hydrogen and on older desktops. Best effort throughout: it never blocks or+fails the open. Omit the flags on a workspace URL and the CLI prints a+one-line nudge on stderr (stdout stays JSON) and records+`recorded: false`.++A proxied URL (`https://<container>.adom.cloud/proxy/<port>/`) is not a+workspace URL for this purpose: the cloud has no such route, so nothing is+sent and nothing is printed.+ ### Navigate response classes — Hydrogen probes URLs before applying  `webview navigate` and `open-or-refresh` now return structured responses based on URL reachability: