Adom Hydrogen (platform base)

Adom sign-in inside Hydrogen: the login/logout auth intent flow, where the session token lives, and how the session feeds setup. Use when Adom login fails, the session token expired, the user wants to sign in or out of Adom, or clear the Adom session.

What Hydrogen (ah) and Adom Bridge (ab) are and how they work together: ab is your hands on the user's real computer (files, shell, OS screenshots, apps, KiCad/Fusion). Use when asked what can you do on my computer, run a command on my PC, screenshot my screen, or send a file to my desktop.

The Adom logo menu in Hydrogen's upper-left corner (Settings, Ports, API Explorer, DevTools, Setup Steps, Virgin Reset) and the About dialog. Use when asked what's in the Adom menu, where settings or devtools are, or what version am I running.

Maintainer design notes for Hydrogen's AI agent support: golden-image vs user installs, auth oracles, how sign-in is driven, the VS Code toolbar and the Manage AIs dialog. Use before touching agent_harness.rs, PanelAiAccounts.svelte or ai-titlebar.js.

Install, sign in, sign out and check quota for the AIs in a Hydrogen workspace (Claude Code, Codex, Kimi Code, Antigravity) through the /agents API. Use when asked to install antigravity or kimi, sign in to codex, which AIs are signed in, how much usage is left, or why an AI button is missing.

Reference for Hydrogen's control API: drive the workspace, Claude Code, VS Code, workspace tabs and setup steps over HTTP; GET /_manifest is the live catalog. Use when calling a Hydrogen endpoint, finding the control port, using the API Explorer, or checking which endpoints are destructive.

Generate or change the user's Adom avatar and make Hydrogen show it immediately. Use when the user says generate a new avatar, change my avatar, make me a profile picture, set my avatar to this image, or reset my avatar.

Hydrogen's screen-share and AI-consent flow for screenshotting the editor or the whole screen: the Screen Capture dropdown, the AI-wants-access approval and its countdown. Use before screenshotting Hydrogen's own UI, or when asked to share this tab, share my screen or stop sharing.

How Claude Code signs in inside Hydrogen: the OAuth flow, where credentials live, the backup that survives a workspace rebuild, and the auth cascade. Use when Claude is not authenticated, the Claude token expired, or Claude needs to re-auth after a virgin reset.

API for the Claude Code conversations inside Hydrogen: list, open, close and switch tabs, read a conversation's state, type into a specific one, and Remote Control for a claude.ai URL. Use when asked to open a new Claude tab, type into a conversation, list conversations, or view this chat on mobile.

Why Hydrogen shows Claude Code's Bypass permissions mode in the Modes menu while Auto stays the default, and when to use it. Use when the user wants to turn off permissions, a safety check keeps blocking actions, or before changing a permission default in settings.json.

The Hydrogen dock bar (the app launcher rail on the right edge) and how any wiki app becomes a card in it through a dockbar.json manifest. Use when asked to add my app to the dock, why my dock card does not work, set launch steps or an AI thread on launch, or customize my dock.

The Hydrogen Doctor: a one-click health scan of the whole stack (workspace, code-server, Claude, Adom auth, ports, relay, Adom Bridge) with a safe fix, also at GET/POST /doctor. Use when something is broken and nobody knows what, things are weird after a laptop sleep, or to run the doctor.

Post-setup playbook for discovering which EDA tools the user runs (KiCad, Fusion 360, Altium, OrCAD) and onboarding them into the AI-first electronics workflow. Use when asked to explore what EDA software I use, detect KiCad or Fusion, or on the post-setup discovery pass.

Inject JavaScript into any surface of the Hydrogen window (app shell, VS Code workbench, wiki panel, Claude chat) through POST /eval-in. Use when asked to inject a UI add-on, add a demo arrow or overlay, highlight an element, or read the DOM of the Hydrogen window.

The user's cloud key-value store (Carbon KV): what the hydrogen.* and bridge.* keys mean, how to read and write them, and the ownership and no-secrets rules. Use before writing a key, or when asked about my cloud settings, kv pairs, hydrogen.runtime or the key-values viewer.

Watch the Hydrogen workspace in real time through its SSE event stream and the Monitor tool: tab changes, sharing state, workspace mutations. Use when asked to wait until the user opens something, react to a tab change, or watch for a new panel.

Adom product naming rules: OS-visible install surfaces say "Adom Hydrogen", never bare "Hydrogen"; plus the shorthand table (ah, ab, hc, nbe, hbw, pup) and the names no longer used. Use when naming an installer, shortcut, window title or wiki page, or when unsure what to call a product.

Index of the Hydrogen skills, 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's profile menu, the avatar dropdown in the top-right corner: links to your Adom profile, repositories and molecules, and logout behind a confirm dialog. Use when asked how to log out, where Your profile is, about the login page, or why am I locked out.

What "pup" means in Hydrogen and how to open one: a real, AI-drivable Chrome window from Adom Bridge's Puppeteer bridge, where localhost URLs work. Use when the user says show me in pup, open it in pup, pup window, or drive a browser.

How the Hydrogen app itself (not the workspace tooling) updates: the restart-to-update banner and the consent-based AI path through /updater. Use when asked is there a Hydrogen update, update Hydrogen, what version of Hydrogen am I on, or relaunch to update.

Hydrogen's Settings dialog and its preferences: theme, vim mode, launch on boot, console on startup, 3D control style, fonts, line numbers, the embedded Adom Bridge options. Use when asked how to turn on vim mode, change the theme, make Hydrogen launch on boot, or where the settings are.

Maintainer loop for fixing a wrong Hydrogen skill: verify against the running system, fix the live copy, fix the text at its source, publish. Use when a skill is wrong or stale, or to publish a skill fix.

How a Hydrogen workspace stays current: adom-wiki pkg update through the adom/hook prompt hook, the code-server reload banner, and how to ship a skill, CLI or app to every workspace. Use when asked how updates work, how to get the latest skills, or how to distribute a tool to all users.

How Hydrogen webview tab icons work: displayIcon is only a pre-load placeholder that the page's own favicon overrides, so serve the favicon you want. Use when a webview tab icon is not showing or reverts after page load, or for a custom mdi or SVG tab icon.

What "webview" means in Hydrogen: a native workspace tab opened with adom-cli hydrogen webview open-or-refresh, never VS Code's Simple Browser; plus the External Webview for sites that refuse embedding. Use when the user says show me in webview, open in webview, wv or extwv.

The Hydrogen welcome page shown after setup completes ("Your workspace is ready"): a page built into the app and served by the control API, not the adom.inc homepage. Use when asked about the welcome page or tab, or to show the welcome page again.

How to answer "who am I and what can I do here?", the first question Hydrogen's welcome step asks: which data to pull, Linux vs Adom username, and a template answer. Use when asked who am I, what can I do here, what is this environment, or what can Hydrogen do.

After editing any wiki.adom.inc page, load it in pup so the user can check the rendered result, and post a screenshot to the shotlog. Use after an adom-wiki push or publish, or when asked to show, review or verify a wiki page.