Adom Hydrogen (Linux)
Public Made by Adomby adom
The Linux platform layer for Adom Hydrogen: Ubuntu, Debian and Fedora, the workspace and the computer.
d8a45ab
name: hydrogen-adom-menu description: >- The Adom logo menu in Hydrogen's upper-left corner on Linux (Manage AIs, Settings, Ports, API Explorer, Doctor, Developer Tools, workspace start/stop, 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.
The Adom menu (upper-left logo dropdown)
Click the teal Adom logo in the top-left corner to open it. (Double-click the
logo = go straight to the Dashboard.) Source: EditorNav.svelte → .logo-button
→ .logo-dropdown-container .dropdown-link items.
This is the upper-LEFT menu. The upper-RIGHT avatar dropdown (profile, repositories, logout) is a different menu — see hydrogen-profile-menu.
Items (top to bottom)
| Item | What it does |
|---|---|
| Manage AIs | sign in to Claude Code, Codex or another AI, switch accounts, sign out |
| Settings | the Settings window (see hydrogen-settings) |
| Ports... | every port Hydrogen has bound on this computer and in the workspace, plus PortConfig |
| API Explorer... | browse and test every control-API endpoint (see hydrogen-api) |
| Doctor... | checks workspace, code-server, ports, relay, Adom Bridge and Claude, with fixes (see hydrogen-doctor) |
| Back to project folder | only when the editor is open outside your project folder |
| Report a problem... | files an issue on the Hydrogen wiki page as you, with the log tail and the Doctor's checks |
| About Hydrogen | version and build info |
| Desktop | |
| Zoom | minus / percent (reset) / plus for the whole UI (Ctrl -, Ctrl 0, Ctrl +) |
| Fullscreen | toggle (also F11) |
| Console | show or hide the console window, a live tail of ~/.config/hydrogen-desktop/hydrogen-desktop.log |
| Developer Tools | opens the WebKit Web Inspector (also Ctrl+Shift+I) |
| Container (state shown) | Start Container, or Restart Container and Stop Container (see hydrogen-workspace-lifecycle) |
| Admin | Setup Steps (show or hide the setup panel), Virgin Reset (see hydrogen-setup), Browser Picker Manager (saved browser choices per domain) |
On Linux Adom Bridge shows ab's window, the same as Open Adom Bridge in the tray menu (it does nothing until Hydrogen has installed ab). The menu has no Run Recovery Check (there is no wake watcher) and no Reclaim disk space (the workspace's files sit directly on this computer's disk, so there is nothing to compact).
Removed items (do not list): "Bridge Manager" (was a no-op with no backing panel) and "Port Mappings…" (no such action exists in the code).
Drive it programmatically with hydrogen-eval (target:"shell"): click
.logo-button, then click the .dropdown-link whose text matches the item.
You can also use the UI actions (GET /ui/actions, POST /ui/invoke {"id":...}): for example
settings.open, ports.open, devtools.open, container.restart, report-problem.open.
Developer Tools
open_devtools (or POST /devtools) opens the WebKit Web Inspector for Hydrogen's main
window. It is compiled into release builds too. It is its own window, so a Hydrogen
screenshot does not show it. Pair with hydrogen-eval to inspect or inject into any panel.
Version readout — title bar + About dialog
Title bar (always visible) shows, in order:
Hydrogen v<version> · <dev|release> · <sha>-dirty · <build time>, plus · AB <version>
once Adom Bridge is reachable. A Linux build never says signed or unsigned.
About dialog: open it from this menu (About Hydrogen, get_about_info). It shows
Hydrogen's version, dev or release, commit (and dirty), build time, signed, and install
path, plus an Adom Bridge section (reachable, version, endpoint) that reports not reachable
until Adom Bridge runs on this computer (Hydrogen installs it when a Linux build is published
for the user's account).
Related
- hydrogen-profile-menu — the upper-RIGHT avatar dropdown (don't confuse the two)
- hydrogen-settings — the settings tree behind the Settings item
- hydrogen-api — the control-API surface behind API Explorer…
- hydrogen-setup / hydrogen-setup-steps — what Setup Steps / Virgin Reset do
- hydrogen-eval — drive these menu items / inject UI from the workspace
---
name: hydrogen-adom-menu
description: >-
The Adom logo menu in Hydrogen's upper-left corner on Linux (Manage AIs, Settings,
Ports, API Explorer, Doctor, Developer Tools, workspace start/stop, 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.
---
# The Adom menu (upper-left logo dropdown)
Click the **teal Adom logo** in the top-left corner to open it. (Double-click the
logo = go straight to the Dashboard.) Source: `EditorNav.svelte` → `.logo-button`
→ `.logo-dropdown-container .dropdown-link` items.
> This is the **upper-LEFT** menu. The **upper-RIGHT** avatar dropdown (profile,
> repositories, logout) is a different menu — see **hydrogen-profile-menu**.
## Items (top to bottom)
| Item | What it does |
|---|---|
| **Manage AIs** | sign in to Claude Code, Codex or another AI, switch accounts, sign out |
| **Settings** | the Settings window (see **hydrogen-settings**) |
| **Ports...** | every port Hydrogen has bound on this computer and in the workspace, plus PortConfig |
| **API Explorer...** | browse and test every control-API endpoint (see **hydrogen-api**) |
| **Doctor...** | checks workspace, code-server, ports, relay, Adom Bridge and Claude, with fixes (see **hydrogen-doctor**) |
| **Back to project folder** | only when the editor is open outside your project folder |
| **Report a problem...** | files an issue on the Hydrogen wiki page as you, with the log tail and the Doctor's checks |
| **About Hydrogen** | version and build info |
| *Desktop* | |
| **Zoom** | minus / percent (reset) / plus for the whole UI (Ctrl -, Ctrl 0, Ctrl +) |
| **Fullscreen** | toggle (also F11) |
| **Console** | show or hide the console window, a live tail of `~/.config/hydrogen-desktop/hydrogen-desktop.log` |
| **Developer Tools** | opens the WebKit Web Inspector (also Ctrl+Shift+I) |
| *Container* (state shown) | **Start Container**, or **Restart Container** and **Stop Container** (see **hydrogen-workspace-lifecycle**) |
| *Admin* | **Setup Steps** (show or hide the setup panel), **Virgin Reset** (see **hydrogen-setup**), **Browser Picker Manager** (saved browser choices per domain) |
On Linux **Adom Bridge** shows ab's window, the same as Open Adom Bridge in the tray menu (it
does nothing until Hydrogen has installed ab). The menu has no Run Recovery Check (there is no wake watcher) and no Reclaim disk space (the workspace's
files sit directly on this computer's disk, so there is nothing to compact).
> **Removed items (do not list):** "Bridge Manager" (was a no-op with no backing
> panel) and "Port Mappings…" (no such action exists in the code).
Drive it programmatically with **hydrogen-eval** (`target:"shell"`): click
`.logo-button`, then click the `.dropdown-link` whose text matches the item.
You can also use the UI actions (`GET /ui/actions`, `POST /ui/invoke {"id":...}`): for example
`settings.open`, `ports.open`, `devtools.open`, `container.restart`, `report-problem.open`.
## Developer Tools
`open_devtools` (or `POST /devtools`) opens the WebKit Web Inspector for Hydrogen's main
window. It is compiled into release builds too. It is its own window, so a Hydrogen
screenshot does not show it. Pair with **hydrogen-eval** to inspect or inject into any panel.
## Version readout — title bar + About dialog
**Title bar** (always visible) shows, in order:
`Hydrogen v<version> · <dev|release> · <sha>-dirty · <build time>`, plus ` · AB <version>`
once Adom Bridge is reachable. A Linux build never says signed or unsigned.
**About dialog**: open it from this menu (**About Hydrogen**, `get_about_info`). It shows
Hydrogen's version, dev or release, commit (and dirty), build time, signed, and install
path, plus an Adom Bridge section (reachable, version, endpoint) that reports not reachable
until Adom Bridge runs on this computer (Hydrogen installs it when a Linux build is published
for the user's account).
## Related
- **hydrogen-profile-menu** — the upper-RIGHT avatar dropdown (don't confuse the two)
- **hydrogen-settings** — the settings tree behind the **Settings** item
- **hydrogen-api** — the control-API surface behind **API Explorer…**
- **hydrogen-setup** / **hydrogen-setup-steps** — what Setup Steps / Virgin Reset do
- **hydrogen-eval** — drive these menu items / inject UI from the workspace