diff --git a/content/02.whats-new/4.hermes-plugin.md b/content/02.whats-new/4.hermes-plugin.md
index b557a81..4175258 100644
--- a/content/02.whats-new/4.hermes-plugin.md
+++ b/content/02.whats-new/4.hermes-plugin.md
@@ -22,8 +22,12 @@ The [hermes-basic-memory](https://github.com/basicmachines-co/basic-memory/tree/
 
 ## Quick Install
 
+Managed installation requires a Hermes Agent release containing the
+[manifest-v2 installer fix](https://github.com/NousResearch/hermes-agent/pull/85893).
+Hermes Agent v0.20.5 (`v2026.8.19`) and earlier are not supported.
+
 ```bash
-hermes plugins install basicmachines-co/basic-memory --path integrations/hermes
+hermes plugins install basicmachines-co/basic-memory/integrations/hermes
 ```
 
 Activate it in `~/.hermes/config.yaml`:
diff --git a/content/08.integrations/07.hermes.md b/content/08.integrations/07.hermes.md
index ebf4e9b..9ecb27b 100644
--- a/content/08.integrations/07.hermes.md
+++ b/content/08.integrations/07.hermes.md
@@ -11,7 +11,7 @@ The plugin is open source and lives in the basic-memory monorepo — browse the
 ::
 
 ::tip
-Requires [Hermes Agent](https://github.com/NousResearch/hermes-agent) and [`uv`](https://docs.astral.sh/uv/) on your PATH. The plugin auto-installs the `bm` CLI on first init via `uv tool install basic-memory` (a one-time ~10s pause if it isn't already present).
+Managed installation requires a [Hermes Agent](https://github.com/NousResearch/hermes-agent) release containing the [manifest-v2 installer fix](https://github.com/NousResearch/hermes-agent/pull/85893). Hermes Agent v0.20.5 (`v2026.8.19`) and earlier are not supported. If the installer says it only supports `manifest_version: 1`, update Hermes to a release containing that fix. You also need [`uv`](https://docs.astral.sh/uv/) on your PATH. The plugin auto-installs the `bm` CLI on first init via `uv tool install basic-memory` (a one-time ~10s pause if it isn't already present).
 ::
 
 ---
@@ -21,7 +21,7 @@ Requires [Hermes Agent](https://github.com/NousResearch/hermes-agent) and [`uv`]
 Install the plugin:
 
 ```bash
-hermes plugins install basicmachines-co/basic-memory --path integrations/hermes
+hermes plugins install basicmachines-co/basic-memory/integrations/hermes
 ```
 
 Then activate it in `~/.hermes/config.yaml`: