app
Adom Hydrogen
Public Made by Adomby adom
The whole Adom experience as one signed native app: your editor, your AI agent, and the full electronics design toolchain, running locally on your own machine.
← Commit history
README: add Adom Desktop section (auto-installed bridge, link to AD wiki page) + 3 feature sections (local WSL2 container, Adom-wiki community discovery, AI that designs alongside you); fold in Under-the-hood
1 file changed
+30−6
README.md+30−6@@ -54,6 +54,36 @@ When the cascade finishes you're looking at a fully configured editor with Claud --- +## Adom Desktop — the bridge to your real machine++Hydrogen Desktop installs **Adom Desktop (AD)** for you automatically. When you run the HD installer, it bundles and installs the matching signed Adom Desktop build in the same pass — it checks your installed version first and never downgrades a newer AD you already have — and from then on HD runs it embedded: AD lives quietly in the background and HD owns the system tray, so there's nothing extra for you to launch or manage.++Adom Desktop is the **bridge between your sandboxed Linux workspace and the rest of your real Windows machine**. The workspace itself is isolated inside WSL2; AD is what lets the AI agent and tools reach *out* of it to do real work on your computer — drive **KiCad** and **Fusion 360**, read and capture your screen, stream files back and forth, control your browser, and run UI automation against native apps. The in‑workspace relay connects to AD as a bridge client, so a prompt like *"open this board in KiCad and run DRC"* actually reaches the real KiCad on your desktop and comes back with the result.++It's signed by the same publisher as HD (*Adom Industries, Inc.*). For the full feature list, release notes, and the public download, see the **[Adom Desktop page on the wiki](https://wiki.adom.inc/adom/adom-desktop)**.++---++## A real Linux workspace, local to your PC++The heart of HD is a genuine Linux environment running **on your own machine** through **WSL2** — not a remote VM, not a cloud container you rent. HD provisions a dedicated, isolated Ubuntu 24.04 distro (`Adom‑Workspace`) from a pre‑baked golden image, and everything Linux‑side lives inside that container: VS Code (code‑server), Claude Code, `adom‑cli`, the design tools, and the skills. Because it's WSL2, it boots in seconds, uses your CPU and memory natively, and stays cleanly separated from the rest of your system — including your other WSL distros and Docker Desktop, which HD never touches. Your **repositories stay on the Windows side**, never trapped inside the distro, so they survive resets and reinstalls untouched. Your Adom account is identity only; the work runs locally, and nothing about it has to leave your machine.++---++## Plugged into the Adom wiki — the whole community's apps, skills & components++HD comes wired into the **[Adom wiki](https://wiki.adom.inc)**, the shared registry where the whole Adom community publishes **apps, skills, and components**. From inside the workspace, you — and the AI — can **discover and install** any of them in one step with `adompkg`: a parts‑search app, a KiCad‑bridge skill, a ready‑made connector or symbol/footprint component. Each is a signed, versioned package with its own page, screenshots, and docs, so you always know exactly what you're pulling in. The workspace even **keeps itself current**, re‑pulling newer skills and tools on its own.++This is what makes HD more than a local IDE — it's a **place to collaborate**. When someone cracks a hard part of electronics design (a vendor integration, a footprint generator, a board‑bring‑up skill), they publish it to the wiki and everyone's workspace can pull it the next day. The whole point is to make electronics prototyping **stronger, better, and faster** — for everyone, together.++---++## AI that designs alongside you++Claude Code is built into both the editor and the terminal and signed in with your own subscription, so the AI isn't a sidebar — it's a teammate that can read your project, search the wiki, install the right skill, and (through Adom Desktop) drive your real EDA tools. On first run it already opens conversations that map your design stack and offer to wire your KiCad work to **live InstaPCB pricing** that re‑quotes as your board changes. Everything stays **opt‑in**: the AI proposes, you decide what actually runs.++---+ ## What's new in v15 Hydrogen Desktop's golden workspace image is **v15**, and it's built a fundamentally cleaner way:@@ -83,9 +113,3 @@ Uninstall Hydrogen Desktop like any Windows app — **Settings → Apps → Inst - **Setup paused at "Claude Authentication."** That's the one human step — approve the sign‑in in the browser window HD opened, and it continues automatically. - **"Ensure workspace runtime" won't complete.** Make sure WSL2 is healthy (`wsl --version`, `wsl -l -v`). A stale or corrupt `Adom‑Workspace` distro can be reset with `wsl --unregister Adom-Workspace` — HD re‑imports a fresh v15 image on the next launch. - **Something feels out of date.** The workspace self‑updates, but you can force it from the workspace terminal: `ADOMPKG_ALLOW_SUDO=1 adompkg install adom/hd-windows-bootstrap`.---## Under the hood--HD runs the `Adom‑Workspace` WSL2 distro **locally** on your machine — your Adom login is identity only. The relay server lives inside the workspace; HD connects to it as a bridge client. Bridges to KiCad, Fusion 360, and your browser are launched on demand. It's the full Adom Desktop feature set merged into one signed executable.