bootstrap

Adom Hydrogen (platform base)

Public Made by Adom

by adom

Layer Hydrogen's workspace onto a standard Adom workstation.

bootstraphydrogenworkspace
Overview Files Skills Discover Packages Releases Dependencies Issues Breadcrumbs Pull Requests1 Activity
Adom Hydrogen (platform base)

Bootstrap with one command

Latest: v0.5.83, published

Fresh container (no adom-wiki yet):

bash <(curl -fsSL https://wiki.adom.inc/static/bootstrap.sh) adom/hydrogen-bootstrap

Already have adom-wiki installed:

adom-wiki pkg install adom/hydrogen-bootstrap

What you'll get 2 apps, 3 skills, 1 bootstrap

skill adom/adom-ui-design ^3.0.0

How the AI builds and tests interfaces people love to use in Adom. Ships as one installable skill that bundles focused skills (tooltips, floating-windows, toasts, responsive-ui, app-shell, ai-driven-apps, clickable-paths).
app adom/adom-wiki-cli ^1.7.13

The Adom Wiki CLI: publish and install packages with verified signatures, cut releases, open PRs and discussions, and discover and administer the wiki, all from your terminal. Replaces adompkg.
app adom/codex ^0.1.22

Codex in Adom Hydrogen: ecosystem setup, dock dashboard and live engineering demos.
bootstrap adom/core ^4.9.0

Bootstrap a standard Adom workstation in one command.
skill adom/molecule-pipeline ^2.0.0

Top-level router for moving molecules between EDA tools, the wiki, and Hydrogen: one entry point that routes publish/import intents to the right skill chain and enforces the pipeline invariants. Molecule pages publish sources only; the wiki's 3D model registry builds the model, and the route waits for that build before import.
skill adom/molecule-publish ^3.0.0

Publish molecule sources to the Adom wiki (STEP, board, schematic, <slug>-fab.zip, export.json); the wiki's 3D model registry builds the GLB, footprint and symbol. Checks the bundle the way the registry does, publishes private, waits for the build, sets the hero from the built model, then makes the page public. Board mode still converts plain boards. Also writes APM render assets and component dependencies. Companion to adom-wiki model import.
Contents

README

markdown

adom/hydrogen-bootstrap

Hydrogen's platform-generic workspace layer, as a wiki bootstrap package. It's a thin package: a dependency list, the bundled hydrogen-* skills, and one config hook. Installing it converges a workspace to "ready to run inside Hydrogen."

adom-wiki pkg install adom/hydrogen-bootstrap

The golden image runs exactly that line at bake time and ships the result pre-converged. A live workspace can run the same line on demand. The bake is an optimization of the runtime flow, not a different mechanism.

How it layers

adom/hydrogen-bootstrap depends on adom/core and adds only what's specific to running inside Hydrogen. Layering is not a special feature: a layer is just a bootstrap that depends on the one below it. core is pulled unmodified.

adom/core                        ← the Adom ecosystem (shared with Hydrogen Cloud)
  └─ adom/hydrogen-bootstrap     ← THIS: Hydrogen runtime skills + editor config

Platform layers depend on this one: adom/hydrogen-windows-bootstrap and adom/hydrogen-mac-bootstrap. This is also the public reference design: a vendor publishes <org>/bootstrap depending on adom/core (plus adom/hydrogen-bootstrap only if their capability needs Hydrogen's runtime), and their users get set up by telling their AI "I use ." See ../BOOTSTRAP-CONVENTION.md for the naming and layering convention.

What's a dependency vs. what's in the hook

The rule: anything that is a package is a dependency; environment config that isn't a package is the postinstall hook; the OS baseline is the golden image's Dockerfile (not this package at all).

Dependencies (all resolve anonymously, sudo-free)

Dep Why it's here
adom/core The whole Adom ecosystem: skills hub, distributor search, KiCad/Fusion, pup, adom-cli, the adom-vscode binary, the adom-wiki CLI.
adom/adom-bridge Adom Bridge: the adom-bridge-cli verb CLI and the relay that reaches the user's desktop.
adom/codex Codex inside Hydrogen: the adom-codex CLI, the Codex skills and AGENTS.md entry point, the dock entry, and the runtime that gives Codex a durable app-server so a turn survives an editor reload. Added 2026-09-10 (John: "make sure all users get the adom/codex pkg tarball installed now") after arav-rog was found carrying the openai.chatgpt EXTENSION but none of this, so Codex worked as vanilla and none of the Adom integration existed. The extension itself is not installed here; it arrives with the image, and adom/codex patches whichever version it finds.

The hydrogen-* skills are bundled into this package (the skills/ dir), not a dependency; they're Hydrogen-specific with no independent lifecycle. Ecosystem CLIs (adom-google, adom-tts, adom-gchat) are inherited via adom/core.

postinstall.sh (deploy bundled skills + environment config)

Runs as the workspace user after all deps install (sudo only for the system-owned workbench file). Mirrors the config sections of the golden-image bake script (bake-hydrogen-setup.sh in the image repo):

  1. Deploy the bundled hydrogen-* skills (skills/ dir → ~/.claude/skills/)
  2. Claude Code CLI (claude.ai installer → ~/.local/bin/claude)
  3. Claude Code extension (Open VSX) registered in code-server
  4. adom-vscode extension .vsix registered in code-server (binary from the core dep)
  5. code-server settings.json (dark theme, Claude Code perms, chat/agent panel off, silent ports, no model pin)
  6. code-server config.yaml (telemetry + update-check off)
  7. workbench.html IndexedDB seed (trusted domains * + activity-bar unpin)
  8. tidy (rm ~/project/.mcp.json)

NOT in this package (golden-image Dockerfile)

apt baseline, code-server, systemd/systemd-sysv, cron, the gh CLI, user/group/linger/pam fixes. The "hardware" the bootstrap runs on. A live install assumes a workspace that already has it.

NOT in this package (per-machine, injected by Hydrogen at import)

The Carbon API key, DefaultUid=1001, the host.docker.internal alias.

Notes

  • The bundled set is the platform-generic hydrogen-* skills; the Windows-specific ones live in adom/hydrogen-windows-bootstrap, the mac ones in adom/hydrogen-mac-bootstrap. Mixed skills were split: generic core here, a platform companion in the platform layer.

Status (2026-08-08)

PUBLISHED + PUBLIC on wiki.adom.inc as part of the 2026-08 naming cutover (formerly adom/hd-bootstrap). Deps resolve anonymously and the whole tree is sudo-free (needs_sudo: false; the retired updater daemon was the only sudo dependency). Build the golden image on the laptop via Adom Bridge or in CI, never in the cloud container.