bootstrap

Hydrogen Desktop Bootstrap for Windows (apps + skills)

Public Made by Adom

by adom

The Windows (WSL2) platform layer for Hydrogen Desktop.

bootstraphydrogen-desktophdwindowswsl2
Overview Files Skills Packages Releases Dependencies Issues Breadcrumbs Pull Requests Activity
Propose a change
Name Last commit message Last updated
docs Publish 0.2.3 5d ago
screenshots Add hero asset screenshots/hero.png 1mo ago
skills Publish 0.2.7 4d ago
install.sh Publish 0.2.8 1d ago
package.json Publish 0.2.8 1d ago
page.json Publish 0.2.8 1d ago
postinstall.sh Publish 0.2.3 5d ago
README.md Publish 0.2.8 1d ago

adom/hd-windows-bootstrap

The Windows (WSL2) platform layer for Hydrogen Desktop. On Windows, HD's workspace runs inside a WSL2 Ubuntu distro; this package adds everything specific to that runtime on top of the platform-generic adom/hd-bootstrap.

adompkg install adom/hd-windows-bootstrap     # the golden WSL2 image installs this

The platform-layered bootstrap stack

adom/core                         ← Adom ecosystem (generic; shared with web Hydrogen)
  └─ adom/hd-bootstrap            ← Hydrogen Desktop, platform-GENERIC
       ├─ adom/hd-windows-bootstrap   ← THIS — WSL2 runtime
       ├─ adom/hd-mac-bootstrap       ← (Kyle)
       └─ adom/hd-ubuntu-bootstrap    ← (Barrett)

Each platform layer depends on adom/hd-bootstrap, which depends on adom/core. Colby's hydrogen-web bootstrap depends on adom/core too, so core stays generic across web + desktop Hydrogen.

What this layer adds

  • Dependencies: adom/hd-bootstrap (generic HD) + ~~adom/adom-workspace-updater~~ (RETIRED 2026-07-16, dep removed in 0.2.3) (the in-distro systemd updater daemon — WSL2/systemd-specific).
  • Bundled skills: the WSL2-runtime hd-* skills (container, networking, ports, port-watcher, setup, setup-steps, topology, volume, workspace-lifecycle, workspace-monitoring, container-stats).
  • postinstall: deploys those skills + seeds the WSL2 code-server workbench.html (trusted domains + activity-bar). Install requires ADOMPKG_ALLOW_SUDO=1 (the updater dep is needs_sudo).

The skill split (v0.2.0 — real per-skill reclassification)

All 46 hd-* skills were read and classified by what's platform-generic vs Windows-specific (not the old shared/wsl2 buckets):

  • Generic skills (31) live in adom/hd-bootstrap.
  • Clean Windows skills (15) live here — e.g. hd-browser-picker (WebView2), hd-recording (WGC/DXGI), hd-runtime-mode, hd-networking, hd-ports, hd-workspace-lifecycle, the golden-image/WSL2 skills.
  • Mixed skills were split: the generic core stays in hd-bootstrap, and the Windows specifics become a <name>-windows companion here (13 of them — e.g. hd-api-windows carries the /wsl/* endpoint tables, hd-notifications-windows the WinRT/AUMID toast mechanics, hd-setup-windows the WSL2 install cascade). Distinct names mean both layers coexist with no deploy collision.

Still a collaborative pass with Kyle (Mac) and Barrett (Ubuntu): anything in hd-bootstrap that turns out to break off-Windows moves down into the platform layers.