From ba6af3b04ea5c02710d9096be6b0378f488f85b9 Mon Sep 17 00:00:00 2001
From: "Mr.Ten"
Date: Sat, 11 Apr 2026 22:07:29 +0800
Subject: [PATCH] fix(hindsight): clarify pip dependency per mode in README
---
plugins/memory/hindsight/README.md | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/plugins/memory/hindsight/README.md b/plugins/memory/hindsight/README.md
index 024a99303125..bdd17c905fa7 100644
--- a/plugins/memory/hindsight/README.md
+++ b/plugins/memory/hindsight/README.md
@@ -131,4 +131,16 @@ Available in `hybrid` and `tools` memory modes:
## Client Version
-Requires `hindsight-client >= 0.4.22`. The plugin auto-upgrades on session start if an older version is detected.
+Different modes require different packages:
+
+| Mode | Package | Minimum Version |
+|------|---------|----------------|
+| `cloud` | `hindsight-client` | `>= 0.4.22` |
+| `local_external` | `hindsight-client` | `>= 0.4.22` |
+| `local_embedded` | `hindsight-all` | `>= 0.5.0` |
+
+The plugin auto-upgrades `hindsight-client` on session start if an older version is detected, but does **not** auto-install `hindsight-all`. If you are using `local_embedded` mode and see `No module named 'hindsight'` errors, run:
+
+```bash
+uv pip install --system hindsight-all
+```