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-settings description: >- Hydrogen's Settings window and its preferences on Linux: color scheme, fonts, font size, launch on boot, close button and tray, link handling, the Dock Bar, the Adom Bridge options, vim mode, 3D control style. Use when asked how to turn on vim mode, change the theme, make Hydrogen launch on boot, or where the settings are.
Hydrogen Settings: the preference tree
Open it from the Adom logo menu (upper-left) > Settings, or the tray menu's
Settings. The canonical tree of sections and keys lives in src/lib/stores/settings.ts
(settingsTree); on Linux forHost() hides the settings that do nothing here (listed below).
Preferences are saved per-user (saveUserSetting → PATCH /user/hydrogen/settings)
and persist across sessions. Setting a key back to its default removes the
override. Keys are dotted (section.subsection.name).
They live in the Adom account's cloud key-value store (see hydrogen-key-values), so they
follow the user to every machine.
Sections, keys, and what each does
general
| Key | Default | What it does |
|---|---|---|
general.developer_mode |
false |
Enables extra developer/debugging features in the app |
general.pane_focus_mode |
false |
Only the focused pane is active and highlighted; turn it on to get the highlight |
general.editor.workspace_folder |
project |
Folder VS Code opens: project = /home/adom/project, home = /home/adom |
general.appearance (subsection)
| Key | Default | What it does |
|---|---|---|
general.appearance.theme |
adom-dark |
App-wide theme. Options: adom-dark, adom-light, adom-dark-high-contrast, adom-light-high-contrast (→ "change the theme" / "light mode" / "high contrast") |
general.appearance.user_interface_style |
standard |
UI compactness: standard or compact (→ "make the UI more compact") |
hydrogen.behavior additions (1.0.141+)
| Key | Default | What it does |
|---|---|---|
hydrogen.ai_threads_on_startup |
false |
Open the AI Threads panel at startup. BETA; while off, nothing AI-Threads-related runs. Add Panel can still open it for one session. Takes effect next start |
hydrogen.show_lightbulb |
false |
Show the lightbulb (sample prompts) menu in the header. Applies immediately |
More hydrogen.* keys
| Key | Default | What it does |
|---|---|---|
hydrogen.launch_on_boot |
false |
Open Hydrogen when you sign in to your desktop: writes or removes ~/.config/autostart/adom-hydrogen.desktop (XDG autostart, honoured by GNOME, KDE, Cinnamon and others) |
hydrogen.color_scheme |
studio |
studio, studio-bright, studio-dark, kickstand, slate (whole app, editor included) |
hydrogen.editor_code_font / hydrogen.editor_prose_font |
theme |
Code and prose fonts in the editor |
hydrogen.editor_font_size |
15 |
Editor and terminal text size, px |
hydrogen.annotate.hotkey |
true |
Super+Alt+A starts annotate from anywhere (a desktop custom keybinding) |
hydrogen.notify.remote_prompts, .ab_toasts, .remote_toasts |
true |
Prompts and toasts from your other machines and from Adom Bridge |
hydrogen.nav_minimized |
false |
Compact Title Bar |
hydrogen.close_button |
tray (quit with no tray) |
The window's X: tray hides Hydrogen to the desktop's tray (open the tray icon's menu > Quit Hydrogen to exit); quit exits. On a desktop with no tray icons (stock Fedora GNOME) the choices are quit (the default) and minimize; Quit Hydrogen is also in the Adom menu |
hydrogen.show_approval_prompts |
true |
Show Adom Bridge approval prompts inside Hydrogen |
hydrogen.link_open_mode |
remember |
Remember where each site's links open, or ask every time (see hydrogen-browser-picker) |
hydrogen.show_progress_animation |
true |
The orbital animation on progress cards |
hydrogen.assisted_signin |
false |
Narrate and click Authorize during sign-in; it relies on desktop automation Hydrogen does not have on Linux |
hydrogen.watch_internet |
true |
Once a minute, check the workspace can reach the internet (header meter tooltip) |
hydrogen.codex_care |
true |
Reopen dead Codex tabs and keep its backend in step |
hydrogen.updater.* |
actions | Check for updates now; apply a newer workspace image |
On Linux the GPU preference, workspace networking mode, the recovery and wake group, the
close notice and shutdown-on-close are hidden (forHost() in settings.ts): they do nothing here.
Dock Bar (dock.*): dock.groups.enabled, dock.hover.arm_delay (1800 ms),
dock.hover.alt_pin, dock.visibility.reveal_at_launch, .start_collapsed,
.collapse_on_launch, dock.ai.open_thread_on_launch.
adom_desktop (Adom Bridge)
These apply while Adom Bridge runs on this computer (Hydrogen installs it when a Linux build is published for the user's account).
| Key | Type / default | What it does |
|---|---|---|
adom_desktop.open |
action button | Show the Adom Bridge window |
adom_desktop.permissions |
action | ab's approval mode (ask every time, 1 h, 24 h, Auto); granting is always the user's click in ab |
adom_desktop.show_window_on_launch |
bool, false |
Show ab's window when Hydrogen launches |
adom_desktop.exit_with_hd |
bool, true |
Ask ab to shut down when you quit Hydrogen |
schematic (Schematic Workspace)
| Key | Default | What it does |
|---|---|---|
schematic.nudge_amount.small |
1 px |
Arrow-key nudge distance for components |
schematic.nudge_amount.large |
8 px |
Shift+arrow nudge distance |
schematic.invert_zoom_direction |
false |
Invert mouse-wheel zoom direction |
schematic.default_cursor |
crosshair |
Default cursor: crosshair or pointer |
3d (3D Settings)
| Key | Default | What it does |
|---|---|---|
3d.control_style |
fusion |
Orbit/pan/zoom control scheme: fusion, solidworks, or blender (→ "use blender/solidworks controls") |
3d.invert_zoom_direction |
false |
Invert mouse-wheel zoom direction in 3D |
code (Code Workspace)
| Key | Default | What it does |
|---|---|---|
code.appearance.font.family |
DM Mono |
Code editor font family (→ "change the code font") |
code.line_numbers.enabled |
true |
Show line numbers (→ "hide line numbers" = set false) |
code.line_numbers.style |
absolute |
Line-number style: absolute or relative |
code.vim_emulation_mode |
false |
Vim motions in the code editor (→ "turn on vim mode" = set true) |
simulator (Simulator Workspace)
| Key | Default | What it does |
|---|---|---|
simulator.code_editor_position |
right |
Code editor position relative to the 3D environment: right or left |
extensions
Present in the tree but currently has no properties (reserved for future extension-specific settings).
Answering common asks
- "Turn on vim mode" →
code.vim_emulation_mode= true - "Change the theme / dark mode / high contrast" →
general.appearance.theme - "Make Hydrogen start when I log in" →
hydrogen.launch_on_boot= true - "Closing the window should quit" →
hydrogen.close_button= quit - "Bigger editor text" →
hydrogen.editor_font_size - "Change the colors" →
hydrogen.color_scheme - "Blender / SolidWorks orbit controls" →
3d.control_style - "Hide line numbers / change code font" →
code.line_numbers.enabled/code.appearance.font.family - "Make the UI compact" →
general.appearance.user_interface_style= compact
Related skills
- hydrogen-adom-menu — the logo menu that opens Settings (and Ports, API Explorer, etc.)
- hydrogen-ui — the broader Hydrogen UI / panel layout this dialog sits in
- hydrogen-key-values: where the preferences are stored
---
name: hydrogen-settings
description: >-
Hydrogen's Settings window and its preferences on Linux: color scheme, fonts, font
size, launch on boot, close button and tray, link handling, the Dock Bar, the Adom
Bridge options, vim mode, 3D control style. Use when asked how to turn on vim mode,
change the theme, make Hydrogen launch on boot, or where the settings are.
---
# Hydrogen Settings: the preference tree
Open it from the **Adom logo menu** (upper-left) > **Settings**, or the tray menu's
**Settings**. The canonical tree of sections and keys lives in `src/lib/stores/settings.ts`
(`settingsTree`); on Linux `forHost()` hides the settings that do nothing here (listed below).
Preferences are saved per-user (`saveUserSetting` → `PATCH /user/hydrogen/settings`)
and persist across sessions. Setting a key back to its default removes the
override. Keys are dotted (`section.subsection.name`).
They live in the Adom account's cloud key-value store (see **hydrogen-key-values**), so they
follow the user to every machine.
## Sections, keys, and what each does
### general
| Key | Default | What it does |
|---|---|---|
| `general.developer_mode` | `false` | Enables extra developer/debugging features in the app |
| `general.pane_focus_mode` | `false` | Only the focused pane is active and highlighted; turn it on to get the highlight |
| `general.editor.workspace_folder` | `project` | Folder VS Code opens: `project` = /home/adom/project, `home` = /home/adom |
**general.appearance** (subsection)
| Key | Default | What it does |
|---|---|---|
| `general.appearance.theme` | `adom-dark` | App-wide theme. Options: `adom-dark`, `adom-light`, `adom-dark-high-contrast`, `adom-light-high-contrast` (→ "change the theme" / "light mode" / "high contrast") |
| `general.appearance.user_interface_style` | `standard` | UI compactness: `standard` or `compact` (→ "make the UI more compact") |
### hydrogen.behavior additions (1.0.141+)
| Key | Default | What it does |
|---|---|---|
| `hydrogen.ai_threads_on_startup` | `false` | Open the AI Threads panel at startup. BETA; while off, nothing AI-Threads-related runs. Add Panel can still open it for one session. Takes effect next start |
| `hydrogen.show_lightbulb` | `false` | Show the lightbulb (sample prompts) menu in the header. Applies immediately |
### More hydrogen.* keys
| Key | Default | What it does |
|---|---|---|
| `hydrogen.launch_on_boot` | `false` | Open Hydrogen when you sign in to your desktop: writes or removes `~/.config/autostart/adom-hydrogen.desktop` (XDG autostart, honoured by GNOME, KDE, Cinnamon and others) |
| `hydrogen.color_scheme` | `studio` | `studio`, `studio-bright`, `studio-dark`, `kickstand`, `slate` (whole app, editor included) |
| `hydrogen.editor_code_font` / `hydrogen.editor_prose_font` | `theme` | Code and prose fonts in the editor |
| `hydrogen.editor_font_size` | `15` | Editor and terminal text size, px |
| `hydrogen.annotate.hotkey` | `true` | Super+Alt+A starts annotate from anywhere (a desktop custom keybinding) |
| `hydrogen.notify.remote_prompts`, `.ab_toasts`, `.remote_toasts` | `true` | Prompts and toasts from your other machines and from Adom Bridge |
| `hydrogen.nav_minimized` | `false` | Compact Title Bar |
| `hydrogen.close_button` | `tray` (`quit` with no tray) | The window's X: `tray` hides Hydrogen to the desktop's tray (open the tray icon's menu > Quit Hydrogen to exit); `quit` exits. On a desktop with no tray icons (stock Fedora GNOME) the choices are `quit` (the default) and `minimize`; Quit Hydrogen is also in the Adom menu |
| `hydrogen.show_approval_prompts` | `true` | Show Adom Bridge approval prompts inside Hydrogen |
| `hydrogen.link_open_mode` | `remember` | Remember where each site's links open, or ask every time (see **hydrogen-browser-picker**) |
| `hydrogen.show_progress_animation` | `true` | The orbital animation on progress cards |
| `hydrogen.assisted_signin` | `false` | Narrate and click Authorize during sign-in; it relies on desktop automation Hydrogen does not have on Linux |
| `hydrogen.watch_internet` | `true` | Once a minute, check the workspace can reach the internet (header meter tooltip) |
| `hydrogen.codex_care` | `true` | Reopen dead Codex tabs and keep its backend in step |
| `hydrogen.updater.*` | actions | Check for updates now; apply a newer workspace image |
On Linux the GPU preference, workspace networking mode, the recovery and wake group, the
close notice and shutdown-on-close are hidden (`forHost()` in `settings.ts`): they do nothing here.
**Dock Bar** (`dock.*`): `dock.groups.enabled`, `dock.hover.arm_delay` (1800 ms),
`dock.hover.alt_pin`, `dock.visibility.reveal_at_launch`, `.start_collapsed`,
`.collapse_on_launch`, `dock.ai.open_thread_on_launch`.
### adom_desktop *(Adom Bridge)*
These apply while Adom Bridge runs on this computer (Hydrogen installs it when a Linux build is
published for the user's account).
| Key | Type / default | What it does |
|---|---|---|
| `adom_desktop.open` | action button | Show the Adom Bridge window |
| `adom_desktop.permissions` | action | ab's approval mode (ask every time, 1 h, 24 h, Auto); granting is always the user's click in ab |
| `adom_desktop.show_window_on_launch` | bool, `false` | Show ab's window when Hydrogen launches |
| `adom_desktop.exit_with_hd` | bool, `true` | Ask ab to shut down when you quit Hydrogen |
### schematic *(Schematic Workspace)*
| Key | Default | What it does |
|---|---|---|
| `schematic.nudge_amount.small` | `1` px | Arrow-key nudge distance for components |
| `schematic.nudge_amount.large` | `8` px | Shift+arrow nudge distance |
| `schematic.invert_zoom_direction` | `false` | Invert mouse-wheel zoom direction |
| `schematic.default_cursor` | `crosshair` | Default cursor: `crosshair` or `pointer` |
### 3d *(3D Settings)*
| Key | Default | What it does |
|---|---|---|
| `3d.control_style` | `fusion` | Orbit/pan/zoom control scheme: `fusion`, `solidworks`, or `blender` (→ "use blender/solidworks controls") |
| `3d.invert_zoom_direction` | `false` | Invert mouse-wheel zoom direction in 3D |
### code *(Code Workspace)*
| Key | Default | What it does |
|---|---|---|
| `code.appearance.font.family` | `DM Mono` | Code editor font family (→ "change the code font") |
| `code.line_numbers.enabled` | `true` | Show line numbers (→ "hide line numbers" = set false) |
| `code.line_numbers.style` | `absolute` | Line-number style: `absolute` or `relative` |
| `code.vim_emulation_mode` | `false` | Vim motions in the code editor (→ "turn on vim mode" = set true) |
### simulator *(Simulator Workspace)*
| Key | Default | What it does |
|---|---|---|
| `simulator.code_editor_position` | `right` | Code editor position relative to the 3D environment: `right` or `left` |
### extensions
Present in the tree but currently has **no properties** (reserved for future
extension-specific settings).
## Answering common asks
- **"Turn on vim mode"** → `code.vim_emulation_mode` = true
- **"Change the theme / dark mode / high contrast"** → `general.appearance.theme`
- **"Make Hydrogen start when I log in"** → `hydrogen.launch_on_boot` = true
- **"Closing the window should quit"** → `hydrogen.close_button` = quit
- **"Bigger editor text"** → `hydrogen.editor_font_size`
- **"Change the colors"** → `hydrogen.color_scheme`
- **"Blender / SolidWorks orbit controls"** → `3d.control_style`
- **"Hide line numbers / change code font"** → `code.line_numbers.enabled` / `code.appearance.font.family`
- **"Make the UI compact"** → `general.appearance.user_interface_style` = compact
## Related skills
- [hydrogen-adom-menu](../hydrogen-adom-menu/SKILL.md) — the logo menu that opens Settings (and Ports, API Explorer, etc.)
- [hydrogen-ui](../hydrogen-ui/SKILL.md) — the broader Hydrogen UI / panel layout this dialog sits in
- **hydrogen-key-values**: where the preferences are stored