Adom Hydrogen (platform base)

@@ -4,7 +4,7 @@   "type": "bootstrap",   "title": "Adom Hydrogen (platform base)",   "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",-  "version": "0.5.58",+  "version": "0.5.59",   "description": "Hydrogen's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen on ANY platform: the runtime-neutral hydrogen-* skills and the generic editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hydrogen-windows-bootstrap (WSL2), adom/hydrogen-mac-bootstrap, adom/hydrogen-ubuntu-bootstrap. The reference design other orgs copy to build their own bootstrap on adom/core.",   "org": "adom",   "tags": [@@ -33,4 +33,4 @@     "hydrogen editor configuration",     "where do hydrogen skills come from"   ]-}+}\ No newline at end of file

@@ -4,7 +4,7 @@   "type": "bootstrap",   "title": "Adom Hydrogen (platform base)",   "brief": "Layer Hydrogen's workspace onto a standard Adom workstation.",-  "version": "0.5.58",+  "version": "0.5.59",   "description": "Hydrogen's PLATFORM-GENERIC workspace layer on top of adom/core. Installs adom/core for the full Adom ecosystem, then adds everything common to running inside Hydrogen on ANY platform: the runtime-neutral hydrogen-* skills and the generic editor configuration (Claude Code CLI + extension, VS Code settings, trusted domains). Platform-specific layers depend on THIS: adom/hydrogen-windows-bootstrap (WSL2), adom/hydrogen-mac-bootstrap, adom/hydrogen-ubuntu-bootstrap. The reference design other orgs copy to build their own bootstrap on adom/core.",   "org": "adom",   "tags": [

@@ -1,7 +1,7 @@ --- name: hydrogen-widget description: "Build, list, open and drive Hydrogen Widgets: small live panels in Hydrogen Desktop's Title Bar (Claude usage, Codex usage, a clock, or your own), each served by a binary inside the workspace and mounted in a sandboxed slot. Covers the hydrogen-widget.json facet a wiki repo carries (alone, or next to its dock manifest and project workspace), the per-widget page the pulldown links to, the launch contract (HYDROGEN_WIDGET_ID / _PORT / _SLOT / HYDROGEN_PROXY_PORT, the health URL, the explicit takeover, stop-first relaunch), the tall and compact layouts, vendor marks, private repos (read with the user's session), the curated list on adom/hydrogen-bootstrap, the Hydrogen Widgets pulldown, and the control API (GET /widgets, POST /widgets/open|close|navigate|refresh|menu, GET /widgets/status) so an AI can do all of it with no mouse. Trigger words: hydrogen widget, hydrogen-widget, title bar widget, widgets pulldown, widget slot, claude usage widget, codex usage widget, tokens left widget, usage meter in the title bar, hydrogen-widget.json, /widgets/open, make a widget, add a widget to hydrogen, private widget, widget SDK."-version: 1.5.4+version: 1.5.6 ---  # hydrogen-widget: small live panels in Hydrogen Desktop's Title Bar@@ -182,13 +182,36 @@ the reference: adom/adom-vscode `widgets/bin/hydrogen-widget-lib.py` is the page `hydrogen-widget-claude-usage` and `hydrogen-widget-codex-usage` the data feeds, and adom/hydrogen-bootstrap `bin/hydrogen-widget-clock` the smallest one. +### A bigger view on hover (optional, Hydrogen 1.0.429+)++A widget can ask for a larger live surface inside its hover card by adding `expand` to the+same message: `window.parent.postMessage({hdWidget: {width: 265, expand: {width: 560, height:+400}}}, '*')`. When the card opens, Hydrogen moves the SAME frame over a reserved area of the+card (width clamped 280..720, height 120..600, at most 45% of the window height); the title-bar+slot keeps its place and shows "Expanded below". Nothing reloads, so your page keeps its state.+Moving off the card shrinks it back. Rules:++- keep `width` the compact title-bar width; never send the expanded width as `width`;+- switch layouts on height (`@media (min-height: 100px)` shows the big view), not on a message;+- send `expand: null` to withdraw, and omit it to keep the plain card;+- the request is dropped whenever the frame loads, so post it again on your `load` event;+- keys do not leave an iframe: forward Escape with `postMessage({hdWidget: {collapse: true}}, '*')`.++Only the widget's own frame, from its own origin, is listened to. Adom AI Flow is the reference.+Details: `docs/hydrogen-widget-expansion.md` in the Hydrogen source.+ ### Listing it  - **Your checkout**: any repo under `~/project` (one clone folder down too) with a   `hydrogen-widget.json` appears in the pulldown as "(checkout)", no publish needed.-- **Everyone**: publish the repo (with the binary in its package) and ask the adom team to add-  `{ "id", "wiki_repo", "order" }` to `widgets/widgets.json` on adom/hydrogen-bootstrap, the-  curated list Hydrogen reads. The list only orders and names repos; every other fact comes+- **Everyone**: publish the repo (with the binary in its package), then file an issue on the+  adom/hydrogen-bootstrap page titled `List widget: <owner>/<repo>` with a one-line description+  and a picture of the slot (its `/preview?h=38`). That page's maintainers add+  `{ "id", "wiki_repo", "order" }` to `widgets/widgets.json`, the curated list Hydrogen reads,+  and the widget appears in every user's pulldown at their next refresh. From a workspace:+  `adom-wiki issue create adom/hydrogen-bootstrap --title "List widget: <owner>/<repo>" --body "..."`.+  The list only orders and names repos; every other fact comes from the repo's own manifest,+  which the curated list Hydrogen reads. The list only orders and names repos; every other fact comes   from the repo's own manifest. - **Just you, or your team (private)**: keep the repo private on the wiki (`adom-wiki page   create --private`, `adom-wiki page share` for teammates). Hydrogen reads the curated list and