bootstrap
Adom Hydrogen (Linux)
Public Made by Adomby adom
The Linux platform layer for Adom Hydrogen: Ubuntu, Debian and Fedora, the workspace and the computer.
main
John Lauer
Publish 0.1.0
d8a45ab
name: hydrogen-overview description: >- Index of the Hydrogen skills on Linux, one line each. Use when asked what Hydrogen can do, which skill covers a Hydrogen feature, for Hydrogen help, or when a task is about the Hydrogen app itself.
Hydrogen: Skill Index (Linux)
Hydrogen (ah) is Adom's Tauri v2 desktop app (WebKitGTK on Linux, binary adom-hydrogen,
packaged as .deb, .rpm and AppImage). It runs your workspace, VS Code, Claude Code and the
other AIs, and the Adom Wiki on this computer. Here the workspace is Adom-Workspace, a
systemd-nspawn machine on the host kernel (no VM) that shares the host's network.
Where these skills come from on Linux
- adom/hydrogen-bootstrap (a wiki package) ships the platform-generic skills.
- Hydrogen itself ships the Linux layer: the Hydrogen build embeds the Linux set (repo
skills/public-facing/shared/, Linux render) and writes it into~/.claude/skills/at every launch and after every package convergence. A Linux skill is written over the package's copy of the same name, and platform-only skills with no Linux meaning are removed. So the skills below are the Linux versions even where the name matches a package skill. There are no per-platform companion skills on Linux.
The Hydrogen skills on Linux
| Skill | What it covers |
|---|---|
| hydrogen-adom-auth | Adom login/logout, session token, auth proxy, credential replay, how auth feeds setup. |
| hydrogen-adom-bridge | What Hydrogen and Adom Bridge (ab) are and how they work together; on Linux Hydrogen installs and runs ab when a Linux build is published for the account, and the mesh reaches the user's other machines. |
| hydrogen-adom-bridge-triage | Triage ab when the workspace cannot reach it: is ab running on this desktop, its log, the /ab/* probes, other machines with --target. |
| hydrogen-adom-menu | The upper-left Adom logo menu (Settings, Ports, API Explorer, Developer Tools (WebKit Web Inspector), Setup/Virgin Reset), About dialog, version readout. |
| hydrogen-ai-agents | Install, sign in/out and check quota for the AIs in the workspace (Claude Code, Codex, Kimi Code, Antigravity) via the /agents API. |
| hydrogen-ai-threads | The AI Threads panel: the live tree of open AI conversations, reorder, rename, tag, TUI threads. |
| hydrogen-ai-threads-api | Open and drive AI conversations from code over the control API: open, list, stage or send a prompt, reopen, close. |
| hydrogen-annotate | Draw on a frozen picture of the screen (Title Bar pencil, tray, Super+Alt+A) and put a PNG on the clipboard. |
| hydrogen-api | The control API reference: endpoints, the control port, GET /_manifest, the API Explorer, which calls are destructive. |
| hydrogen-avatar | Generate or change the user's Adom avatar and make Hydrogen show it immediately. |
| hydrogen-bridges | The KiCad, Fusion 360 and Puppeteer bridges, served by Adom Bridge on a desktop, and how to tell which machine has them. |
| hydrogen-browser-picker | How URLs opened in Hydrogen are caught and routed (native browser profile, Hydrogen tab or window, Pup), the countdown. |
| hydrogen-capture-share | The screen-share "AI wants access" approval and countdown the AI triggers to capture the editor; tab/screen scopes. |
| hydrogen-captions | Paint caption text on the Hydrogen workspace with adom-cli hydrogen caption for demos. |
| hydrogen-claude-auth | How Claude Code signs in: the OAuth flow, credential backup, the claude-auth step. |
| hydrogen-claude-management | List/open/close/switch Claude conversation tabs, read conversation state, type/submit into a specific conversation, Remote Control. |
| hydrogen-claude-permission-modes | Why "Bypass permissions" is visible in the Modes menu, and when to reach for it. |
| hydrogen-container | Facts about the workspace: the Adom-Workspace systemd-nspawn machine, Ubuntu 24.04, code-server, the golden image. |
| hydrogen-container-stats | The title-bar CPU and RAM indicator, its tooltip, the cgroup numbers. |
| hydrogen-demo-recording | Recipe for a demo video: a typed prompt into a Claude tab, the desktop's own screen recorder, the file into the workspace. |
| hydrogen-desktop-sse | Hydrogen's local workspace API and SSE stream, so the workspace's adom-cli controls Hydrogen, not the cloud. |
| hydrogen-dock | The dock bar (app launcher rail) and how any wiki app becomes a card in it — dockbar.json manifest, launch steps, AI threads. |
| hydrogen-doctor | The one-click full-stack health scan (Doctor) with safe one-click fix; GET/POST /doctor. |
| hydrogen-eda-discovery | EDA tool discovery / setup flow. |
| hydrogen-editor-state | The true state of the VS Code editor and its Claude conversations, and the rules before typing into one. |
| hydrogen-embedded-bridge | How Hydrogen installs, starts and supervises ab on Linux: embedded mode, relay and session handover, updates, quit behaviour. |
| hydrogen-eval | Inject JS into any Hydrogen surface (shell/workbench/wiki/Claude) via /eval-in — add-ons, overlays, highlights, drive UI. |
| hydrogen-file-transfer | Move files between the workspace and this computer: /mnt/host, /files/inject, machinectl copy-to/copy-from. |
| hydrogen-golden-image | What the pre-baked workspace image contains, how package updates keep it current, the tarball pin. |
| hydrogen-key-values | The user's cloud key-value store (Carbon KV): hydrogen.* / bridge.* keys, read/write, conventions. |
| hydrogen-lightbulb | The title-bar lightbulb menu of sample prompts and sample-prompts.json. |
| hydrogen-monitor | Real-time SSE event stream + Monitor-tool patterns for watching workspace mutations. |
| hydrogen-naming | The naming doctrine: Hydrogen/ah, Bridge/ab, and WHY installers/shortcuts MUST say "Adom Hydrogen". |
| hydrogen-networking | Port architecture on Linux: one shared localhost with the host, the control URL, the code-server proxy, LAN protection. |
| hydrogen-notifications | Desktop notifications through adom-cli notify, the title-bar bell, toasts. |
| hydrogen-open-url | Decision guide for opening a URL: webview tab, Hydrogen browser window, native browser profile, Pup, headless fetch. |
| hydrogen-overview | This index. |
| hydrogen-permissions | Hydrogen auto-grants every webview permission; the AI's screen-share consent and ab's approvals are separate layers. |
| hydrogen-port-watcher | Why no port forwarding is needed on Linux: every workspace port is already on the host's localhost. |
| hydrogen-ports | How ports reach the host: shared localhost, the /proxy// fallback, the Ports window, ports.json. |
| hydrogen-profile-menu | The avatar dropdown: profile/repos/molecules links and logout. |
| hydrogen-project-workspaces | The Project workspaces menu and API: apply or unload a project's bench layout (hydrogen/workspace.json). |
| hydrogen-pup | What "pup" means and exactly how to open an AI-drivable Chrome window via the Puppeteer bridge. |
| hydrogen-recording | Recording on Linux: no native recorder; the desktop's own recorder, audio-only via adom-cli, pup on another machine. |
| hydrogen-runtime-mode | Which runtime hosts the workspace: always the systemd-nspawn machine on Linux, and how to tell. |
| hydrogen-screen-lock | Why Hydrogen's screenshots never keep the display awake, and what to check when something does. |
| hydrogen-self-screenshot | Screenshot Hydrogen from the workspace: a panel or the whole window, or one element by CSS selector. |
| hydrogen-self-update | How Hydrogen updates itself on Linux (.deb, .rpm, AppImage). |
| hydrogen-settings | Hydrogen's Settings dialog + the preferences tree. |
| hydrogen-setup | The setup panel: the step cascade, Run All, Rollback All, Virgin Reset and its toggles. |
| hydrogen-setup-steps | What each setup step did to build and prepare the Linux workspace. |
| hydrogen-staying-current | How workspace tooling stays current (adom-wiki pkg update, the adom/hook prompt hook, reload banner) and how to ship a skill/CLI/app. |
| hydrogen-tab-icons | Webview tab icon system — displayIcon placeholder vs. the page's own favicon, SVG data URLs. |
| hydrogen-topology | Where Claude runs relative to Hydrogen (local workspace or cloud container) and how to reach the host and workspace. |
| hydrogen-ui | Hydrogen's menus, dialogs, panels and tray menu, and driving them via the UI command bus. |
| hydrogen-volume | Where the workspace's files live, what survives a restart or virgin reset, reaching them from the desktop. |
| hydrogen-wake-repair | What Hydrogen does when the editor loses its connection: the Cannot reconnect watcher and the backend banner. |
| hydrogen-webview | What "webview" means and how to open one via adom-cli hydrogen webview open-or-refresh; the External Webview. |
| hydrogen-welcome | The welcome page shown after setup completes. |
| hydrogen-who-am-i | Answer "who am I / what can I do here" — identity, resources, environment intro. |
| hydrogen-widget | Build, list, open and drive Hydrogen Widgets in the Title Bar: the hydrogen-widget.json facet and /widgets API. |
| hydrogen-wiki-review | After editing any wiki page, load it in pup so the user can review the rendered result. |
| hydrogen-workspace-lifecycle | Import, start, stop, restart and remove the Adom-Workspace machine; the root helper; code-server as a unit. |
| hydrogen-workspace-monitoring | How Hydrogen watches the workspace machine and code-server: polls, the stopped floaty, auto-start, auto-reload. |
Maintainer-only (hidden from the skill listing; Read the file when you need it):
| Skill | What it covers |
|---|---|
~/.claude/skills/hydrogen-ai-agents-dev/SKILL.md |
Design of Hydrogen's AI agent support: auth oracles, the no-duplicate-CLI rule, the toolbar and Manage AIs dialog. |
~/.claude/skills/hydrogen-skill-loop/SKILL.md |
Fixing a wrong Hydrogen skill: verify against the live system, fix it at its text source, publish. |
To list what is installed, with each description:
ls ~/.claude/skills | grep '^hydrogen-'
grep -h -A3 '^description' ~/.claude/skills/hydrogen-*/SKILL.md
---
name: hydrogen-overview
description: >-
Index of the Hydrogen skills on Linux, one line each. Use when asked what Hydrogen can do,
which skill covers a Hydrogen feature, for Hydrogen help, or when a task is about the
Hydrogen app itself.
---
# Hydrogen: Skill Index (Linux)
Hydrogen (ah) is Adom's Tauri v2 desktop app (WebKitGTK on Linux, binary `adom-hydrogen`,
packaged as .deb, .rpm and AppImage). It runs your workspace, VS Code, Claude Code and the
other AIs, and the Adom Wiki on this computer. Here the workspace is **`Adom-Workspace`, a
systemd-nspawn machine** on the host kernel (no VM) that shares the host's network.
## Where these skills come from on Linux
- **adom/hydrogen-bootstrap** (a wiki package) ships the platform-generic skills.
- **Hydrogen itself** ships the Linux layer: the Hydrogen build embeds the Linux set (repo
`skills/public-facing/shared/`, Linux render) and writes it into `~/.claude/skills/` at every launch and
after every package convergence. A Linux skill is written over the package's copy of the same
name, and platform-only skills with no Linux meaning are removed. So the skills below are the
Linux versions even where the name matches a package skill. There are no per-platform
companion skills on Linux.
## The Hydrogen skills on Linux
| Skill | What it covers |
|---|---|
| **hydrogen-adom-auth** | Adom login/logout, session token, auth proxy, credential replay, how auth feeds setup. |
| **hydrogen-adom-bridge** | What Hydrogen and Adom Bridge (ab) are and how they work together; on Linux Hydrogen installs and runs ab when a Linux build is published for the account, and the mesh reaches the user's other machines. |
| **hydrogen-adom-bridge-triage** | Triage ab when the workspace cannot reach it: is ab running on this desktop, its log, the /ab/* probes, other machines with `--target`. |
| **hydrogen-adom-menu** | The upper-left Adom logo menu (Settings, Ports, API Explorer, Developer Tools (WebKit Web Inspector), Setup/Virgin Reset), About dialog, version readout. |
| **hydrogen-ai-agents** | Install, sign in/out and check quota for the AIs in the workspace (Claude Code, Codex, Kimi Code, Antigravity) via the `/agents` API. |
| **hydrogen-ai-threads** | The AI Threads panel: the live tree of open AI conversations, reorder, rename, tag, TUI threads. |
| **hydrogen-ai-threads-api** | Open and drive AI conversations from code over the control API: open, list, stage or send a prompt, reopen, close. |
| **hydrogen-annotate** | Draw on a frozen picture of the screen (Title Bar pencil, tray, Super+Alt+A) and put a PNG on the clipboard. |
| **hydrogen-api** | The control API reference: endpoints, the control port, `GET /_manifest`, the API Explorer, which calls are destructive. |
| **hydrogen-avatar** | Generate or change the user's Adom avatar and make Hydrogen show it immediately. |
| **hydrogen-bridges** | The KiCad, Fusion 360 and Puppeteer bridges, served by Adom Bridge on a desktop, and how to tell which machine has them. |
| **hydrogen-browser-picker** | How URLs opened in Hydrogen are caught and routed (native browser profile, Hydrogen tab or window, Pup), the countdown. |
| **hydrogen-capture-share** | The screen-share "AI wants access" approval and countdown the AI triggers to capture the editor; tab/screen scopes. |
| **hydrogen-captions** | Paint caption text on the Hydrogen workspace with `adom-cli hydrogen caption` for demos. |
| **hydrogen-claude-auth** | How Claude Code signs in: the OAuth flow, credential backup, the `claude-auth` step. |
| **hydrogen-claude-management** | List/open/close/switch Claude conversation tabs, read conversation state, type/submit into a specific conversation, Remote Control. |
| **hydrogen-claude-permission-modes** | Why "Bypass permissions" is visible in the Modes menu, and when to reach for it. |
| **hydrogen-container** | Facts about the workspace: the Adom-Workspace systemd-nspawn machine, Ubuntu 24.04, code-server, the golden image. |
| **hydrogen-container-stats** | The title-bar CPU and RAM indicator, its tooltip, the cgroup numbers. |
| **hydrogen-demo-recording** | Recipe for a demo video: a typed prompt into a Claude tab, the desktop's own screen recorder, the file into the workspace. |
| **hydrogen-desktop-sse** | Hydrogen's local workspace API and SSE stream, so the workspace's adom-cli controls Hydrogen, not the cloud. |
| **hydrogen-dock** | The dock bar (app launcher rail) and how any wiki app becomes a card in it — dockbar.json manifest, launch steps, AI threads. |
| **hydrogen-doctor** | The one-click full-stack health scan (Doctor) with safe one-click fix; GET/POST /doctor. |
| **hydrogen-eda-discovery** | EDA tool discovery / setup flow. |
| **hydrogen-editor-state** | The true state of the VS Code editor and its Claude conversations, and the rules before typing into one. |
| **hydrogen-embedded-bridge** | How Hydrogen installs, starts and supervises ab on Linux: embedded mode, relay and session handover, updates, quit behaviour. |
| **hydrogen-eval** | Inject JS into any Hydrogen surface (shell/workbench/wiki/Claude) via /eval-in — add-ons, overlays, highlights, drive UI. |
| **hydrogen-file-transfer** | Move files between the workspace and this computer: /mnt/host, /files/inject, machinectl copy-to/copy-from. |
| **hydrogen-golden-image** | What the pre-baked workspace image contains, how package updates keep it current, the tarball pin. |
| **hydrogen-key-values** | The user's cloud key-value store (Carbon KV): hydrogen.* / bridge.* keys, read/write, conventions. |
| **hydrogen-lightbulb** | The title-bar lightbulb menu of sample prompts and sample-prompts.json. |
| **hydrogen-monitor** | Real-time SSE event stream + Monitor-tool patterns for watching workspace mutations. |
| **hydrogen-naming** | The naming doctrine: Hydrogen/ah, Bridge/ab, and WHY installers/shortcuts MUST say "Adom Hydrogen". |
| **hydrogen-networking** | Port architecture on Linux: one shared localhost with the host, the control URL, the code-server proxy, LAN protection. |
| **hydrogen-notifications** | Desktop notifications through `adom-cli notify`, the title-bar bell, toasts. |
| **hydrogen-open-url** | Decision guide for opening a URL: webview tab, Hydrogen browser window, native browser profile, Pup, headless fetch. |
| **hydrogen-overview** | This index. |
| **hydrogen-permissions** | Hydrogen auto-grants every webview permission; the AI's screen-share consent and ab's approvals are separate layers. |
| **hydrogen-port-watcher** | Why no port forwarding is needed on Linux: every workspace port is already on the host's localhost. |
| **hydrogen-ports** | How ports reach the host: shared localhost, the /proxy/<port>/ fallback, the Ports window, ports.json. |
| **hydrogen-profile-menu** | The avatar dropdown: profile/repos/molecules links and logout. |
| **hydrogen-project-workspaces** | The Project workspaces menu and API: apply or unload a project's bench layout (hydrogen/workspace.json). |
| **hydrogen-pup** | What "pup" means and exactly how to open an AI-drivable Chrome window via the Puppeteer bridge. |
| **hydrogen-recording** | Recording on Linux: no native recorder; the desktop's own recorder, audio-only via adom-cli, pup on another machine. |
| **hydrogen-runtime-mode** | Which runtime hosts the workspace: always the systemd-nspawn machine on Linux, and how to tell. |
| **hydrogen-screen-lock** | Why Hydrogen's screenshots never keep the display awake, and what to check when something does. |
| **hydrogen-self-screenshot** | Screenshot Hydrogen from the workspace: a panel or the whole window, or one element by CSS selector. |
| **hydrogen-self-update** | How Hydrogen updates itself on Linux (.deb, .rpm, AppImage). |
| **hydrogen-settings** | Hydrogen's Settings dialog + the preferences tree. |
| **hydrogen-setup** | The setup panel: the step cascade, Run All, Rollback All, Virgin Reset and its toggles. |
| **hydrogen-setup-steps** | What each setup step did to build and prepare the Linux workspace. |
| **hydrogen-staying-current** | How workspace tooling stays current (`adom-wiki pkg update`, the adom/hook prompt hook, reload banner) and how to ship a skill/CLI/app. |
| **hydrogen-tab-icons** | Webview tab icon system — `displayIcon` placeholder vs. the page's own favicon, SVG data URLs. |
| **hydrogen-topology** | Where Claude runs relative to Hydrogen (local workspace or cloud container) and how to reach the host and workspace. |
| **hydrogen-ui** | Hydrogen's menus, dialogs, panels and tray menu, and driving them via the UI command bus. |
| **hydrogen-volume** | Where the workspace's files live, what survives a restart or virgin reset, reaching them from the desktop. |
| **hydrogen-wake-repair** | What Hydrogen does when the editor loses its connection: the Cannot reconnect watcher and the backend banner. |
| **hydrogen-webview** | What "webview" means and how to open one via `adom-cli hydrogen webview open-or-refresh`; the External Webview. |
| **hydrogen-welcome** | The welcome page shown after setup completes. |
| **hydrogen-who-am-i** | Answer "who am I / what can I do here" — identity, resources, environment intro. |
| **hydrogen-widget** | Build, list, open and drive Hydrogen Widgets in the Title Bar: the hydrogen-widget.json facet and /widgets API. |
| **hydrogen-wiki-review** | After editing any wiki page, load it in pup so the user can review the rendered result. |
| **hydrogen-workspace-lifecycle** | Import, start, stop, restart and remove the Adom-Workspace machine; the root helper; code-server as a unit. |
| **hydrogen-workspace-monitoring** | How Hydrogen watches the workspace machine and code-server: polls, the stopped floaty, auto-start, auto-reload. |
Maintainer-only (hidden from the skill listing; Read the file when you need it):
| Skill | What it covers |
|---|---|
| `~/.claude/skills/hydrogen-ai-agents-dev/SKILL.md` | Design of Hydrogen's AI agent support: auth oracles, the no-duplicate-CLI rule, the toolbar and Manage AIs dialog. |
| `~/.claude/skills/hydrogen-skill-loop/SKILL.md` | Fixing a wrong Hydrogen skill: verify against the live system, fix it at its text source, publish. |
To list what is installed, with each description:
```bash
ls ~/.claude/skills | grep '^hydrogen-'
grep -h -A3 '^description' ~/.claude/skills/hydrogen-*/SKILL.md
```