bootstrap
Adom Hydrogen (platform base)
Public Made by Adomby adom
Layer Hydrogen's workspace onto a standard Adom workstation.
← Commit history
Publish 0.5.82
4 files changed
+23−47
install.shpackage.json+3−3@@ -4,7 +4,7 @@ "type": "bootstrap", "title": "Adom Hydrogen (platform base)", "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",- "version": "0.5.81",+ "version": "0.5.82", "description": "Hydrogen's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen on ANY platform: the runtime-neutral hydrogen-* skills and the generic editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hydrogen-windows-bootstrap (WSL2), adom/hydrogen-mac-bootstrap, adom/hydrogen-ubuntu-bootstrap. The reference design other orgs copy to build their own bootstrap on adom/core.", "org": "adom", "tags": [@@ -48,5 +48,5 @@ "grok bot", "connect grok" ],- "changelog": "0.5.79: hydrogen-overview tells you how to list the platform layer's skills; hydrogen-adom-bridge names the pup_record_* verbs. Includes 0.5.78: skill cleanup (shorter valid descriptions, retired names replaced, dead skill links fixed, single Hydrogen index, dev-only skills hidden, AppleDouble junk removed)."-}+ "changelog": "0.5.82: hydrogen-welcome gives the address that works on an installed build (the control API, not the localhost:1420 dev server) and describes today's page."+}
page.json+2−2@@ -4,7 +4,7 @@ "type": "bootstrap", "title": "Adom Hydrogen (platform base)", "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",- "version": "0.5.81",+ "version": "0.5.82", "description": "Hydrogen's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen on ANY platform: the runtime-neutral hydrogen-* skills and the generic editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hydrogen-windows-bootstrap (WSL2), adom/hydrogen-mac-bootstrap, adom/hydrogen-ubuntu-bootstrap. The reference design other orgs copy to build their own bootstrap on adom/core.", "org": "adom", "tags": [@@ -64,5 +64,5 @@ "grok bot", "connect grok" ],- "changelog": "0.5.79: hydrogen-overview tells you how to list the platform layer's skills; hydrogen-adom-bridge names the pup_record_* verbs. Includes 0.5.78: skill cleanup (shorter valid descriptions, retired names replaced, dead skill links fixed, single Hydrogen index, dev-only skills hidden, AppleDouble junk removed)."+ "changelog": "0.5.82: hydrogen-welcome gives the address that works on an installed build (the control API, not the localhost:1420 dev server) and describes today's page." }
skills/hydrogen-welcome/SKILL.md+18−42@@ -1,66 +1,43 @@ --- name: hydrogen-welcome description: >-- The Hydrogen welcome page shown after setup completes: a local static page- (welcome.html) with an Open Claude Code button, not the adom.inc homepage. Use when- asked about the welcome page or tab, or to show the welcome page again.+ The Hydrogen welcome page shown after setup completes ("Your workspace is ready"): a page+ built into the app and served by the control API, not the adom.inc homepage. Use when asked+ about the welcome page or tab, or to show the welcome page again. --- # Hydrogen Welcome Page -The welcome page is a static HTML page bundled with Hydrogen at `static/welcome.html`.-It's served locally at `http://localhost:1420/welcome.html` by Hydrogen's dev file server.+The welcome page is `static/welcome.html`, compiled into the Hydrogen app. Hydrogen's control+API serves it at `<control URL>/welcome.html?control=<control port>`. The `control` parameter+tells the page's buttons which port to call, and the port is dynamic: read it from+`~/.adom/hd-control-url` (47084 by default). `localhost:1420` is the dev server and does not+answer on an installed build. ## What it shows -- Adom logo and branding-- "Build and test electronics in the cloud"-- Description of the Adom cloud factory-- "Open Claude Code" button-- Links to documentation+- The Adom logo and "Your workspace is ready"+- A checklist: VS Code, Your AIs (who is signed in), Adom skills, Adom Bridge+- **Manage AIs** when an AI is signed in, or **Choose your AI** when none is ## When it appears -- Automatically as the final setup step — the `open-welcome` gate (the last step of the+- Automatically as the final setup step, the `open-welcome` gate (the last step of the setup cascade for the active runtime).-- Can be opened manually via the API+- Any time on request (below). ## How to open it -### From inside the workspace (the standard way)--This is how the setup steps do it, and how any AI inside the workspace should:- ```bash+C=$(cat ~/.adom/hd-control-url) adom-cli hydrogen webview open-or-refresh \ --name Welcome \- --url http://localhost:1420/welcome.html \+ --url "$C/welcome.html?control=${C##*:}" \ --panel-id desktop-pane-right ``` -`localhost:1420` is Hydrogen's dev file server running on the host (where Hydrogen itself runs),-NOT anything inside the workspace. Hydrogen's webview renders the URL against the host, so the-page resolves on whatever platform Hydrogen is running on.--### From outside (via Hydrogen control API)--The workspace tabs API doesn't reliably store the URL in panelState when-creating tabs. The reliable method is to navigate an existing webview iframe:--```bash-# Method 1: Navigate right-pane iframe via eval (reliable)-# control-API port is dynamic (47084 default — see hydrogen-networking)-curl -X POST http://127.0.0.1:47084/eval \- -H Content-Type:application/json \- -d '{"js":"(function(){var iframes=document.querySelectorAll(\"iframe\");for(var i=0;i<iframes.length;i++){var r=iframes[i].getBoundingClientRect();if(r.x>400&&r.width>200){iframes[i].src=\"http://localhost:1420/welcome.html\";return \"ok\"}}return \"no iframe\"})()"}'--# Method 2: Create tab then navigate (2 steps)-# Step 1: Create tab-curl -X POST http://127.0.0.1:47083/api/workspaces/editor/{owner}/{repo}/current/tabs \- -H Content-Type:application/json \- -d '{"name":"Welcome","panelType":"adom/a1b2c3d4-0031-4000-a000-000000000031","panelId":"desktop-pane-right","panelState":{"url":"http://localhost:1420/welcome.html","displayName":"Welcome","displayIcon":"mdi:hand-wave"}}'-# Step 2: If URL didn't load, navigate the iframe via eval (Method 1)-```+Setup's own step runs this same command. Then look: if the tab is listed but the pane still+shows the previous tab, run `adom-cli hydrogen workspace active-tab --name Welcome`. ## IMPORTANT: This is NOT @@ -68,8 +45,7 @@ curl -X POST http://127.0.0.1:47083/api/workspaces/editor/{owner}/{repo}/current - NOT the Adom wiki (https://wiki.adom.inc) - NOT the VS Code welcome tab inside code-server -It is a LOCAL static page at `http://localhost:1420/welcome.html`, bundled-in `static/welcome.html` in the Hydrogen repo.+It is `static/welcome.html` from the Hydrogen repo, served locally by the control API. ## Panel type