Adom Hydrogen

@@ -1,10 +1,10 @@ # Project workspaces -A project can ship its Hydrogen layout. The file is `hydrogen/workspace.json` in the project's page repo: which panes, which tabs, which apps, arranged how. Colby built the platform side (the wiki validates the file, adom-cli applies and exports it, Hydrogen Cloud lists it). This page is about the Hydrogen Desktop side: the **Project workspaces** menu next to the Adom logo, what Apply, Unload and Save do on your machine, and how an AI drives all of it without a mouse.+A project can ship its Hydrogen layout. The file is `hydrogen/workspace.json` in the project's page repo: which panes, which tabs, which apps, arranged how. The platform side is shared with Hydrogen Cloud (the wiki validates the file, adom-cli applies and exports it, the cloud lists it). This page is about the Hydrogen Desktop side: the **Project workspaces** menu next to the Adom logo, what Apply, Unload and Save do on your machine, and how an AI drives all of it without a mouse.  <video controls preload="metadata" width="1080" poster="project-workspaces/project-workspaces-poster.png" src="project-workspaces/project-workspaces.mp4" style="max-width:100%;height:auto"></video> -*70 seconds, recorded on a laptop: the menu, then three of Colby's example benches applied and unloaded in turn (Lite, KiCad, and the full seven-tab bench), every step sent through ah's control API. [Download the video](project-workspaces/project-workspaces.mp4).*+*The whole loop in 72 seconds: build a layout, save it as a project workspace, see the file, push it to the project's wiki page, then load it back three ways: from the menu, from an AI through the control API, and from a hydrogen:// link. Every step was driven through Hydrogen's API on a test box. [Download the video](project-workspaces/project-workspaces.mp4).*  ## What you see in ah @@ -16,7 +16,7 @@ The icon right of the Adom logo opens the pulldown. - **Apply** adds the bench's panes and tabs next to what you already have. Merge mode: nothing you had is closed, a tab with the same name is reused, and the VS Code pane is never moved, removed or replaced. Tick **Replace existing tabs on Apply** to close the tabs the bench does not name (VS Code still stays). - **Unload** removes only what Apply created and stops the apps the bench started. Tabs you opened yourself, and apps the dock or another bench started, stay. - The copy button puts the exact `adom-cli hydrogen workspace apply ...` command on the clipboard.-- **Show me how it works** runs a guided walkthrough on your desktop: the same three beats as the video (the menu, Apply on Colby's Lite bench, Unload), narrated, with Adom Bridge's demo panel to pause, step back or forward, mute or stop. If the checkout has no bench it fetches the example first.+- **Show me how it works** runs a guided walkthrough on your desktop: the menu, Apply on an example bench, Unload, narrated, with Adom Bridge's demo panel to pause, step back or forward, mute or stop. If the checkout has no bench it fetches the example first. - **Save as project workspace** exports your live layout into a project folder as `hydrogen/workspace.json` (or `hydrogen/workspaces/<name>.json`). It asks for the project reference only when the folder has no `page.json`. The file is written and mirrored to the cloud, not committed: commit and push it with the project as usual (`adom-wiki repo push` validates it).  Apply, Unload and Save run `adom-cli` inside your WSL2 workspace, the same binary and the same commands Hydrogen Cloud runs in a container. The command and its output stream into a launch console tab (the one the Dock Bar uses), which closes itself when the command succeeds and stays open with the reason when it fails.@@ -74,7 +74,7 @@ The workspace API itself is on the local proxy (port 47083, `ADOM_HYDROGEN_URL`  ## Example benches -Colby's throwaway examples, safe to clone and try: `kcknox/ztest-bench-lite` (3 tabs), `kcknox/ztest-bench-kicad` (6 tabs, declares the KiCad bridge), `kcknox/ztest-bench` (7 tabs, three dashboards).+The bench from the video: `john/example-bench` (VS Code, the project page, the KiCad bridge page). Other throwaway examples, safe to clone and try: `kcknox/ztest-bench-lite` (3 tabs), `kcknox/ztest-bench-kicad` (6 tabs, declares the KiCad bridge), `kcknox/ztest-bench` (7 tabs, three dashboards).  ```bash cd ~/project && adom-wiki repo clone kcknox/ztest-bench-lite

⋯ 1 unchanged line ⋯

⋯ 1 unchanged line ⋯