bootstrap
Adom Hydrogen (macOS / Lima)
Public Made by Adomby adom
The macOS platform layer for Adom Hydrogen.
← Commit history
README.md+11−11@@ -3,7 +3,7 @@ The **macOS** platform layer for Adom Hydrogen. On a Mac, Hydrogen's workspace runs inside a **Lima Ubuntu VM** (`hd-builder`) that hosts the **`Adom-Workspace` systemd-nspawn machine**; this package adds everything specific to that runtime on-top of the platform-generic `adom/hd-bootstrap`.+top of the platform-generic `adom/hydrogen-bootstrap`. <img src="screenshots/workspace-macos.png" alt="Adom Hydrogen running natively on macOS — VS Code + Claude on the left, an Adom webview on the right, workspace in the local Lima/nspawn machine" width="760"> @@ -16,18 +16,18 @@ adom-wiki pkg install adom/hydrogen-mac-bootstrap --allow-sudo # the golden Li ``` adom/core ← Adom ecosystem (generic; shared with web Hydrogen)- └─ adom/hd-bootstrap ← Adom Hydrogen, platform-GENERIC- ├─ adom/hd-windows-bootstrap ← WSL2 runtime+ └─ adom/hydrogen-bootstrap ← Adom Hydrogen, platform-GENERIC+ ├─ adom/hydrogen-windows-bootstrap ← WSL2 runtime ├─ adom/hydrogen-mac-bootstrap ← THIS — Lima/nspawn runtime- └─ adom/hd-ubuntu-bootstrap ← native-Ubuntu runtime+ └─ adom/hydrogen-ubuntu-bootstrap ← native-Ubuntu runtime ``` -Each platform layer depends on `adom/hd-bootstrap`, which depends on `adom/core`,+Each platform layer depends on `adom/hydrogen-bootstrap`, which depends on `adom/core`, so `core` stays generic across web + desktop Hydrogen and every host OS. ## What this layer adds -- **Dependencies:** `adom/hd-bootstrap` (generic Hydrogen) + `adom/adom-workspace-updater`+- **Dependencies:** `adom/hydrogen-bootstrap` (generic Hydrogen) + `adom/adom-workspace-updater` (the in-machine systemd updater daemon). - **Bundled skills:** the macOS-runtime `hd-*` skills — `hydrogen-container`, `hydrogen-container-stats`, `hydrogen-networking`, `hydrogen-ports`, `hydrogen-port-watcher`, `hydrogen-setup`,@@ -58,10 +58,10 @@ Linux runs and how the host reaches it: ## The mixed-skill split (`<name>-mac` companions) -`adom/hd-bootstrap` carries the **31 platform-generic** `hd-*` skills. The Windows+`adom/hydrogen-bootstrap` carries the **31 platform-generic** `hd-*` skills. The Windows layer split **13 mixed** skills into `<name>-windows` companions (e.g. `hd-api-windows`, `hd-notifications-windows`, `hd-setup-windows`) — the generic core-stays in `hd-bootstrap`, the Windows half drops into `hd-windows-bootstrap`. This+stays in `hd-bootstrap`, the Windows half drops into `hydrogen-windows-bootstrap`. This layer carries the parallel **macOS halves** in `skills/<name>-mac/`. **Companions authored (11):**@@ -77,7 +77,7 @@ layer carries the parallel **macOS halves** in `skills/<name>-mac/`. - `hydrogen-ui-mac` — driving the UI via the `hd-ui-command`→`/ui/_result` command bus + `invoke_ui_action` (WKWebView has no CDP; raw CDP clicking is Windows-only). - `hydrogen-captions-mac` — workspace caption is platform-neutral; the desktop overlay (`desktop_caption`) is a **Windows-only** stub on macOS (honest gap). -> Reconcile the exact 13-skill set against `adom/hd-windows-bootstrap`'s companions+> Reconcile the exact 13-skill set against `adom/hydrogen-windows-bootstrap`'s companions > (its source is `--hide-source` sealed; read it from a workspace with org access). > The machine-bucket skills above ship whole (they map to the Windows layer's *clean* > skills, not its mixed companions).@@ -85,9 +85,9 @@ layer carries the parallel **macOS halves** in `skills/<name>-mac/`. > Note: the macOS-runtime skills in `skills/` that are **whole** (the `machine/` bucket > — `hydrogen-setup`, `hydrogen-container`, …) correspond to the Windows layer's *clean* skills, not > its mixed companions, so they ship complete rather than as `-mac` halves. The exact-> 13-skill set should be reconciled against `adom/hd-windows-bootstrap`'s companions+> 13-skill set should be reconciled against `adom/hydrogen-windows-bootstrap`'s companions > (its source is `--hide-source` sealed; read it from a workspace with org access). > NOTE — naming: the canonical sibling slug is **`hydrogen-mac-bootstrap`** (as referenced-> by `adom/hd-windows-bootstrap`'s own description and stack diagram), not+> by `adom/hydrogen-windows-bootstrap`'s own description and stack diagram), not > `hd-macos-bootstrap`.
SKILL.md+2−2@@ -1,6 +1,6 @@ --- name: hydrogen-mac-bootstrap-description: The macOS platform layer (adompkg bootstrap) for Adom Hydrogen — converges a Lima/nspawn Linux workspace to "ready to run inside Hydrogen on a Mac". Depends on adom/hd-bootstrap; bundles the macOS-runtime hd-* skills. Installed by the golden Lima image (hd-lima-image). Not an interactive skill — this is a bootstrap package.+description: The macOS platform layer (adompkg bootstrap) for Adom Hydrogen — converges a Lima/nspawn Linux workspace to "ready to run inside Hydrogen on a Mac". Depends on adom/hydrogen-bootstrap; bundles the macOS-runtime hd-* skills. Installed by the golden Lima image (hd-lima-image). Not an interactive skill — this is a bootstrap package. --- # adom/hydrogen-mac-bootstrap@@ -8,7 +8,7 @@ description: The macOS platform layer (adompkg bootstrap) for Adom Hydrogen — This is a **bootstrap package**, not an interactive skill. Installing it (`ADOMPKG_ALLOW_SUDO=1 adompkg install adom/hydrogen-mac-bootstrap`) converges a Lima Ubuntu / systemd-nspawn workspace to the macOS Adom Hydrogen runtime: it pulls-`adom/hd-bootstrap` (generic Hydrogen) + `adom/adom-workspace-updater`, and deploys the+`adom/hydrogen-bootstrap` (generic Hydrogen) + `adom/adom-workspace-updater`, and deploys the macOS-runtime `hd-*` skills. See README.md for the layered stack and the runtime differences vs. the Windows layer.
package.json+5−5@@ -4,8 +4,8 @@ "type": "bootstrap", "title": "Adom Hydrogen (macOS / Lima)", "brief": "The macOS platform layer for Adom Hydrogen.",- "version": "0.1.12",- "description": "The macOS platform layer for Adom Hydrogen, where the workspace runs in a Lima Ubuntu VM hosting the Adom-Workspace systemd-nspawn machine. Depends on adom/hd-bootstrap (the platform-generic Hydrogen layer) and adds everything specific to the Lima/nspawn runtime: the container/networking/ports/setup/topology/volume/workspace-lifecycle hd-* skills (the macOS-runtime bucket), the in-machine workspace-updater daemon, and the macOS code-server workbench seed. Sibling layers adom/hd-windows-bootstrap (WSL2) and adom/hd-ubuntu-bootstrap depend on the same adom/hd-bootstrap. This is the package the golden Lima image installs.",+ "version": "0.1.13",+ "description": "The macOS platform layer for Adom Hydrogen, where the workspace runs in a Lima Ubuntu VM hosting the Adom-Workspace systemd-nspawn machine. Depends on adom/hydrogen-bootstrap (the platform-generic Hydrogen layer) and adds everything specific to the Lima/nspawn runtime: the container/networking/ports/setup/topology/volume/workspace-lifecycle hydrogen-* skills (the macOS-runtime bucket), the in-machine workspace-updater daemon, and the macOS code-server workbench seed. Sibling layers adom/hydrogen-windows-bootstrap (WSL2) and adom/hydrogen-ubuntu-bootstrap depend on the same adom/hydrogen-bootstrap. This is the package the golden Lima image installs.", "org": "adom", "tags": [ "bootstrap",@@ -21,7 +21,7 @@ "install": "./install.sh" }, "dependencies": {- "adom/hd-bootstrap": "^0.2.0"+ "adom/hydrogen-bootstrap": "^0.3.0" }, "files": [ "install.sh",@@ -36,7 +36,7 @@ "type": "image", "path": "screenshots/hero-v3.png" },- "discovery_pitch": "The macOS platform layer for Adom Hydrogen — the Lima/nspawn workspace runtime plus every mac-specific hd-* skill.",+ "discovery_pitch": "The macOS platform layer for Adom Hydrogen \u2014 the Lima/nspawn workspace runtime plus every mac-specific hd-* skill.", "discovery_triggers": [ "Adom Hydrogen mac", "hydrogen on macos",@@ -68,4 +68,4 @@ "prompt": "is my Lima workspace machine healthy" } ]-}+}
page.json+34−3@@ -3,8 +3,8 @@ "type": "bootstrap", "slug": "hydrogen-mac-bootstrap", "title": "Adom Hydrogen (macOS / Lima)",- "brief": "The macOS platform layer for Adom Hydrogen — converges a Lima/nspawn workspace to the HD-on-Mac runtime.",- "version": "0.1.12",+ "brief": "The macOS platform layer for Adom Hydrogen.",+ "version": "0.1.13", "license": "proprietary", "visibility": "public", "metadata": {@@ -47,5 +47,36 @@ "label": "Workspace status", "prompt": "is my Lima workspace machine healthy" }- ]+ ],+ "description": "The macOS platform layer for Adom Hydrogen, where the workspace runs in a Lima Ubuntu VM hosting the Adom-Workspace systemd-nspawn machine. Depends on adom/hydrogen-bootstrap (the platform-generic Hydrogen layer) and adds everything specific to the Lima/nspawn runtime: the container/networking/ports/setup/topology/volume/workspace-lifecycle hydrogen-* skills (the macOS-runtime bucket), the in-machine workspace-updater daemon, and the macOS code-server workbench seed. Sibling layers adom/hydrogen-windows-bootstrap (WSL2) and adom/hydrogen-ubuntu-bootstrap depend on the same adom/hydrogen-bootstrap. This is the package the golden Lima image installs.",+ "org": "adom",+ "tags": [+ "bootstrap",+ "adom-hydrogen",+ "hydrogen",+ "macos",+ "mac",+ "lima",+ "nspawn"+ ],+ "needs_sudo": false,+ "scripts": {+ "install": "./install.sh"+ },+ "dependencies": {+ "adom/hydrogen-bootstrap": "^0.3.0"+ },+ "files": [+ "install.sh",+ "skills/**",+ "README.md",+ "SKILL.md",+ "page.json",+ "docs/**",+ "screenshots/**"+ ],+ "author": {+ "name": "Kyle Bergstedt",+ "email": "[email protected]"+ } }