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