Adom Hydrogen

@@ -279,8 +279,9 @@ how to contribute a prompt via PR are documented in the  A project can carry its Hydrogen bench, `hydrogen/workspace.json`: which panes, which tabs, which apps. The menu right of the Adom logo lists every bench in your checkout and in the cloud mirror,-grouped by project; Apply adds its panes and tabs next to yours through `adom-cli`, Unload removes-only what Apply created, and Save as project workspace exports your live layout into the project.+grouped by project; Apply builds the bench from scratch through `adom-cli` (the VS Code pane stays,+and Keep my other tabs open adds it next to yours instead), Unload puts things back, and Save as+project workspace exports your live layout into the project. The same file and the same commands work on Hydrogen Cloud. Video, controls, the API routes and the skills your AI uses are in the [Project workspaces sub-readme](https://wiki.adom.inc/adom/hydrogen/files/project-workspaces/README.md).

@@ -33,7 +33,7 @@ The icon right of the Adom logo opens the pulldown. ![The Project workspaces menu with three benches grouped by project](project-workspaces/menu.png)  - Benches come from two places and are grouped by project, labelled "project / name": the files in your workspace checkout (`hydrogen/workspace.json` and `hydrogen/workspaces/*.json`, at `~/project` and one clone folder down) and the cloud mirror, for benches the checkout does not have (tagged `mirror`, and `legacy` when they carry no project).-- **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).+- **Apply** builds the bench from scratch: its panes and tabs, with the VS Code pane kept where it is. The tabs it closes are recorded and come back on Unload. Tick **Keep my other tabs open** to add the bench next to what you have instead (a tab with the same name is reused). Hydrogen Cloud applies the same way. - **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 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.@@ -61,7 +61,7 @@ Everything in the menu is reachable on ah's control API (port 47084 by default, |---|---| | `GET /workspaces/benches` | The list the menu shows, with `identity`, `project`, `path`, `source`, and whether each is applied. | | `POST /workspaces/refresh` | Rescan the checkout and the mirror. |-| `POST /workspaces/apply` | `{ "identity": "owner/slug#hydrogen/workspace.json", "replace": false }`, or `project`, `path` or `name`. Returns the CLI envelope and the console transcript. |+| `POST /workspaces/apply` | `{ "identity": "owner/slug#hydrogen/workspace.json", "merge": false }`, or `project`, `path` or `name`. Returns the CLI envelope and the console transcript. | | `POST /workspaces/unload` | Same selectors. Tries the bench identity, then the path adom-cli recorded. | | `POST /workspaces/save` | `{ "dir": "/home/adom/project/my-board", "out": "hydrogen/workspace.json", "project": "owner/slug" }` | | `POST /workspaces/offer` | `{ "action": "apply" }` or `{ "action": "dismiss" }` for the card. |