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-naming description: >- Adom product naming rules: OS-visible install surfaces say "Adom Hydrogen", never bare "Hydrogen"; plus the shorthand table (ah, ab, hc, nbe, hbw, pup), the names no longer used, and the Linux package and binary names. Use when naming an installer, launcher entry, window title or wiki page, or when unsure what to call a product.
Adom Product Naming
Canonical source: the adom/definitions wiki page. This skill is the operational summary so the rules survive in every workspace.
The table
| Product | Everyday name | Formal Name | ai shorthand |
|---|---|---|---|
| The desktop app | Hydrogen | Adom Hydrogen | ah (ah win, ah mac, ah ubuntu) |
| The desktop bridge/relay | Bridge | Adom Bridge | ab (ab win, ab mac, ab ubuntu) |
| The hosted web app | Hydrogen Cloud | Adom Hydrogen Cloud | hc |
| The wiki | the wiki | Adom Wiki | aw |
Say the everyday name in speech and UI copy. Reach for the Formal Name when the Adom association matters: executables, installers, app-store listings, marketing, and the first mention in a public doc.
THE INSTALLER RULE (John, 2026-08-09 - never forget this)
Every OS-visible install surface MUST carry the Formal Name "Adom Hydrogen" (and "Adom Bridge" for ab). On Linux that is:
- the application launcher entry (the app grid, Activities search, the desktop's menu)
- the package's product name and the published artifact filename
- the autostart entry (
~/.config/autostart/adom-hydrogen.desktop,Name=Adom Hydrogen)
Why: a new user opens their app search and types "adom", not "hydrogen", because they have not memorized the product name yet. They know they installed something from Adom. If the launcher entry says bare "Hydrogen", that search finds NOTHING and the product looks broken or gone. Adom must be in the installed name. That is the entire reason the Formal Name exists as a register.
Linux names (frozen, do not "fix")
| What | Name |
|---|---|
| Binary | adom-hydrogen (/usr/bin/adom-hydrogen). Not hydrogen: Debian and Ubuntu's hydrogen drum machine package owns /usr/bin/hydrogen. |
| Package (.deb / .rpm) | adom-hydrogen (dpkg -L adom-hydrogen, rpm -ql adom-hydrogen) |
| Root helper | /usr/libexec/adom-hydrogen/hydrogen-workspace (historical name; it manages the systemd-nspawn machine) |
| Sudoers drop-in | /etc/sudoers.d/adom-hydrogen (package) or /etc/sudoers.d/adom-hydrogen-user (AppImage first run) |
| State dir | ~/.config/hydrogen-desktop/ (log, ports.json, session, setup state) |
| Image cache | ~/.local/share/Adom/HydrogenDesktop/ |
Dead names - never write these
- hd / "Hydrogen Desktop" in any copy (chat, docs, UI, skills). Say
Hydrogen or ah. (Code identifiers like
hd_*verbs orhd-crate names are unrenamed call sites, not license to use the name in prose.) - ad / "Adom Desktop" - the product is Bridge (ab). The CLI is
adom-bridge; the native launcher isadom-bridge. - hw (now hc), hdbw (now hbw), abe (now nbe), bare single-letter shorthands (say ah, ab, aw - never h, b, w).
Shorthand rule
Every shorthand is at least two letters. A natural one-letter shorthand takes the Adom "a" prefix: ah, ab, aw. Anything already 2+ letters never does: hc, nb, nbe, hbw, pup.
Frozen internal identifiers (do NOT "fix" these)
These deliberately keep old spellings because they are load-bearing state or build identity, renaming them breaks installs:
- Bundle identifier
inc.adom.hydrogen-desktop - Cargo package
hydrogen-desktop - GitHub repo
adom-inc/hydrogen-desktop - Workspace name
Adom-Workspace - The Linux names in the table above, including the
hydrogen-desktopstate dir
---
name: hydrogen-naming
description: >-
Adom product naming rules: OS-visible install surfaces say "Adom Hydrogen", never bare
"Hydrogen"; plus the shorthand table (ah, ab, hc, nbe, hbw, pup), the names no longer
used, and the Linux package and binary names. Use when naming an installer, launcher
entry, window title or wiki page, or when unsure what to call a product.
---
# Adom Product Naming
Canonical source: the **adom/definitions** wiki page. This skill is the
operational summary so the rules survive in every workspace.
## The table
| Product | Everyday name | Formal Name | ai shorthand |
|---|---|---|---|
| The desktop app | **Hydrogen** | **Adom Hydrogen** | **ah** (ah win, ah mac, ah ubuntu) |
| The desktop bridge/relay | **Bridge** | **Adom Bridge** | **ab** (ab win, ab mac, ab ubuntu) |
| The hosted web app | **Hydrogen Cloud** | Adom Hydrogen Cloud | **hc** |
| The wiki | **the wiki** | Adom Wiki | **aw** |
Say the everyday name in speech and UI copy. Reach for the Formal Name when
the Adom association matters: executables, installers, app-store listings,
marketing, and the first mention in a public doc.
## THE INSTALLER RULE (John, 2026-08-09 - never forget this)
Every OS-visible install surface MUST carry the Formal Name **"Adom Hydrogen"** (and "Adom
Bridge" for ab). On Linux that is:
- the application launcher entry (the app grid, Activities search, the desktop's menu)
- the package's product name and the published artifact filename
- the autostart entry (`~/.config/autostart/adom-hydrogen.desktop`, `Name=Adom Hydrogen`)
**Why:** a new user opens their app search and types **"adom"**, not "hydrogen", because they
have not memorized the product name yet. They know they installed something from Adom. If the
launcher entry says bare "Hydrogen", that search finds NOTHING and the product looks broken or
gone.
Adom must be in the installed name. That is the entire reason the Formal Name
exists as a register.
## Linux names (frozen, do not "fix")
| What | Name |
|---|---|
| Binary | `adom-hydrogen` (`/usr/bin/adom-hydrogen`). Not `hydrogen`: Debian and Ubuntu's `hydrogen` drum machine package owns `/usr/bin/hydrogen`. |
| Package (.deb / .rpm) | `adom-hydrogen` (`dpkg -L adom-hydrogen`, `rpm -ql adom-hydrogen`) |
| Root helper | `/usr/libexec/adom-hydrogen/hydrogen-workspace` (historical name; it manages the systemd-nspawn machine) |
| Sudoers drop-in | `/etc/sudoers.d/adom-hydrogen` (package) or `/etc/sudoers.d/adom-hydrogen-user` (AppImage first run) |
| State dir | `~/.config/hydrogen-desktop/` (log, ports.json, session, setup state) |
| Image cache | `~/.local/share/Adom/HydrogenDesktop/` |
## Dead names - never write these
- **hd / "Hydrogen Desktop"** in any copy (chat, docs, UI, skills). Say
Hydrogen or ah. (Code identifiers like `hd_*` verbs or `hd-` crate names
are unrenamed call sites, not license to use the name in prose.)
- **ad / "Adom Desktop"** - the product is Bridge (ab). The CLI is
`adom-bridge`; the native launcher is `adom-bridge`.
- **hw** (now hc), **hdbw** (now hbw), **abe** (now nbe), bare single-letter
shorthands (say ah, ab, aw - never h, b, w).
## Shorthand rule
Every shorthand is at least two letters. A natural one-letter shorthand takes
the Adom "a" prefix: **ah**, **ab**, **aw**. Anything already 2+ letters
never does: **hc**, **nb**, **nbe**, **hbw**, **pup**.
## Frozen internal identifiers (do NOT "fix" these)
These deliberately keep old spellings because they are load-bearing state or
build identity, renaming them breaks installs:
- Bundle identifier `inc.adom.hydrogen-desktop`
- Cargo package `hydrogen-desktop`
- GitHub repo `adom-inc/hydrogen-desktop`
- Workspace name `Adom-Workspace`
- The Linux names in the table above, including the `hydrogen-desktop` state dir