← Commit history

Project workspaces sub-readme: page-root-relative asset paths (the wiki resolves them from the page root)

John Lauer ·3f251c2169 ·1mo ago ·parent d10a77a
1 file changed +5−5
project-workspaces/README.md+5−5
@@ -2,15 +2,15 @@  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. -<video controls preload="metadata" poster="project-workspaces-poster.png" src="project-workspaces.mp4" style="max-width:100%"></video>+<video controls preload="metadata" poster="project-workspaces/project-workspaces-poster.png" src="project-workspaces/project-workspaces.mp4" style="max-width:100%"></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.mp4).*+*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).*  ## What you see in ah  The icon right of the Adom logo opens the pulldown. -![The Project workspaces menu with three benches grouped by project](menu.png)+![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).@@ -20,13 +20,13 @@ The icon right of the Adom logo opens the pulldown.  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. -![The KiCad bench applied: five app tabs across two new panes](kicad-bench-applied.png)+![The KiCad bench applied: five app tabs across two new panes](project-workspaces/kicad-bench-applied.png)  ## The one-time offer  When a project in your checkout ships a workspace and you have not been asked about it before, ah shows one card at the top: "this project ships a workspace. Apply / Not now". It is keyed on the same preference the cloud uses (`workspace.offered.<owner>.<repo>`), so you are asked once across both. An unanswered card dismisses itself after a minute and counts as Not now on that machine. Nothing is ever applied on its own. -![The offer card](offer-card.png)+![The offer card](project-workspaces/offer-card.png)  ## Placeholder tabs and bridges