diff --git a/website/docs/user-guide/features/computer-use.md b/website/docs/user-guide/features/computer-use.md index b41c478361..6c93e140fd 100644 --- a/website/docs/user-guide/features/computer-use.md +++ b/website/docs/user-guide/features/computer-use.md @@ -41,10 +41,10 @@ no-foreground invariant, click-dispatch internals — see ## Enabling -**Fresh installs already have the driver.** The Hermes installer -(`install.sh` / `install.ps1`) pre-installs `cua-driver` (best-effort; -pass `--skip-computer-use` / `-SkipComputerUse` to opt out), so enabling -Computer Use is just a config flip: +**The driver is a PM-managed tool.** `cua-driver` is pinned in +`pm/lock.json`; the installer does not fetch it up front (there is no +`--skip-computer-use` / `-SkipComputerUse` flag), and it is prepared the +first time something enables Computer Use: - **`hermes tools`** → pick `🖱️ Computer Use` — installs the driver automatically if it's still missing. @@ -52,21 +52,21 @@ Computer Use is just a config flip: driver is missing, the toggle kicks off the install in the background automatically (watch progress in the toolset panel). -**Manual fallback (older installs, skipped installer step):** +**Manual install / repair:** ``` hermes computer-use install ``` -This fetches and runs the upstream cua-driver installer — `install.sh` -on macOS/Linux, `install.ps1` on Windows. Use `hermes computer-use -status` to verify the install. +This asks PM to prepare the pinned `cua-driver` package (verified against +`pm/lock.json`) — it does not run the upstream installer. Use +`hermes computer-use status` to verify the install. Already have cua-driver? Hermes reuses it when it supports the 0.20 runtime contract. During setup, toolset enablement, `hermes update`, and the first `computer_use` call of a session, Hermes checks the local version and manifest. It repairs an old or incomplete standard installation through -the upstream installer (at most once per session at runtime). A binary +PM (at most once per session at runtime). A binary selected with `HERMES_CUA_DRIVER_CMD` stays under your control, so Hermes reports the incompatibility and leaves it unchanged. diff --git a/website/docs/user-guide/features/skills.md b/website/docs/user-guide/features/skills.md index 0d164d39ec..b0c035db5b 100644 --- a/website/docs/user-guide/features/skills.md +++ b/website/docs/user-guide/features/skills.md @@ -21,11 +21,11 @@ See also: By default every profile is seeded with the bundled skill catalog, and each `hermes update` adds any newly bundled skills. If you want a profile with **no bundled skills** — and that stays empty across updates — you have two paths: -**At install time** (applies to the default `~/.hermes` profile): - -```bash -curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --no-skills -``` +**At install time** (applies to the default `~/.hermes` profile): the +installer has no `--no-skills` flag. Its setup stage asks whether to seed the +bundled catalog when you pick the Blank Slate setup; answering no writes the +opt-out marker described below. Non-interactive installs seed the catalog, so +run `hermes skills opt-out` afterwards if you want the profile empty. **At profile-create time** (named profiles): @@ -41,7 +41,7 @@ hermes skills opt-out --remove # also delete UNMODIFIED bundled skills (confir hermes skills opt-in --sync # undo: remove the marker and re-seed now ``` -All three paths write a `.no-bundled-skills` marker into the profile directory. While the marker is present, the installer, `hermes update`, and any skill sync all skip bundled-skill seeding for that profile. Delete the marker (or run `hermes skills opt-in`) to re-enable. +All of these paths write a `.no-bundled-skills` marker into the profile directory. While the marker is present, the installer, `hermes update`, and any skill sync all skip bundled-skill seeding for that profile. Delete the marker (or run `hermes skills opt-in`) to re-enable. :::note Safe by default `hermes skills opt-out` only stops *future* seeding — it never deletes anything already on disk. The optional `--remove` flag deletes bundled skills **only** when they are unmodified (byte-identical to the version Hermes installed). Skills you have edited, skills installed from the hub, and skills you wrote yourself are always kept.