Adom Hydrogen (Linux)
Public Made by Adomby adom
The Linux platform layer for Adom Hydrogen: Ubuntu, Debian and Fedora, the workspace and the computer.
d8a45ab
name: hydrogen-welcome description: >- 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 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
- 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
- While the workspace is still starting (after an update, a reload or a wake) the AI and Adom Bridge rows say checking instead of "none signed in" or "starting up", and recheck every 5 s until they have a real answer (1.0.734+)
After someone signs in to an AI in the Choose-your-AI dialog (the first-run one or the one this page's button opens), Hydrogen opens a new chat with that AI when the dialog closes, Claude first if several were signed in, with an empty chat box (1.0.745+). Nothing is typed for them.
On Linux the Adom Bridge row reads "not running" until Hydrogen has installed and started Adom Bridge, which it does when a Linux build is published for the user's account; desktop features (screenshots, KiCad, pup) wait for it. Everything else on the page does not depend on it.
When it appears
- Automatically as the final setup step, the
open-welcomegate (the last step of the setup cascade for the active runtime). - Any time on request (below).
How to open it
C=$(cat ~/.adom/hd-control-url)
adom-cli hydrogen webview open-or-refresh \
--name Welcome \
--url "$C/welcome.html?control=${C##*:}" \
--panel-id desktop-pane-right
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
- NOT the adom.inc homepage (https://adom.inc)
- NOT the Adom wiki (https://wiki.adom.inc)
- NOT the VS Code welcome tab inside code-server
It is static/welcome.html from the Hydrogen repo, served locally by the control API.
Panel type
Webview tabs in Hydrogen use panel type adom/a1b2c3d4-0031-4000-a000-000000000031.
Do NOT use panelType: "webview": that shows "Unknown panel type" error.
---
name: hydrogen-welcome
description: >-
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 `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
- 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
- While the workspace is still starting (after an update, a reload or a wake) the AI and Adom
Bridge rows say **checking** instead of "none signed in" or "starting up", and recheck every
5 s until they have a real answer (1.0.734+)
After someone signs in to an AI in the Choose-your-AI dialog (the first-run one or the one this
page's button opens), Hydrogen opens a new chat with that AI when the dialog closes, Claude first
if several were signed in, with an empty chat box (1.0.745+). Nothing is typed for them.
On Linux the Adom Bridge row reads "not running" until Hydrogen has installed and started Adom
Bridge, which it does when a Linux build is published for the user's account; desktop features
(screenshots, KiCad, pup) wait for it. Everything else on the page does not depend on it.
## When it appears
- Automatically as the final setup step, the `open-welcome` gate (the last step of the
setup cascade for the active runtime).
- Any time on request (below).
## How to open it
```bash
C=$(cat ~/.adom/hd-control-url)
adom-cli hydrogen webview open-or-refresh \
--name Welcome \
--url "$C/welcome.html?control=${C##*:}" \
--panel-id desktop-pane-right
```
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
- NOT the adom.inc homepage (https://adom.inc)
- NOT the Adom wiki (https://wiki.adom.inc)
- NOT the VS Code welcome tab inside code-server
It is `static/welcome.html` from the Hydrogen repo, served locally by the control API.
## Panel type
Webview tabs in Hydrogen use panel type `adom/a1b2c3d4-0031-4000-a000-000000000031`.
Do NOT use `panelType: "webview"`: that shows "Unknown panel type" error.