Adom Hydrogen (macOS)

@@ -1,3 +1,52 @@ # Hydrogen Desktop (macOS) -The full Adom Hydrogen workspace as a native macOS app (Apple Silicon).+The full Adom Hydrogen workspace as a native **macOS** app — AI-driven electronics+design, running locally on Apple Silicon.++This is the macOS port of [Hydrogen Desktop](/adom/hydrogen-desktop) (the Windows+release). It is **self-contained**: the app ships its own Lima runtime and the+workspace golden image, so first launch runs the entire setup **with no extra+installs and no clicks** — no Homebrew, no Docker, no manual prerequisites.++## Requirements++- **Apple Silicon** Mac (M1 or newer) — arm64 only.+- **macOS 13 (Ventura) or later** — uses Apple's Virtualization.framework.+- ~3 GB free disk for the workspace VM + image.++## Install++```bash+adompkg install hydrogen-desktop-macos+```++Or download the DMG, open it, and drag **Hydrogen Desktop** to **Applications**.++> **First launch:** this build is not yet notarized, so macOS Gatekeeper may warn the+> first time you open it. If so, **right-click the app → Open** once to approve it.+> After that it launches normally. (Screen-recording and similar permissions, if+> prompted, can be granted afterward in System Settings → Privacy & Security.)++## What happens on first launch++The app runs the workspace setup automatically — zero clicks:++1. Brings up its bundled Lima utility VM (Apple Virtualization.framework, no QEMU).+2. Imports the workspace machine from the bundled golden image and boots it.+3. Starts the editor (code-server) and connects the AI workspace.++x86-64 Adom tools run under Rosetta inside the workspace; native arm64 code-server /+Node / Claude run directly.++## Uninstall++```bash+adompkg uninstall hydrogen-desktop-macos+```++This removes the app. To also remove the workspace VM and cached image:++```bash+limactl delete hd-builder+rm -rf "$HOME/Library/Application Support/adom"+```

@@ -0,0 +1,38 @@+#!/usr/bin/env bash+# Install Hydrogen Desktop (macOS) — mounts the bundled DMG and copies the app to+# /Applications. The .app is self-contained: it ships its own Lima runtime + the+# workspace golden image, so first launch runs the whole setup with no extra installs.+#+# Apple Silicon only (arm64). Runs from the extracted adompkg module dir.+set -euo pipefail++if [ "$(uname)" != "Darwin" ]; then+  echo "ERROR: Hydrogen Desktop (macOS) installs only on macOS." >&2; exit 1+fi+if [ "$(uname -m)" != "arm64" ]; then+  echo "ERROR: this build is Apple Silicon (arm64) only." >&2; exit 1+fi++DMG="$(ls dist/macos/*.dmg 2>/dev/null | head -1)"+[ -n "$DMG" ] || { echo "ERROR: no DMG found in dist/macos/." >&2; exit 1; }++MNT="$(mktemp -d)"+cleanup() { hdiutil detach "$MNT" >/dev/null 2>&1 || true; }+trap cleanup EXIT++echo "Mounting $DMG …"+hdiutil attach "$DMG" -nobrowse -mountpoint "$MNT" >/dev/null+APP="$(ls -d "$MNT"/*.app 2>/dev/null | head -1)"+[ -n "$APP" ] || { echo "ERROR: no .app inside the DMG." >&2; exit 1; }++DEST="/Applications/$(basename "$APP")"+echo "Installing $(basename "$APP") to /Applications …"+rm -rf "$DEST"+cp -R "$APP" /Applications/+# Drop the quarantine flag so first launch isn't blocked by Gatekeeper. NOTE: this+# build is not yet notarized — until it is, macOS may still warn on first open+# (right-click → Open once). See the README.+xattr -dr com.apple.quarantine "$DEST" 2>/dev/null || true++echo "OK: installed $DEST"+echo "Launch it from /Applications or Spotlight. First run sets everything up automatically."

@@ -0,0 +1,12 @@+{+  "name": "hydrogen-desktop-macos",+  "slug": "hydrogen-desktop-macos",+  "type": "app",+  "version": "0.1.51",+  "description": "The full Adom Hydrogen experience as a native macOS desktop app (Apple Silicon).",+  "dependencies": {},+  "scripts": {"install": "./install.sh", "uninstall": "./uninstall.sh"},+  "files": ["README.md", "page.json", "install.sh", "uninstall.sh", "dist/**", "screenshots/**"],+  "install": {"binary_name": "hydrogen-desktop-macos"},+  "metadata": {"platform": "macos", "arch": "arm64"}+}

@@ -3,28 +3,10 @@   "type": "app",   "slug": "hydrogen-desktop-macos",   "title": "Hydrogen Desktop (macOS)",-  "brief": "The full Adom Hydrogen workspace as a native macOS app (Apple Silicon).",-  "version": "0.0.0",-  "visibility": "private",-  "install": {-    "binary_name": "hydrogen-desktop-macos",-    "install_dir": "",-    "install_hint": "",-    "version_cmd": ""-  },-  "author": {-    "id": "695820315b5f1e4db2fcf602",-    "name": "Kyle Bergstedt",-    "email": "[email protected]"-  },-  "tags": [],+  "brief": "The full Adom Hydrogen workspace as a native macOS app (Apple Silicon) — AI-driven electronics design, running locally.",+  "version": "0.1.51",+  "install": {"binary_name": "hydrogen-desktop-macos"},   "license": "proprietary",-  "hero": null,-  "sample_prompts": [],-  "discovery_triggers": [],-  "discovery_pitch": null,-  "metadata": {},-  "created_at": "2026-06-17T14:31:08.365Z",-  "updated_at": "2026-06-17T14:31:08.365Z",-  "skills": []-}\ No newline at end of file+  "visibility": "private",+  "metadata": {"platform": "macos", "arch": "arm64", "kind": "desktop-app"}+}

@@ -0,0 +1,13 @@+#!/usr/bin/env bash+# Uninstall Hydrogen Desktop (macOS): remove the app. Leaves the user's workspace+# data and the Lima utility VM in place (remove those manually if desired:+#   limactl delete hd-builder   # destroys the HD utility VM+#   rm -rf "$HOME/Library/Application Support/adom"   # cached golden image + state+set -euo pipefail+DEST="/Applications/Hydrogen Desktop.app"+if [ -d "$DEST" ]; then+  rm -rf "$DEST"+  echo "OK: removed $DEST"+else+  echo "Hydrogen Desktop is not installed in /Applications."+fi