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
Project workspaces sub-readme: deep link, walkthrough, ab verb route (ah 1.0.380)
1 file changed
+4−1
project-workspaces/README.md+4−1@@ -16,6 +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. - **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.@@ -45,6 +46,8 @@ Everything in the menu is reachable on ah's control API (port 47084 by default, | `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. | | `POST /workspaces/menu` | `{ "open": true }` to show the pulldown (also UI-bus `project-workspaces.open` / `.close`). |+| `POST /workspaces/demo` | Starts the "Show me how it works" walkthrough: ab's demo panel paces it, captions and narration explain each step, the example bench is applied and unloaded. |+| `POST /ab/verb` | Any Adom Bridge verb on this machine by name (`{command, args}`), the loopback call the walkthrough uses for captions and the panel. | | `GET /workspaces/status` | The command in flight, the last outcome with its transcript, the card showing, benches applied this session. | ```bash@@ -67,7 +70,7 @@ The workspace API itself is on the local proxy (port 47083, `ADOM_HYDROGEN_URL` - A bench the checkout carries is applied as the local file (the copy you are editing); the wiki reference is used only for mirror-only entries. - The desktop resolves a files-only wiki clone's project from its page slug, since `page.json` names the slug but not the owner. - The desktop has no 3D editor panel: a `3d-viewer` tab opens as a "not available on Hydrogen Desktop" tab. Open the same bench in Hydrogen Cloud to use it.-- The `hydrogen://...?workspace=` deep link is honoured as a query on the editor page, but ah registers no URL scheme yet, so a link from the wiki cannot open ah on its own.+- `hydrogen://edit?workspace=<ref|identity|path>` opens or focuses ah and applies that bench once the list loads (the scheme is registered by the installer and at every start). A bench the checkout does not have gets a toast telling you to clone the project first. ## Example benches