bootstrap
Adom Hydrogen (platform base)
Public Made by Adomby adom
Layer Hydrogen's workspace onto a standard Adom workstation.
← Commit history
Publish 0.5.2
15 files changed
+173−26
install.sh+5package.json+1−1page.json+1−1skills/hydrogen-adom-bridge/SKILL.md+11−10skills/hydrogen-api/SKILL.md+1−1skills/hydrogen-demo-recording/SKILL.md+2−2skills/hydrogen-embedded-bridge/SKILL.md+141skills/hydrogen-eval/SKILL.md+1−1skills/hydrogen-ports/SKILL.md+1−1skills/hydrogen-profile-menu/SKILL.md+1−1skills/hydrogen-screen-lock/SKILL.md+2−2skills/hydrogen-settings/SKILL.md+1−1skills/hydrogen-setup-steps/SKILL.md+1−1skills/hydrogen-skill-catalog/SKILL.md+2−2skills/hydrogen-skill-loop/SKILL.md+2−2install.sh+5@@ -219,3 +219,8 @@ log "done" # Heals pre-rename lockfile roots (hd-bootstrap, adom-desktop, ...) so the old # wiki pages/redirects can be deleted. Idempotent, best-effort, never fatal. bash "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/migrate-retired-slugs.sh" || true++# 2026-08-26 (0.4.3): hydrogen-embedded-ad renamed hydrogen-embedded-bridge+# (retired "ad" shorthand — see the hydrogen-naming glossary). Drop the stale+# old-name dir wherever an earlier version deployed it.+rm -rf "$HOME/.claude/skills/hydrogen-embedded-ad" "$HOME/.codex/skills/hydrogen-embedded-ad" 2>/dev/null || true
package.json+1−1@@ -4,7 +4,7 @@ "type": "bootstrap", "title": "Adom Hydrogen (platform base)", "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",- "version": "0.5.1",+ "version": "0.5.2", "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", "platform": "any",
page.json+1−1@@ -4,7 +4,7 @@ "type": "bootstrap", "title": "Adom Hydrogen (platform base)", "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",- "version": "0.5.1",+ "version": "0.5.2", "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": [
skills/hydrogen-adom-bridge/SKILL.md+11−10@@ -11,12 +11,12 @@ description: > product that ALSO connects Adom cloud containers to a user's machine. Hydrogen also has a BUILT-IN desktop bridge of its own that serves a subset of ab's verbs. READ THIS to understand your reach beyond the workspace and how to invoke it.- Trigger words — adom desktop, ab, ad cli, what can you do on my computer, reach+ Trigger words — adom desktop, ab, ab cli, what can you do on my computer, reach my machine, create a file on my pc, make a folder on my desktop, run a command on my machine, control the host, host screenshot, screenshot my screen, os screenshot, open a file on my computer, control my desktop, bridge to my pc,- send file to my desktop, pull file from my desktop, hd and ad, two apps, how- do hd and ad work together, talk to hydrogen desktop, desktop bridge, relay,+ send file to my desktop, pull file from my desktop, ah and ab, two apps, how+ do ah and ab work together, talk to hydrogen desktop, desktop bridge, relay, embedded mode, ab hidden, hd_status, hd_api, shell_execute, adom-bridge-cli ping, adom-bridge-cli status. ---@@ -29,10 +29,11 @@ actual operating system** — their real files, shell, screen, and desktop apps. Knowing ab exists is the difference between "I can only work in here" and "I can create that file on your Desktop, screenshot your screen, and open it in KiCad." -> **Platform reality (2026-06-12):** ab reaches the user's real **Windows**-> machine. macOS and Linux are *coming soon* — Hydrogen's host layer (screenshots,-> notifications, captions, window control) is currently Windows-only. Don't-> promise file/shell/screenshot actions on a Mac or Linux box yet.+> **Platform reality (2026-08-26):** ab ships on **Windows, macOS, and+> Ubuntu** (ab win / ab mac / ab ubuntu — see `definitions`). The host layer+> (screenshots, files, notifications, KiCad/Fusion control) works on all+> three; a few verbs remain per-platform (e.g. the Win32 window-identity+> family is Windows-only, TCC permission flows are macOS-only). ## Two apps, two jobs @@ -47,7 +48,7 @@ create that file on your Desktop, screenshot your screen, and open it in KiCad." Adom cloud container reach into a user's desktop. Rather than reinvent it, Hydrogen **bundles ab and makes it part of Hydrogen's install**, then puts it in *embedded mode* so the user only ever manages one app (ah). The two talk to each other-constantly. See [hydrogen-embedded-ad](../hydrogen-embedded-ad/SKILL.md) for the embedding+constantly. See [hydrogen-embedded-bridge](../hydrogen-embedded-bridge/SKILL.md) for the embedding mechanics (tray ownership, lifecycle, standalone↔embedded transitions). ## Hydrogen's built-in bridge vs the embedded ab (dual-client)@@ -100,7 +101,7 @@ re-document every verb here, this is a **capability map → the focused skill**: | **On-screen captions** | `caption` (always-on-top click-through overlay) | [hydrogen-captions](../hydrogen-captions/SKILL.md) | | **Open browsers** | `browser_*` (Pup) and the Browser Picker | [hydrogen-open-url](../hydrogen-open-url/SKILL.md), `pup` | | **Drive KiCad / Fusion 360 / Pup** | `kicad_*`, `fusion_*`, `browser_*` | [hydrogen-bridges](../hydrogen-bridges/SKILL.md) |-| **Embedded mechanics (tray/lifecycle)** | `desktop_embedded_*` | [hydrogen-embedded-ad](../hydrogen-embedded-ad/SKILL.md) — ab-served |+| **Embedded mechanics (tray/lifecycle)** | `desktop_embedded_*` | [hydrogen-embedded-bridge](../hydrogen-embedded-bridge/SKILL.md) — ab-served | For the complete verb list run `adom-bridge-cli list_commands` (or see the `adom-bridge-cli` skill).@@ -223,7 +224,7 @@ workspace itself (editor, files under `/home/adom/project`, the runtime), that's **Hydrogen**. Lead with what you can do, verify with `adom-bridge-cli ping`, then act. ## Related skills-- [hydrogen-embedded-ad](../hydrogen-embedded-ad/SKILL.md) — how Hydrogen installs + embeds ab (tray, lifecycle, standalone↔embedded)+- [hydrogen-embedded-bridge](../hydrogen-embedded-bridge/SKILL.md) — how Hydrogen installs + embeds ab (tray, lifecycle, standalone↔embedded) - [hydrogen-bridges](../hydrogen-bridges/SKILL.md) — the KiCad / Fusion / Puppeteer bridge ecosystem - [hydrogen-file-transfer](../hydrogen-file-transfer/SKILL.md) — send/pull files, browse + watch the host filesystem - [hydrogen-self-screenshot](../hydrogen-self-screenshot/SKILL.md) — host screenshots + window control
skills/hydrogen-api/SKILL.md+1−1@@ -13,7 +13,7 @@ description: > Trigger words: Hydrogen API, control API, Hydrogen endpoint, container exec, claude api, iframe eval, workspace tabs, setup run-all, workspace status, reload vscode, browser profiles, open url, virgin reset api, reboot api, diagnostics,- ad health, test window-tree, ai cursor, setup panel, screenshot mode.+ ab health, test window-tree, ai cursor, setup panel, screenshot mode. --- # Hydrogen Control API Reference
skills/hydrogen-demo-recording/SKILL.md+2−2@@ -8,8 +8,8 @@ description: > pipeline end to end: driving Hydrogen's control API (in-workspace OR from a remote container via adom-bridge-cli hd_api), the high-fps native recorder, multi-tab multi-prompt demos, getting the mp4 out (streamed binary, never base64), and the post-production handoff.- Trigger words: demo video, record a demo, hd demo, demo recording, record the typing,- screen record hd, record ai prompt, app demo, demo pipeline, speedup demo, tts overlay+ Trigger words: demo video, record a demo, ah demo, demo recording, record the typing,+ screen record ah, record ai prompt, app demo, demo pipeline, speedup demo, tts overlay demo, show what the app feels like, hydrogen-demo-recording. ---
skills/hydrogen-embedded-bridge/SKILL.mdadded+141@@ -0,0 +1,141 @@+---+name: hydrogen-embedded-bridge+description: How Hydrogen (ah) and Adom Bridge (ab) interact via "embedded mode". Use whenever the user asks about the system tray icon, why ab isn't visible, why two desktop apps are installed, the "Embedded · Hydrogen" footer pill, or how to make ab show up standalone. Trigger words — embedded mode, system tray, ab tray, why is adom desktop hidden, where's my tray icon, Hydrogen vs ab, both apps installed, why two installs, ab missing from tray, switch ab to standalone, ab won't show, run ab without Hydrogen, decouple ab from Hydrogen.+---++# Hydrogen ↔ ab Embedded Mode++There are two desktop apps in the Adom ecosystem: **Hydrogen (ah)** — the user-facing workspace app — and **Adom Bridge (ab)** — the bridge that talks to local apps (KiCad / Fusion 360 / Chrome / files). Hydrogen's installer silently installs ab (it fetches the latest ab from wiki.adom.inc at install time rather than carrying a copy) and runs it in **embedded mode**, where ab is invisible and Hydrogen's tray menu mirrors ab's controls.++This skill explains how the two interact so you can answer "why isn't ab in my tray?", "should I have two installs?", "why did the tray icon disappear?" and similar.++## Two modes++### Standalone ab (no Hydrogen anywhere)++How ab launches when nobody owns it:+- Tray icon visible in Windows notification area+- Main window opens on launch (unless `--start-hidden`)+- Autostart shortcut in `%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\AdomDesktop.lnk` → launches on every boot+- Registered in Add/Remove Programs (HKLM `Uninstall\AdomDesktop`)+- Auto-update polls `wiki.adom.inc/api/v1/pages/adom-bridge-cli/files/version.json` every 4h+- Footer shows the user's email + a "Sign in" / "Sign out" link++This is what ab looked like before Hydrogen existed and what it reverts to when Hydrogen vanishes.++### Embedded ab (Hydrogen owns it)++Hydrogen's installer puts ab into embedded mode by:+1. Writing `%LOCALAPPDATA%\Adom Bridge\embedded.json` marker (`{"owner":"hydrogen-desktop", ...}`)+2. Deleting ab's Desktop / Start Menu / Startup `.lnk` shortcuts so the user can't double-launch standalone ab+3. Configuring Hydrogen's own systray to mirror ab's menu (Open ab, Connect All, Disconnect All, Settings, etc.)++When Hydrogen spawns ab with `--embedded --start-hidden --relay-url ws://127.0.0.1:8765 --relay-name hydrogen-desktop`, ab detects embedded mode and:+- **Hides** its system tray (Hydrogen owns the one tray)+- **Suppresses** its autostart shortcut creation+- **Disables** its auto-updater (Hydrogen owns ab's update channel — Hydrogen installs the latest published ab at install time)+- **Hides** its main window on boot (Hydrogen's tray "Open Adom Bridge" menu item opens it on demand)+- **Skips** HKLM Uninstall registration (Hydrogen's installer offers cascade-uninstall of ab)+- Footer shows a read-only email + an "Embedded · Hydrogen" pill++Result: the user only ever sees one app (ah) in the tray + Start Menu, even though two processes (Hydrogen + ab) are running.++## How ab detects "am I embedded?" — 3-signal cascade++ab calls `embedded::detect_embedded_mode()` at boot. First match wins:++1. **CLI flag**: `--embedded` (or `--embedded-mode`) on the command line. Writes the marker file, owner defaults to `hydrogen-desktop`. **This is what Hydrogen spawns ab with.**+2. **Env var**: `ADOM_EMBEDDED=1` (or `true`). Same behavior as the flag.+3. **Marker file**: `%LOCALAPPDATA%\Adom Bridge\embedded.json` exists. ab then probes Hydrogen's **liveness beacon** on `127.0.0.1:9001` (a real port ab listens for — NOT Hydrogen's control API; Hydrogen's actual control API is **47084**):+ - If Hydrogen answers the beacon → embedded mode+ - If Hydrogen doesn't answer → ab treats the marker as stale, deletes it, falls back to standalone++If none of the three signals fire → standalone.++## Lifecycle ownership in embedded mode++Hydrogen's runtime supervisor:+- Reads Hydrogen's session token from `%APPDATA%\hydrogen-desktop\hydrogen-session.txt`+- Spawns ab detached with the embedded flags above+- Polls ab's direct API `/health` every 5s (stable port 24680 since ab 2.0.27; discovery-file first)+- If ab's health probe fails → Hydrogen respawns ab with the same args++Hydrogen's tray menu (mirrors ab's controls so the user gets all the ab verbs without seeing ab's tray):+```+Open Hydrogen+Reload Workspace+── Adom Bridge ──+Open Adom Bridge → POST 127.0.0.1:24680 desktop/window_show+Connect All → POST desktop/connect_all+Disconnect All → POST desktop/disconnect_all+Settings (Adom Bridge)→ POST desktop/window_show+─────+Quit → POST desktop/shutdown, 200ms grace, then app.exit(0)+```++Hydrogen's uninstaller PREUNINSTALL hook prompts "Also remove Adom Bridge?" → cascade-uninstalls ab on Yes.++## Runtime transitions++**ab ≥ v1.8.47** re-checks Hydrogen's liveness every 60s during runtime, not just at boot. This is the normal daily cycle for most users, not an edge case:++- Morning: user launches Hydrogen → Hydrogen spawns ab with `--embedded` → ab's tray hides, pill appears+- Evening: user quits Hydrogen → ab's next poll fails the Hydrogen probe → ab reverts to standalone → tray reappears+- Next morning: user launches Hydrogen again → ab's next poll succeeds → ab re-embeds → tray hides++The same ab process can flip mode back and forth indefinitely across an Hydrogen-quit / Hydrogen-relaunch cycle. Transitions:++| Current mode | Hydrogen probe says | What ab does |+|---|---|---|+| Standalone | dead | stay standalone (no-op) |+| Standalone | alive | → **embed**: hide tray, write marker, hide main window, show "Embedded · Hydrogen" pill |+| Embedded | dead | → **unembed**: show tray, delete marker, hide pill (main window left as-is) |+| Embedded | alive | stay embedded (refresh marker heartbeat in `last_seen`) |++Both transitions emit a `mode-changed` event so the frontend can update the footer pill in real time.++**ab ≤ v1.8.46** only checks at boot. If Hydrogen dies while ab is running, ab stays invisible in embedded mode until restart.++## Common questions++### "I don't see ab in my system tray on a Windows box with Hydrogen installed"++Expected. Hydrogen's installer deleted ab's autostart shortcut, so ab doesn't launch on boot. ab only runs when Hydrogen spawns it. Hydrogen's tray includes ab's menu items.++To verify: `tasklist | findstr adom-bridge-cli`. If ab's running, it's just hidden (per embedded mode). If not running, Hydrogen isn't either.++### "I want ab standalone — how do I unembed?"++- Quit Hydrogen+- Delete `%LOCALAPPDATA%\Adom Bridge\embedded.json`+- Launch ab via `%LOCALAPPDATA%\Adom Bridge\adom-bridge.exe`+- ab will detect no marker + no CLI flag → standalone mode → tray reappears++Or uninstall Hydrogen with "Yes, also remove Adom Bridge" → No → Hydrogen is gone, ab's marker is cleared, ab reverts to standalone on next launch. (Note: ab's autostart shortcut was deleted by Hydrogen's installer, so ab still won't auto-launch on boot until you re-run ab's installer to recreate it.)++### "Both Hydrogen and ab are installed — is that normal?"++Yes. Hydrogen's NSIS POSTINSTALL hook resolves the latest ab from wiki.adom.inc, verifies its published sha256, and silently runs that installer with `/S /NOLAUNCH`. If that can't happen (offline at install time), Hydrogen retries it on first launch. ab lives at `%LOCALAPPDATA%\Adom Bridge\`, Hydrogen at `%LOCALAPPDATA%\Hydrogen\`. Two separate exes, two separate Add/Remove Programs entries (well, only Hydrogen's is in Add/Remove if Hydrogen's installer ran the embedded-mode ab which skips HKLM register — ab ≥ v1.8.46).++### "ab's tray suddenly appeared even though Hydrogen is installed"++Hydrogen probably crashed or was closed. ab ≥ v1.8.47's runtime poll noticed Hydrogen is dead and reverted to standalone tray. The fix: relaunch Hydrogen from the Start Menu → ab's next poll detects Hydrogen → tray hides again.++### "Direct API for ab verbs"++ab listens on `127.0.0.1:24680` (stable since ab 2.0.27; legacy installs may still use 47200) for `POST /command` with `{"app":"desktop","command":"<verb>","args":{...}}`. The 7 user-visible verbs Hydrogen's tray uses:+- `window_show`, `window_hide`+- `connect_all`, `disconnect_all`+- `shutdown`+- `embedded_status` (returns `{embedded, owner, source, ...}`)+- `logout`++Port discovery order: `%USERPROFILE%\.adom\direct-api-port` (single line `host:port`, authoritative), then stable 24680, walk 24680-24689, legacy 47200-47209 last. Validate `service == "adom-bridge"` in /health before trusting a port.++## Source-of-truth references++- ab's mode detection: `adom-bridge-cli/src-tauri/src/embedded.rs:detect_embedded_mode()`+- Hydrogen's ab spawn: `hydrogen-desktop/src-tauri/crates/hydrogen-app/src/ad_supervisor.rs:spawn_ad_embedded()`+- Hydrogen's tray menu: `hydrogen-desktop/src-tauri/crates/hydrogen-app/src/tray.rs:install_tray()`+- Hydrogen's NSIS hook (embed-ab on install / offer-uninstall): `hydrogen-desktop/src-tauri/crates/hydrogen-app/installer/hydrogen-install.nsh.template`+- ab's release manifest (what Hydrogen reads at install time to find the latest ab): `wiki.adom.inc/api/v1/pages/adom-bridge-cli/files/version.json`
skills/hydrogen-eval/SKILL.md+1−1@@ -8,7 +8,7 @@ description: > value. Use it to build add-ons (e.g. a usage meter in the top bar), demo overlays (a moving arrow that points at things), highlight elements, read DOM state, or drive the UI. Works in dev AND release builds. Trigger words:- eval-in, inject ui, eval into hd, hd overlay, demo arrow, highlight element,+ eval-in, inject ui, eval into ah, ah overlay, demo arrow, highlight element, add-on, addon, usage meter, inject script, target shell, target workbench, target claude, find probe, eval-in targets, point at element, nav widget. ---
skills/hydrogen-ports/SKILL.md+1−1@@ -1,6 +1,6 @@ --- name: hydrogen-ports-description: How Hydrogen does port forwarding between your WSL2 workspace and your Windows machine — WSL2's automatic `0.0.0.0` localhost-forwarding (no port map to declare), the code-server `/proxy/<port>/` URL pattern that exposes any internal port, the port-forward registry for `127.0.0.1`-only services that WSL2 won't auto-forward, and the PortMappingsDialog UI. Use when the user asks "why isn't my server reachable", "how do I expose port X", "what's localhost:7380", "register a port", "auto-forward a port", or "the dynamic port dialog". Trigger words — port forwarding, ports, hd ports, container port, proxy port, code-server proxy, /proxy/, port mappings dialog, port hints, auto forward, expose port, register port, host port, dynamic port, ports.json, PortConfig, port resolver, localhost port not working.+description: How Hydrogen does port forwarding between your WSL2 workspace and your Windows machine — WSL2's automatic `0.0.0.0` localhost-forwarding (no port map to declare), the code-server `/proxy/<port>/` URL pattern that exposes any internal port, the port-forward registry for `127.0.0.1`-only services that WSL2 won't auto-forward, and the PortMappingsDialog UI. Use when the user asks "why isn't my server reachable", "how do I expose port X", "what's localhost:7380", "register a port", "auto-forward a port", or "the dynamic port dialog". Trigger words — port forwarding, ports, ah ports, container port, proxy port, code-server proxy, /proxy/, port mappings dialog, port hints, auto forward, expose port, register port, host port, dynamic port, ports.json, PortConfig, port resolver, localhost port not working. --- # Hydrogen Ports — forwarding workspace services to your Windows host
skills/hydrogen-profile-menu/SKILL.md+1−1@@ -1,6 +1,6 @@ --- name: hydrogen-profile-menu-description: Hydrogen's profile menu — the user-avatar dropdown in the top-right corner that links to your Adom profile/repositories/molecules pages on adom.inc and contains the logout action. Logout is gated by a confirm dialog and returns you to the Hydrogen login page; logging in is the gate to using Hydrogen at all (no anonymous use). Use when the user asks about "log out", "logout", "sign out", "Your profile", "Your repositories", "Your molecules", the avatar dropdown, the login page, or "why am I locked out". Trigger words — profile menu, avatar menu, top-right avatar, user menu, log out, logout, sign out, confirm logout, login gate, login page, your profile, your repositories, your molecules, adom.inc profile, hd locked out, hd login required, return to login.+description: Hydrogen's profile menu — the user-avatar dropdown in the top-right corner that links to your Adom profile/repositories/molecules pages on adom.inc and contains the logout action. Logout is gated by a confirm dialog and returns you to the Hydrogen login page; logging in is the gate to using Hydrogen at all (no anonymous use). Use when the user asks about "log out", "logout", "sign out", "Your profile", "Your repositories", "Your molecules", the avatar dropdown, the login page, or "why am I locked out". Trigger words — profile menu, avatar menu, top-right avatar, user menu, log out, logout, sign out, confirm logout, login gate, login page, your profile, your repositories, your molecules, adom.inc profile, ah locked out, ah login required, return to login. --- # Hydrogen Profile Menu
skills/hydrogen-screen-lock/SKILL.md+2−2@@ -8,8 +8,8 @@ description: > DXGI — neither holds the display wake-lock — so Hydrogen does not have the web leak. Hydrogen still must start→capture→release per op, cap recordings, and show a "● recording" indicator so a forgotten recording is never silent. Read before- adding or using Hydrogen screenshot / screen-recording features. Trigger words: hd- screenshot, hd recording, screen capture, wake lock, screensaver blocked,+ adding or using Hydrogen screenshot / screen-recording features. Trigger words: ah+ screenshot, ah recording, screen capture, wake lock, screensaver blocked, display won't sleep, ES_DISPLAY_REQUIRED, release capture, burn-in, powercfg requests, getDisplayMedia, recording auto-stop, max duration. ---
skills/hydrogen-settings/SKILL.md+1−1@@ -13,7 +13,7 @@ description: > compact ui, developer mode, vim mode, vim emulation, line numbers, code font, editor font, launch on boot, start with windows, show console, console on startup, 3d controls, control style, fusion solidworks blender orbit, schematic- nudge, auto approve, foreground hd, adom desktop window, turn on, turn off,+ nudge, auto approve, foreground ah, adom desktop window, turn on, turn off, change setting, how do I configure. ---
skills/hydrogen-setup-steps/SKILL.md+1−1@@ -1,6 +1,6 @@ --- name: hydrogen-setup-steps-description: What Hydrogen's setup steps did to prepare your workspace — the install sequence that provisions the golden workspace image, injects your Adom session, wires up the relay, and walks the Claude auth gate. Use this skill when the user asks "what did setup do", "why is X installed", "re-run a setup step", "what's a virgin reset", or "why did step N fail". Trigger words — setup steps, install steps, setup panel, virgin reset, re-run step, Run All, what did setup do, why is X installed, setup failed, install-tools, hd setup, claude code extension install, gallia install, hd workspace ready.+description: What Hydrogen's setup steps did to prepare your workspace — the install sequence that provisions the golden workspace image, injects your Adom session, wires up the relay, and walks the Claude auth gate. Use this skill when the user asks "what did setup do", "why is X installed", "re-run a setup step", "what's a virgin reset", or "why did step N fail". Trigger words — setup steps, install steps, setup panel, virgin reset, re-run step, Run All, what did setup do, why is X installed, setup failed, install-tools, ah setup, claude code extension install, gallia install, ah workspace ready. --- # Hydrogen Setup Steps — what was done to prepare your workspace
skills/hydrogen-skill-catalog/SKILL.md+2−2@@ -1,6 +1,6 @@ --- name: hydrogen-skill-catalog-description: The catalog of skills available to your Claude inside this Hydrogen workspace. Lists every public `hd-*` skill that ships with Hydrogen and explains what each one is for, so you can pick the right skill before doing anything Hydrogen-related. READ THIS FIRST when you're in a fresh Hydrogen workspace and want to know what Claude knows. Trigger words — hd skills, what skills do I have, hd catalog, skill index, skill list, what can claude do in hd, hd-* skills, browser picker, hd setup, hd container info, hd networking, hd volume, hd ports.+description: The catalog of skills available to your Claude inside this Hydrogen workspace. Lists every public `hd-*` skill that ships with Hydrogen and explains what each one is for, so you can pick the right skill before doing anything Hydrogen-related. READ THIS FIRST when you're in a fresh Hydrogen workspace and want to know what Claude knows. Trigger words — ah skills, what skills do I have, ah catalog, skill index, skill list, what can claude do in ah, hd-* skills, browser picker, ah setup, ah container info, ah networking, ah volume, ah ports. --- # Hydrogen Skill Catalog@@ -52,7 +52,7 @@ The bootstraps deploy both buckets: `shared/` rides adom/hydrogen-bootstrap and | `hydrogen-file-transfer` | Move files BOTH ways between the WSL2 workspace and the Windows PC (/mnt/c, \\wsl$, adom-bridge-cli relay). | | `hydrogen-tab-icons` | Webview tab icon customization (displayIcon API, brand colors, MDI/SVG). | | `hydrogen-profile-menu` | The avatar dropdown: profile/repos/molecules links and logout. |-| `hydrogen-embedded-ad` | Hydrogen ↔ Adom Bridge embedded mode: tray, hidden ab, footer pill. |+| `hydrogen-embedded-bridge` | Hydrogen ↔ Adom Bridge embedded mode: tray, hidden ab, footer pill. | | `hydrogen-self-screenshot` | How Claude screenshots Hydrogen panels + any host window (window control, multi-monitor), ralph loops, resize-before-Read rule. | | `hydrogen-capture-share` | The screen-share + "AI wants access" approval + countdown the AI triggers to capture the editor; tab/screen scopes, Webview/Pup window mode. | | `hydrogen-recording` | Record screen/window — Hydrogen's NATIVE WGC/DXGI recorder (h264/h265 mp4 → `recordings/`, no picker/banner, "record kicad"/"record whole screen", max-duration cap), plus ab desktop recording + the tab-vs-desktop footgun. |
skills/hydrogen-skill-loop/SKILL.md+2−2@@ -7,8 +7,8 @@ description: > hydrogen-desktop repo so the next golden-image bake ships it. These skills are the ONLY thing the in-workspace AI knows about Hydrogen — a wrong one confuses every Adom user. For Adom devs improving Hydrogen. Trigger words — this skill is wrong,- stale skill, fix the hd skill, update a skill, the AI got confused by a skill,- improve hd skills, skill is inaccurate, debug a skill, skill loop, write skill+ stale skill, fix the ah skill, update a skill, the AI got confused by a skill,+ improve ah skills, skill is inaccurate, debug a skill, skill loop, write skill back to repo, bake skills, golden image skills, skill feedback loop, perfect the skills, skill says X but it actually does Y. ---