docs: drop installer flags install.sh/install.ps1 no longer accept
install.sh rejects --no-skills with "unknown option" (rc=1) and neither installer has --skip-computer-use / -SkipComputerUse: the installer no longer pre-installs cua-driver at all. Point the skills page at the setup prompt / hermes skills opt-out, and describe cua-driver as the PM-pinned package that hermes computer-use install prepares (it never runs the upstream installer now).
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user