← Commit history

Publish Hydrogen Desktop public release page

John Lauer ·13b229b78e ·4mo ago ·parent e154b97
8 files changed +158−30
README.md+65−1
@@ -1,3 +1,67 @@ # Hydrogen Desktop -The full Adom Hydrogen workspace as a native Windows app — AI-driven electronics design, running locally.+**The full Adom Hydrogen workspace as a native Windows app — AI-driven electronics design, running locally.**++![Hydrogen Desktop — your workspace is ready](screenshots/hero.png)++Hydrogen Desktop is the entire Adom Hydrogen experience — the editor, the AI agent, your repositories, molecules, and the electronics-design toolchain — packaged as one signed Windows application that runs on your own machine. Sign in with your Adom account and Hydrogen Desktop provisions a complete local workspace for you: a Linux dev environment, VS Code, Claude Code, the Gallia skills for schematic + PCB work, and a desktop bridge to your local hardware. No browser tab, no cloud container to wait on — it's your workspace, local and fast.++> **Windows only.** Hydrogen Desktop is a signed Windows desktop application (`.exe`). `adompkg install` on a Linux/WSL2 container only **stages** the installer — it does not run it. Copy the staged `.exe` to a Windows machine and run it there.++## What you get++After a one-time guided setup, Hydrogen Desktop gives you a ready-to-use, fully local workspace:++- **VS Code** with the Adom workspace, dark mode, and a clean layout.+- **Claude Code** wired in and ready to pair — drive the whole environment in natural language.+- **Gallia skills** for hardware design — schematic capture, PCB layout, KiCad + Fusion automation, part search.+- **Desktop bridge** connecting the workspace to your local machine (KiCad, Fusion 360, Puppeteer/Chrome).++![Editor, Adom Wiki, and the Claude agent side by side](screenshots/workspace.png)++## Install++This wiki package stages the signed Windows installer:++```+adompkg install adom/hydrogen-desktop+```++That places `Hydrogen.Desktop_<version>_x64-setup.exe` in your `~/Downloads`. Copy it to a Windows machine and run it.++On Windows, the installer is a single guided flow — it's signed by **Adom Industries, Inc.**, so Windows SmartScreen recognizes the publisher.++![The signed Adom installer on Windows](screenshots/install.png)++## First run — guided setup++The first time you launch Hydrogen Desktop it runs a one-time setup cascade that stands up your local workspace:++1. Sign in with your Adom account (it drives your native browser — one approval and you're in).+2. Authorize Claude Code the same way.+3. Hydrogen Desktop enables WSL2 if needed (one Windows restart), imports the Adom workspace image locally, and starts VS Code, Claude Code, and the desktop bridge.++When the cascade finishes you'll see **"Your workspace is ready"** with green checks across the board. From then on, launches are fast — the workspace is already on your machine.++## Requirements++- Windows 10/11 (x64).+- WSL2 (Hydrogen Desktop enables it for you on first run; that step needs one restart).+- An Adom account (sign in on first launch).++## Talk to the AI++Once you're in, Claude Code can drive the whole workspace. Try:++- "Open my repositories and show me what changed recently."+- "Create a new molecule and start a schematic."+- "Run the KiCad bridge and route the power traces on this board."+- "Re-run the setup step that failed."++## Source & build++Hydrogen Desktop is built privately and shipped publicly. The source, build pipeline, and signing process live on the private **`adom/hydrogen-desktop-dev`** page (Adom employees only).++---++*Signed by Adom Industries, Inc. · Windows x64 · Built on the Adom Hydrogen platform.*
SKILL.mdadded+66
@@ -0,0 +1,66 @@+---+name: hydrogen-desktop+description: >+  Install, launch, and operate Hydrogen Desktop — the full Adom Hydrogen workspace as a+  native signed Windows app (local VS Code + Claude Code + Gallia hardware-design skills ++  desktop bridge). Use when the user wants to install Hydrogen Desktop, stage the Windows+  installer, understand the first-run setup cascade, or troubleshoot a workspace that won't+  come up. Trigger words: hydrogen desktop, install hydrogen desktop, HD installer, native+  hydrogen app, windows hydrogen, adom desktop workspace, first-run setup, workspace not ready.+---++# Hydrogen Desktop (operate)++Hydrogen Desktop is the entire Adom Hydrogen experience as **one signed Windows app** that runs a+complete workspace **locally** on the user's machine: VS Code, Claude Code, the Gallia+hardware-design skills, and a desktop bridge to local tools (KiCad, Fusion 360, Puppeteer).++> **Platform: Windows only.** The shipped artifact is a signed `.exe`. Installing this package on a+> Linux/WSL2 container only **stages** the installer — it cannot run it there.++## Install (stage the signed installer)++```+adompkg install adom/hydrogen-desktop+```++This copies `Hydrogen.Desktop_<version>_x64-setup.exe` into `~/Downloads`. Move it to a Windows+machine and run it. The installer is signed by **Adom Industries, Inc.** (recognized by Windows+SmartScreen).++## First run (one-time setup cascade)++On first launch HD stands up the local workspace automatically:++1. **Adom sign-in** — HD opens the user's native browser to the Adom sign-in/approve page. One+   approval and the session is captured. (If the browser isn't signed in, the user signs in once.)+2. **Claude authorization** — same native-browser flow for Claude Code.+3. **Workspace provisioning** — HD enables WSL2 if needed (**one Windows restart**), imports the+   Adom workspace image locally, then starts VS Code, Claude Code, the relay, and the desktop bridge.++Done = the setup panel shows **"Your workspace is ready"** with green checks. Subsequent launches are+fast (the workspace is already local).++## Requirements++- Windows 10/11 x64.+- WSL2 (HD enables it on first run — that step requires one restart).+- An Adom account.++## Troubleshooting++- **A setup step failed (red in the panel):** open the setup panel and re-run that step; the cascade+  is resumable.+- **"Your workspace is ready" never appears:** the most common cause is the WSL2-enable restart not+  having happened yet — restart Windows once, relaunch HD, and the cascade continues.+- **Sign-in didn't auto-complete:** make sure the user's browser is signed in to adom.inc (and+  claude.ai), then re-trigger the sign-in step.++## What it is / isn't++- It **is** the full local Hydrogen workspace — no cloud container, no browser tab.+- The Adom login is **identity only**; the dev environment (VS Code, Claude, tools) runs locally in+  a WSL2 Linux distro on the user's own machine.++For the source, build pipeline, and signing process (Adom employees only), see the private+`adom/hydrogen-desktop-dev` page.
install.shadded+10
@@ -0,0 +1,10 @@+#!/bin/bash+# Hydrogen Desktop — staged install. This is a WINDOWS desktop app; this script only STAGES+# the signed installer (it cannot run on this Linux/WSL2 container). Run the .exe on Windows.+set -e+DEST="${1:-$HOME/Downloads}"+mkdir -p "$DEST"+SRC="$(cd "$(dirname "$0")" && pwd)/dist/win"+cp "$SRC/"*.exe "$DEST/" 2>/dev/null || { echo "no installer found in dist/win"; exit 1; }+echo "Staged Hydrogen Desktop installer to: $DEST"+echo "→ Copy it to a Windows machine and run it. (Signed by Adom Industries, Inc.)"
package.jsonadded+15
@@ -0,0 +1,15 @@+{+  "name": "hydrogen-desktop",+  "version": "0.1.11",+  "description": "The full Adom Hydrogen experience as a native Windows desktop app.",+  "files": [+    "SKILL.md",+    "README.md",+    "page.json",+    "install.sh",+    "dist/**",+    "screenshots/**"+  ],+  "install": { "binary_name": "hydrogen-desktop" },+  "metadata": { "platform": "windows" }+}
page.json+2−29
@@ -1,33 +1,6 @@ {-  "schema_version": 1,-  "type": "app",-  "slug": "hydrogen-desktop",   "title": "Hydrogen Desktop",   "brief": "The full Adom Hydrogen workspace as a native Windows app — AI-driven electronics design, running locally.",   "version": "0.1.11",-  "visibility": "public",-  "install": {-    "binary_name": "hydrogen-desktop",-    "install_dir": "",-    "install_hint": "",-    "version_cmd": ""-  },-  "metadata": {-    "platform": "windows",-    "kind": "desktop-app"-  },-  "author": {-    "id": "6738b00a4dc87b8adbb0a5a3",-    "name": "John Lauer",-    "email": "[email protected]"-  },-  "tags": [],-  "license": "proprietary",-  "hero": null,-  "sample_prompts": [],-  "discovery_triggers": [],-  "discovery_pitch": null,-  "created_at": "2026-06-12T21:08:04.397Z",-  "updated_at": "2026-06-12T21:08:04.397Z",-  "skills": []-}\ No newline at end of file+  "metadata": { "platform": "windows", "kind": "desktop-app" }+}
screenshots/hero.pngadded
⋯ 1 unchanged line ⋯
screenshots/install.pngadded
⋯ 1 unchanged line ⋯
screenshots/workspace.pngadded
⋯ 1 unchanged line ⋯