main
John Lauer Publish 0.1.0 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 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