app
Adom Hydrogen
Public Made by Adomby adom
The whole Adom experience as one signed native app: your editor, your AI agent, and the full electronics design toolchain, running locally on your own machine.
← Commit history
Hydrogen Widgets: consistent name on the page; several from one repo
2 files changed
+32−25
README.md+5−5@@ -125,7 +125,7 @@ Hover a card and dwell, and it zooms to a full billboard so you can actually rea |---|---| | [The Dock Bar](docs/dockbar.md) | The full tour with screenshots of everything the Dock Bar does (the interstitial, webview takeover, container launch steps, AI threads new and resumed, health LEDs, honest failures, settings), plus the complete `dockbar.json` manifest reference and the publisher checklist for making YOUR app dock-ready. | | [Project workspaces](project-workspaces/README.md) | The layout a project ships (hydrogen/workspace.json): the menu next to the Adom logo, Apply, Unload and Save as project workspace, the one-time offer, placeholder tabs that know the Adom Bridge state, and every control on the API so your AI never needs a mouse. Opens with a 70-second video. |-| [Widgets](widgets/README.md) | Small live panels in the title bar, served from your workspace: Claude usage (5-hour, weekly, model bucket), Codex usage, a clock to copy. Any wiki repo can ship one with a hydrogen-widget.json; open widgets come back after a restart; everything is on the control API. |+| [Hydrogen Widgets](widgets/README.md) | Small live panels in the Title Bar, served from your workspace: Claude usage (5-hour, weekly, model bucket), Codex usage, a clock to copy. Any wiki repo can ship one with a hydrogen-widget.json; open widgets come back after a restart; everything is on the control API. | **Publishing an app?** Start with the [Dock Bar guide](docs/dockbar.md); the `hydrogen-dock` skill that ships in every Hydrogen container teaches your AI the same contract. To request a spot on the global list, open an issue on this page. @@ -315,14 +315,14 @@ Uninstall Hydrogen like any Windows app: **Settings → Apps → Installed apps - **"Ensure container runtime" won't complete.** Make sure WSL2 is healthy (`wsl --version`, `wsl -l -v`). A stale or corrupt `Adom‑Workspace` distro can be reset with `wsl --unregister Adom-Workspace`: Hydrogen re‑imports a fresh v15 image on the next launch. - **Something feels out of date.** The container self‑updates, but you can force it from the container terminal: `adom-wiki pkg install adom/hydrogen-windows-bootstrap`. -## Hydrogen widgets (small live panels in the title bar)+## Hydrogen Widgets (small live panels in the Title Bar) -The bar across the top of the window is the **Title Bar**: the Adom menu, the meters, the widgets, the bell, your avatar and the window controls. Left of the bell there is a puzzle-piece icon: **Hydrogen Widgets**. Each widget is a small page served by a program inside your workspace and shown in a sandboxed slot in the Title Bar, sized to the bar (30 px, or 20 px when the bar is compact). Open one from the pulldown and it stays open across restarts, per user.+The bar across the top of the window is the **Title Bar**: the Adom menu, the meters, the Hydrogen Widgets, the bell, your avatar and the window controls. Left of the bell there is a puzzle-piece icon: **Hydrogen Widgets**. Each Hydrogen Widget is a small page served by a program inside your workspace and shown in a sandboxed slot in the Title Bar, sized to the bar (30 px, or 20 px when the bar is compact). Open one from the pulldown and it stays open across restarts, per user. Three ship today: - **Claude usage**: your 5-hour session, your weekly limit, and the weekly model bucket that applies, as percent used, from the Claude Code sign-in in your workspace. The numbers you would otherwise check by hand in Claude Code's `/usage`. - **Codex usage**: the plan's rate-limit window as percent used, from the Codex sign-in.-- **Clock**: the time and date, and the smallest possible widget, the one to copy when you make your own.+- **Clock**: the time and date, and the smallest possible Hydrogen Widget, the one to copy when you make your own. -Making one is a facet a wiki repo carries, `hydrogen-widget.json`, next to its dock manifest or its project workspace, or alone. The [hydrogen-widget skill](https://wiki.adom.inc/adom/hydrogen-bootstrap/files/skills/hydrogen-widget/SKILL.md) has the manifest, the launch contract and a fifty-line example. Your AI drives all of it with no mouse: `GET /widgets`, `POST /widgets/open {"id":"claude-usage"}`, `POST /widgets/close`, `POST /widgets/navigate`, `GET /widgets/status`. Details and pictures: [Widgets](widgets/README.md).+Making one is a facet a wiki repo carries, `hydrogen-widget.json`, next to its dock manifest or its project workspace, or alone. The [hydrogen-widget skill](https://wiki.adom.inc/adom/hydrogen-bootstrap/files/skills/hydrogen-widget/SKILL.md) has the manifest, the launch contract and a fifty-line example. Your AI drives all of it with no mouse: `GET /widgets`, `POST /widgets/open {"id":"claude-usage"}`, `POST /widgets/close`, `POST /widgets/navigate`, `GET /widgets/status`. Details and pictures: [Hydrogen Widgets](widgets/README.md).
widgets/README.md+27−20@@ -1,35 +1,35 @@-# Widgets: small live panels in the title bar+# Hydrogen Widgets: small live panels in the Title Bar  -Compact Title Bar, one row per widget:+Compact Title Bar, one row per Hydrogen Widget: -+ The Hydrogen Widgets pulldown:  The bar across the top of the Hydrogen window is the **Title Bar** (the Adom menu, the meters,-the widgets, the bell, your avatar and the window controls); the chevron at the top edge makes+the Hydrogen Widgets, the bell, your avatar and the window controls); the chevron at the top edge makes it the **compact Title Bar**. Left of the bell there is a puzzle-piece icon, **Hydrogen Widgets**. Open one from that pulldown and a small panel appears in the Title Bar, served by a program running inside your workspace and shown in a sandboxed slot sized to the bar, full or compact. It stays open across restarts, per user, and closes from the same pulldown or the small x that appears when you hover it. The last row of the pulldown, "Make your own Hydrogen Widget", opens this page. -The Claude and Codex widgets carry their vendor marks, the same artwork the editor's AI launch+The Claude and Codex Hydrogen Widgets carry their vendor marks, the same artwork the editor's AI launch bar uses, so you can tell whose numbers you are looking at. ## The three that ship -| Widget | Shows | Where the numbers come from |+| Hydrogen Widget | Shows | Where the numbers come from | |---|---|---| | Claude usage | your 5-hour session, your weekly limit, and the weekly model bucket that applies, as percent used | the Claude Code sign-in in your workspace, the same numbers Claude Code shows in `/usage` | | Codex usage | your plan's rate-limit window as percent used, plus a secondary window when the plan has one | the Codex sign-in in your workspace, what Codex shows in `/status` |-| Clock | the time and date | the workspace clock; the smallest possible widget, the one to copy |+| Clock | the time and date | the workspace clock; the smallest possible Hydrogen Widget, the one to copy | -A widget with nothing to show says so in its slot ("sign in to Codex in this workspace") rather than staying blank.+A Hydrogen Widget with nothing to show says so in its slot ("sign in to Codex in this workspace") rather than staying blank. ## Driving it from an AI @@ -37,34 +37,41 @@ Nothing in the pulldown needs a mouse. On Hydrogen's control API: | Route | What it does | |---|---|-| `GET /widgets` | the list, with `open`, `status` (closed, installing, starting, live, failed) and `url` per widget |-| `POST /widgets/open {"id":"claude-usage"}` | mounts the slot, installs the widget's package, launches it, hands the slot over when its page answers |+| `GET /widgets` | the list, with `open`, `status` (closed, installing, starting, live, failed) and `url` per Hydrogen Widget |+| `POST /widgets/open {"id":"claude-usage"}` | mounts the slot, installs the Hydrogen Widget's package, launches it, hands the slot over when its page answers | | `POST /widgets/close {"id":"..."}` | unmounts the slot and stops the program | | `POST /widgets/navigate {"id":"...","url":"..."}` | points an open slot at a page yourself | | `POST /widgets/refresh` | re-reads the list from the wiki and your checkout | | `POST /widgets/menu {"open":true}` | shows or hides the pulldown |-| `GET /widgets/status` | open ids, each widget's status and url, the pulldown state |+| `GET /widgets/status` | open ids, each Hydrogen Widget's status and url, the pulldown state | UI-bus commands `widgets.menu.open` and `widgets.menu.close` do the same as the pulldown click. -## Each widget's own page+## Each Hydrogen Widget's own page -Every row in the pulldown links to that widget's page on its wiki repo (the `docs` field in its+Every row in the Hydrogen Widgets pulldown links to that Hydrogen Widget's page on its wiki repo (the `docs` field in its manifest, `widgets/README.md` by default): a picture of it in the full and compact Title Bar, what it shows and where the numbers come from, how often it asks, the files in the repo that make it a-widget, and a link to the SDK. The shipped ones: [Claude and Codex usage](https://wiki.adom.inc/adom/adom-vscode/files/widgets/README.md)+Hydrogen Widget, and a link to the SDK. The shipped ones: [Claude and Codex usage](https://wiki.adom.inc/adom/adom-vscode/files/widgets/README.md) and [Clock](https://wiki.adom.inc/adom/hydrogen-bootstrap/files/widgets/README.md). -## Private widgets+## Private Hydrogen Widgets -Hydrogen reads the widget list and every manifest with your own sign-in, so a widget on a private+Hydrogen reads the Hydrogen Widget list and every manifest with your own sign-in, so a Hydrogen Widget on a private wiki repo shows for the people the page is shared with and nobody else. Keep a repo private with-`adom-wiki page create --private` and share it with `adom-wiki page share`; a private widget comes+`adom-wiki page create --private` and share it with `adom-wiki page share`; a private Hydrogen Widget comes from your checkout or your own list, not from the curated one. +## Several Hydrogen Widgets from one repo++A repo's `hydrogen-widget.json` is either one Hydrogen Widget or `{"widgets": [ ... ]}` with+several, each with its own id, name, mark, launch command and port, sharing the repo's package+and page. adom/adom-vscode ships Claude usage and Codex usage that way; the curated list names+each by repo plus id, so they are separate rows in the pulldown and open and close on their own.+ ## Making your own -A widget is a facet a wiki repo carries: a `hydrogen-widget.json` at its root, next to its dock+A Hydrogen Widget is a facet a wiki repo carries: a `hydrogen-widget.json` at its root, next to its dock manifest or its project workspace, or on its own. Any repo in your checkout with that file shows up in the pulldown at once, marked "(checkout)", so you can build one without publishing. Publishing it and asking the adom team to list it in `widgets/widgets.json` on@@ -77,5 +84,5 @@ copy. Your AI already has that skill. ## Why the name -wiki-widget is the component-page widget, and other surfaces will get their own-(kicad-widget, fusion-widget). hydrogen-widget is only ever the title bar.+wiki-widget is the component-page kind, and other surfaces will get their own+(kicad-widget, fusion-widget). A Hydrogen Widget is only ever the Title Bar.