Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

fix(cli): show the embedding provider the server reports in agentmemory status (#1499)

Nanamifa1171d28222
diff --git a/.github/workflows/release-gate.yml b/.github/workflows/release-gate.yml
index 60311d1b..05ee4593 100644
--- a/.github/workflows/release-gate.yml
+++ b/.github/workflows/release-gate.yml
@@ -66,6 +66,7 @@ jobs:
--dependencies "$GITHUB_WORKSPACE/node_modules" \
--out "${{ runner.temp }}/vector-recovery-gate"
- run: npm run test:summary-recovery:packaged -- --skip-build --out "${{ runner.temp }}/summary-recovery-gate"
+ - run: npm run test:cli-diagnostics:packaged -- --skip-build --out "${{ runner.temp }}/cli-diagnostics-gate"
- name: Verify bounded graph migration with the packaged CLI
run: |
mkdir -p "$RUNNER_TEMP/graph-index-pack"
@@ -81,6 +82,7 @@ jobs:
${{ runner.temp }}/startup-gate
${{ runner.temp }}/vector-recovery-gate
${{ runner.temp }}/summary-recovery-gate
+ ${{ runner.temp }}/cli-diagnostics-gate
${{ runner.temp }}/graph-index-gate
if-no-files-found: ignore
retention-days: 14
diff --git a/README.md b/README.md
index 1417ee85..b57b5c8f 100644
--- a/README.md
+++ b/README.md
@@ -851,7 +851,7 @@ The agentmemory entry is the **same MCP server block** across every host that us
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` enables MCP tools. Add `--with-hooks` to load the native capture plugin bundled with AgentMemory. No separate plugin package is needed. [DSH](docs/dsh.md). |
| **Goose** | Goose MCP settings UI | Same `mcpServers` block; use `goose configure` → Add Extension → MCP. Direct YAML edit at `~/.config/goose/config.yaml` is supported but the schema uses `extensions:` + `cmd` (not `mcpServers:` + `command`). |
| **Aider** | n/a | Use the [authenticated REST examples](#validate-a-fresh-install-and-restart-persistence) to save and search memory from scripts. |
-| **Any agent (32+)** | n/a | `npx skillkit install agentmemory` auto-detects the host and merges. |
+| **Supported agents** | Skills only | `npx skills add rohitg00/agentmemory`; choose the skills and agents to install to. |
**Sandboxed MCP clients** (Flatpak / Snap / restrictive containers) that can't reach the host's `localhost`: also set `"AGENTMEMORY_FORCE_PROXY": "1"` in the `env` block, and point `AGENTMEMORY_URL` at a route the sandbox can actually reach (e.g. your LAN IP).
diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md
index 75cdd6c7..c353c033 100644
--- a/READMEs/README.ar-SA.md
+++ b/READMEs/README.ar-SA.md
@@ -854,7 +854,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | يُفعّل `agentmemory connect dsh` أدوات MCP. أضف `--with-hooks` لتحميل إضافة الالتقاط الأصلية المضمّنة مع AgentMemory، دون حزمة إضافية. [DSH](../docs/dsh.md). |
| **Goose** | واجهة إعدادات MCP في Goose | نفس كتلة `mcpServers`؛ استخدم `goose configure` ← Add Extension ← MCP. يُدعم التعديل المباشر لملف YAML في `~/.config/goose/config.yaml`، لكن المخطط يستخدم `extensions:` + `cmd` (وليس `mcpServers:` + `command`). |
| **Aider** | لا ينطبق | استخدم [أمثلة REST الموثّقة](#validate-a-fresh-install-and-restart-persistence) للحفظ والبحث من السكربتات. |
-| **أي وكيل (أكثر من 32)** | لا ينطبق | يكتشف `npx skillkit install agentmemory` المضيف تلقائيًا ويدمج الإعدادات. |
+| **الوكلاء المدعومون** | المهارات فقط | `npx skills add rohitg00/agentmemory`; اختر المهارات والوكلاء الذين تريد تثبيتها لديهم. |
**عملاء MCP المحتجزون في بيئة معزولة (sandbox)** (Flatpak / Snap / الحاويات المقيَّدة) الذين لا يمكنهم الوصول إلى `localhost` الخاص بالمضيف: اضبط أيضًا `"AGENTMEMORY_FORCE_PROXY": "1"` في كتلة `env`، ووجِّه `AGENTMEMORY_URL` إلى مسار يمكن للبيئة المعزولة الوصول إليه فعليًا (مثل عنوان IP على شبكتك المحلية).
diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md
index 60351d42..4346dd2b 100644
--- a/READMEs/README.bn-BD.md
+++ b/READMEs/README.bn-BD.md
@@ -845,7 +845,7 @@ Hermes, OpenClaw, Pi ও Oh My Pi কানেক্টর ডিফল্টভ
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` MCP টুল চালু করে। AgentMemory-এর সঙ্গে থাকা নেটিভ ক্যাপচার প্লাগইন চালু করতে `--with-hooks` যোগ করুন। আলাদা প্লাগইন প্যাকেজ প্রয়োজন নেই। [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP সেটিংস UI | একই `mcpServers` ব্লক; `goose configure` → Add Extension → MCP ব্যবহার করুন। `~/.config/goose/config.yaml`-এ সরাসরি YAML এডিট সাপোর্টেড, কিন্তু স্কিমা `extensions:` + `cmd` ব্যবহার করে (`mcpServers:` + `command` নয়)। |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **যেকোনো এজেন্ট (32+)** | n/a | `npx skillkit install agentmemory` হোস্ট অটো-ডিটেক্ট করে মার্জ করে। |
+| **সমর্থিত এজেন্ট** | শুধু স্কিল | `npx skills add rohitg00/agentmemory`; ইনস্টল করার স্কিল এবং লক্ষ্য এজেন্ট বেছে নিন। |
**স্যান্ডবক্সড MCP ক্লায়েন্ট** (Flatpak / Snap / রেস্ট্রিক্টিভ কন্টেইনার) যা হোস্টের `localhost`-এ পৌঁছাতে পারে না: `env` ব্লকে `"AGENTMEMORY_FORCE_PROXY": "1"`-ও সেট করুন, এবং `AGENTMEMORY_URL` এমন একটি রুটে পয়েন্ট করুন যেখানে স্যান্ডবক্স সত্যিই পৌঁছাতে পারে (যেমন আপনার LAN IP)।
diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md
index 0c88f19e..2442c41f 100644
--- a/READMEs/README.cs-CZ.md
+++ b/READMEs/README.cs-CZ.md
@@ -852,7 +852,7 @@ Položka agentmemory je **stejný blok serveru MCP** na všech hostitelích, kte
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` zapne nástroje MCP. Přidejte `--with-hooks` pro nativní zachytávání zahrnuté v AgentMemory. Samostatný balíček pluginu není potřeba. [DSH](../docs/dsh.md). |
| **Goose** | UI nastavení MCP v Goose | Stejný blok `mcpServers`; použijte `goose configure` → Add Extension → MCP. Přímá úprava YAML v `~/.config/goose/config.yaml` je podporována, ale schéma používá `extensions:` + `cmd` (ne `mcpServers:` + `command`). |
| **Aider** | n/a | Použijte [autentizované REST příklady](#validate-a-fresh-install-and-restart-persistence) pro ukládání a vyhledávání ze skriptů. |
-| **Jakýkoli agent (32+)** | n/a | `npx skillkit install agentmemory` automaticky detekuje hostitele a sloučí konfiguraci. |
+| **Podporovaní agenti** | Pouze skills | `npx skills add rohitg00/agentmemory`; vyberte skills a agenty, pro které je chcete nainstalovat. |
**Sandboxovaní klienti MCP** (Flatpak / Snap / omezující kontejnery), kteří se nedostanou na `localhost` hostitele: navíc nastavte `"AGENTMEMORY_FORCE_PROXY": "1"` v bloku `env` a nasměrujte `AGENTMEMORY_URL` na cestu, na kterou se sandbox skutečně dostane (např. vaši LAN IP adresu).
diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md
index 3453b4a4..13dced17 100644
--- a/READMEs/README.da-DK.md
+++ b/READMEs/README.da-DK.md
@@ -844,7 +844,7 @@ agentmemory-indgangen er den **samme MCP-serverblok** på alle hosts, der bruger
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` aktiverer MCP-værktøjer. Tilføj `--with-hooks` for at indlæse det native registreringsplugin, der følger med AgentMemory. Ingen separat pluginpakke er nødvendig. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP-indstillings-UI | Samme `mcpServers`-blok; brug `goose configure` → Add Extension → MCP. Direkte YAML-redigering i `~/.config/goose/config.yaml` understøttes, men skemaet bruger `extensions:` + `cmd` (ikke `mcpServers:` + `command`). |
| **Aider** | n/a | Brug de [autentificerede REST-eksempler](#validate-a-fresh-install-and-restart-persistence) til at gemme og søge i hukommelsen fra scripts. |
-| **Enhver agent (32+)** | n/a | `npx skillkit install agentmemory` opdager automatisk hosten og sammenføjer. |
+| **Understøttede agenter** | Kun skills | `npx skills add rohitg00/agentmemory`; vælg de skills og agenter, du vil installere dem til. |
**Sandboxede MCP-klienter** (Flatpak/Snap/restriktive containere), der ikke kan nå hostens `localhost`: sæt også `"AGENTMEMORY_FORCE_PROXY": "1"` i `env`-blokken, og peg `AGENTMEMORY_URL` på en rute, sandboxen faktisk kan nå (f.eks. din LAN-IP).
diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md
index 60de1d5a..16413332 100644
--- a/READMEs/README.de-DE.md
+++ b/READMEs/README.de-DE.md
@@ -842,7 +842,7 @@ Der agentmemory-Eintrag ist der **gleiche MCP-Server-Block** für jeden Host, de
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` aktiviert MCP-Werkzeuge. Mit `--with-hooks` wird das in AgentMemory enthaltene native Erfassungsplugin geladen. Kein separates Pluginpaket erforderlich. [DSH](../docs/dsh.md). |
| **Goose** | Goose-MCP-Einstellungen-UI | Gleicher `mcpServers`-Block; nutzen Sie `goose configure` → Add Extension → MCP. Direktes YAML-Editieren unter `~/.config/goose/config.yaml` wird unterstützt, aber das Schema verwendet `extensions:` + `cmd` (nicht `mcpServers:` + `command`). |
| **Aider** | n/v | Nutzen Sie die [authentifizierten REST-Beispiele](#validate-a-fresh-install-and-restart-persistence), um Erinnerungen aus Skripten zu speichern und zu suchen. |
-| **Jeder Agent (32+)** | n/v | `npx skillkit install agentmemory` erkennt den Host automatisch und merged. |
+| **Unterstützte Agenten** | Nur Skills | `npx skills add rohitg00/agentmemory`; wählen Sie die Skills und die Agenten aus, für die sie installiert werden sollen. |
**MCP-Clients in Sandboxen** (Flatpak / Snap / restriktive Container), die den `localhost` des Hosts nicht erreichen können: Setzen Sie zusätzlich `"AGENTMEMORY_FORCE_PROXY": "1"` im `env`-Block und lassen Sie `AGENTMEMORY_URL` auf eine Route zeigen, die die Sandbox tatsächlich erreichen kann (z. B. Ihre LAN-IP).
diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md
index d3565706..fa2254a8 100644
--- a/READMEs/README.el-GR.md
+++ b/READMEs/README.el-GR.md
@@ -852,7 +852,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | Το `agentmemory connect dsh` ενεργοποιεί τα εργαλεία MCP. Προσθέστε `--with-hooks` για το εγγενές πρόσθετο καταγραφής που περιλαμβάνεται στο AgentMemory. Δεν χρειάζεται ξεχωριστό πακέτο. [DSH](../docs/dsh.md). |
| **Goose** | Settings UI MCP του Goose | Το ίδιο block `mcpServers`· χρησιμοποιήστε `goose configure` → Add Extension → MCP. Υποστηρίζεται άμεση επεξεργασία YAML στο `~/.config/goose/config.yaml`, αλλά το σχήμα χρησιμοποιεί `extensions:` + `cmd` (όχι `mcpServers:` + `command`). |
| **Aider** | n/a | Χρησιμοποιήστε τα [αυθεντικοποιημένα παραδείγματα REST](#validate-a-fresh-install-and-restart-persistence) για αποθήκευση και αναζήτηση από scripts. |
-| **Οποιοσδήποτε agent (32+)** | n/a | Το `npx skillkit install agentmemory` ανιχνεύει αυτόματα τον host και συγχωνεύει. |
+| **Υποστηριζόμενοι agents** | Μόνο skills | `npx skills add rohitg00/agentmemory`; επιλέξτε τα skills και τους agents στους οποίους θα εγκατασταθούν. |
**Sandboxed MCP clients** (Flatpak / Snap / περιορισμένα containers) που δεν μπορούν να φτάσουν το `localhost` του host: ρυθμίστε επίσης `"AGENTMEMORY_FORCE_PROXY": "1"` στο block `env`, και δείξτε το `AGENTMEMORY_URL` σε μια διαδρομή που το sandbox μπορεί πράγματι να φτάσει (π.χ. η IP του LAN σας).
diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md
index 4bd12424..a18cec0e 100644
--- a/READMEs/README.es-ES.md
+++ b/READMEs/README.es-ES.md
@@ -844,7 +844,7 @@ La entrada de agentmemory es el **mismo bloque de servidor MCP** en todos los ho
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` activa las herramientas MCP. Añade `--with-hooks` para cargar el complemento nativo de captura incluido en AgentMemory. No requiere un paquete adicional. [DSH](../docs/dsh.md). |
| **Goose** | UI de ajustes MCP de Goose | El mismo bloque `mcpServers`; usa `goose configure` → Add Extension → MCP. La edición directa del YAML en `~/.config/goose/config.yaml` está soportada, pero el schema usa `extensions:` + `cmd` (no `mcpServers:` + `command`). |
| **Aider** | n/a | Usa los [ejemplos REST autenticados](#validate-a-fresh-install-and-restart-persistence) para guardar y buscar recuerdos desde scripts. |
-| **Cualquier agente (32+)** | n/a | `npx skillkit install agentmemory` autodetecta el host y fusiona. |
+| **Agentes compatibles** | Solo skills | `npx skills add rohitg00/agentmemory`; elige las skills y los agentes donde instalarlas. |
**Clientes MCP en sandbox** (Flatpak / Snap / contenedores restrictivos) que no pueden alcanzar el `localhost` del host: añade también `"AGENTMEMORY_FORCE_PROXY": "1"` en el bloque `env`, y apunta `AGENTMEMORY_URL` a una ruta a la que el sandbox sí pueda llegar (p. ej. tu IP de LAN).
diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md
index dc8e0b20..02dab56f 100644
--- a/READMEs/README.fi-FI.md
+++ b/READMEs/README.fi-FI.md
@@ -852,7 +852,7 @@ agentmemory-merkintä on **sama MCP-palvelinlohko** jokaisessa isännässä, jok
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` ottaa MCP-työkalut käyttöön. Lisää `--with-hooks` ladataksesi AgentMemoryn mukana tulevan natiivin tallennuslisäosan. Erillistä lisäosapakettia ei tarvita. [DSH](../docs/dsh.md). |
| **Goose** | Goosen MCP-asetuskäyttöliittymä | Sama `mcpServers`-lohko; käytä `goose configure` → Add Extension → MCP. Suora YAML-muokkaus polussa `~/.config/goose/config.yaml` on tuettu, mutta skeema käyttää `extensions:` + `cmd` (ei `mcpServers:` + `command`). |
| **Aider** | ei saatavilla | Käytä [autentikoituja REST-esimerkkejä](#validate-a-fresh-install-and-restart-persistence) tallentamiseen ja hakemiseen skripteistä. |
-| **Mikä tahansa agentti (32+)** | ei saatavilla | `npx skillkit install agentmemory` tunnistaa isännän automaattisesti ja yhdistää. |
+| **Tuetut agentit** | Vain taidot | `npx skills add rohitg00/agentmemory`; valitse asennettavat taidot ja kohdeagentit. |
**Hiekkalaatikoidut MCP-asiakkaat** (Flatpak / Snap / rajoittavat kontit), jotka eivät tavoita isännän `localhost`-osoitetta: aseta lisäksi `"AGENTMEMORY_FORCE_PROXY": "1"` `env`-lohkoon, ja osoita `AGENTMEMORY_URL` reitille, jonka hiekkalaatikko oikeasti tavoittaa (esim. LAN-IP-osoitteesi).
diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md
index 2b5739ad..c0ef2f9d 100644
--- a/READMEs/README.fr-FR.md
+++ b/READMEs/README.fr-FR.md
@@ -844,7 +844,7 @@ L'entrée agentmemory est le **même bloc de serveur MCP** sur tous les hôtes q
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` active les outils MCP. Ajoutez `--with-hooks` pour charger le plugin natif de capture inclus dans AgentMemory. Aucun paquet supplémentaire requis. [DSH](../docs/dsh.md). |
| **Goose** | UI des paramètres MCP de Goose | Même bloc `mcpServers` ; utilisez `goose configure` → Add Extension → MCP. L'édition YAML directe sur `~/.config/goose/config.yaml` est prise en charge mais le schéma utilise `extensions:` + `cmd` (pas `mcpServers:` + `command`). |
| **Aider** | n/a | Utilisez les [exemples REST authentifiés](#validate-a-fresh-install-and-restart-persistence) pour enregistrer et rechercher des souvenirs depuis vos scripts. |
-| **Tout agent (32+)** | n/a | `npx skillkit install agentmemory` détecte automatiquement l'hôte et fusionne. |
+| **Agents pris en charge** | Skills uniquement | `npx skills add rohitg00/agentmemory`; choisissez les skills et les agents cibles. |
**Clients MCP sandboxés** (Flatpak / Snap / conteneurs restrictifs) qui ne peuvent pas atteindre le `localhost` de l'hôte : définissez aussi `"AGENTMEMORY_FORCE_PROXY": "1"` dans le bloc `env`, et pointez `AGENTMEMORY_URL` vers une route que le sandbox peut réellement atteindre (par ex. votre IP LAN).
diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md
index d72a99a4..4eb23cb2 100644
--- a/READMEs/README.he-IL.md
+++ b/READMEs/README.he-IL.md
@@ -854,7 +854,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` מפעיל את כלי MCP. הוסיפו `--with-hooks` כדי לטעון את תוסף הלכידה המובנה ב-AgentMemory. אין צורך בחבילת תוסף נפרדת. [DSH](../docs/dsh.md). |
| **Goose** | ממשק הגדרות MCP של Goose | אותו בלוק `mcpServers`; השתמשו ב-`goose configure` → Add Extension → MCP. עריכה ישירה של YAML ב-`~/.config/goose/config.yaml` נתמכת אבל ה-schema משתמש ב-`extensions:` + `cmd` (לא `mcpServers:` + `command`). |
| **Aider** | n/a | השתמשו ב[דוגמאות REST עם אימות](#validate-a-fresh-install-and-restart-persistence) לשמירה ולחיפוש מתוך סקריפטים. |
-| **כל סוכן (32+)** | n/a | `npx skillkit install agentmemory` מגלה אוטומטית את ה-host וממזג. |
+| **סוכנים נתמכים** | skills בלבד | `npx skills add rohitg00/agentmemory`; בחרו את ה-skills ואת הסוכנים שבהם יותקנו. |
**לקוחות MCP ב-sandbox** (Flatpak / Snap / containers מגבילים) שלא יכולים להגיע ל-`localhost` של ה-host: הגדירו גם `"AGENTMEMORY_FORCE_PROXY": "1"` בבלוק ה-`env`, והפנו את `AGENTMEMORY_URL` למסלול שה-sandbox יכול בפועל להגיע אליו (למשל כתובת ה-LAN שלכם).
diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md
index 13f86ed8..5963fa93 100644
--- a/READMEs/README.hi-IN.md
+++ b/READMEs/README.hi-IN.md
@@ -845,7 +845,7 @@ agentmemory entry, `mcpServers` shape का उपयोग करने वा
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` MCP टूल चालू करता है। AgentMemory में शामिल नेटिव कैप्चर प्लगइन लोड करने के लिए `--with-hooks` जोड़ें। अलग प्लगइन पैकेज की ज़रूरत नहीं है। [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP settings UI | वही `mcpServers` block; `goose configure` → Add Extension → MCP का उपयोग करें। `~/.config/goose/config.yaml` पर direct YAML edit supported है लेकिन schema `extensions:` + `cmd` का उपयोग करता है (`mcpServers:` + `command` नहीं)। |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **कोई भी एजेंट (32+)** | n/a | `npx skillkit install agentmemory` host को auto-detect करता है और merge करता है। |
+| **समर्थित एजेंट** | केवल skills | `npx skills add rohitg00/agentmemory`; इंस्टॉल करने वाले skills और लक्षित एजेंट चुनें। |
**Sandboxed MCP क्लाइंट्स** (Flatpak / Snap / प्रतिबंधात्मक containers) जो host के `localhost` तक नहीं पहुँच सकते: `env` block में `"AGENTMEMORY_FORCE_PROXY": "1"` भी set करें, और `AGENTMEMORY_URL` को एक ऐसे route पर point करें जिस तक sandbox वास्तव में पहुँच सकता है (जैसे आपका LAN IP)।
diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md
index 892a1a4d..fc2ae766 100644
--- a/READMEs/README.hu-HU.md
+++ b/READMEs/README.hu-HU.md
@@ -850,7 +850,7 @@ Az agentmemory bejegyzés **ugyanaz az MCP szerver blokk** minden olyan hoszton,
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | Az `agentmemory connect dsh` bekapcsolja az MCP-eszközöket. A `--with-hooks` betölti az AgentMemoryhoz mellékelt natív rögzítőbővítményt. Külön bővítménycsomag nem szükséges. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP beállítások felhasználói felülete | Ugyanaz a `mcpServers` blokk; használd a `goose configure` → Add Extension → MCP menüt. A közvetlen YAML-szerkesztés a `~/.config/goose/config.yaml`-ban is támogatott, de a séma `extensions:` + `cmd`-t használ (nem `mcpServers:` + `command`-ot). |
| **Aider** | n/a | Szkriptekből a [hitelesített REST-példákkal](#validate-a-fresh-install-and-restart-persistence) tárolhatsz és kereshetsz. |
-| **Bármely ágens (32+)** | n/a | Az `npx skillkit install agentmemory` automatikusan felismeri a hosztot, és beolvaszt. |
+| **Támogatott ágensek** | Csak skillek | `npx skills add rohitg00/agentmemory`; válassza ki a telepítendő skilleket és a célágenseket. |
**Sandboxolt MCP kliensek** (Flatpak / Snap / korlátozó konténerek), amelyek nem érik el a hoszt `localhost`-ját: állítsd be a `"AGENTMEMORY_FORCE_PROXY": "1"`-et is az `env` blokkban, és az `AGENTMEMORY_URL`-t irányítsd egy olyan útvonalra, amit a sandbox valóban elér (pl. a LAN-IP-d).
diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md
index 02da4592..1de7ed80 100644
--- a/READMEs/README.id-ID.md
+++ b/READMEs/README.id-ID.md
@@ -845,7 +845,7 @@ Entri agentmemory adalah **blok server MCP yang sama** di setiap host yang memak
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` mengaktifkan alat MCP. Tambahkan `--with-hooks` untuk memuat plugin perekaman native yang disertakan dalam AgentMemory. Tidak perlu paket plugin terpisah. [DSH](../docs/dsh.md). |
| **Goose** | Settings UI MCP Goose | Blok `mcpServers` yang sama; gunakan `goose configure` → Add Extension → MCP. Edit YAML langsung di `~/.config/goose/config.yaml` juga didukung tapi skemanya memakai `extensions:` + `cmd` (bukan `mcpServers:` + `command`). |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **Agen apa pun (32+)** | n/a | `npx skillkit install agentmemory` auto-detect host dan menggabungkannya. |
+| **Agen yang didukung** | Hanya skill | `npx skills add rohitg00/agentmemory`; pilih skill dan agen tujuan pemasangannya. |
**Klien MCP yang di-sandbox** (Flatpak / Snap / kontainer restriktif) yang tidak bisa menjangkau `localhost` milik host: set juga `"AGENTMEMORY_FORCE_PROXY": "1"` di blok `env`, dan arahkan `AGENTMEMORY_URL` ke rute yang benar-benar bisa dijangkau sandbox (misalnya IP LAN Anda).
diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md
index 56f218d1..3e3fa649 100644
--- a/READMEs/README.it-IT.md
+++ b/READMEs/README.it-IT.md
@@ -844,7 +844,7 @@ La voce agentmemory è lo **stesso blocco server MCP** su ogni host che usa la f
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` abilita gli strumenti MCP. Aggiungi `--with-hooks` per caricare il plugin nativo di acquisizione incluso in AgentMemory. Non serve un pacchetto aggiuntivo. [DSH](../docs/dsh.md). |
| **Goose** | UI delle impostazioni MCP di Goose | Stesso blocco `mcpServers`; usa `goose configure` → Add Extension → MCP. La modifica diretta del YAML in `~/.config/goose/config.yaml` è supportata ma lo schema usa `extensions:` + `cmd` (non `mcpServers:` + `command`). |
| **Aider** | n/d | Usa gli [esempi REST autenticati](#validate-a-fresh-install-and-restart-persistence) per salvare e cercare ricordi dagli script. |
-| **Qualsiasi agente (32+)** | n/d | `npx skillkit install agentmemory` rileva automaticamente l'host e unisce la configurazione. |
+| **Agenti supportati** | Solo skills | `npx skills add rohitg00/agentmemory`; scegli le skills e gli agenti in cui installarle. |
**Client MCP in sandbox** (Flatpak / Snap / container restrittivi) che non possono raggiungere il `localhost` dell'host: imposta anche `"AGENTMEMORY_FORCE_PROXY": "1"` nel blocco `env`, e punta `AGENTMEMORY_URL` verso una rotta che la sandbox possa effettivamente raggiungere (ad es. il tuo IP LAN).
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 8efadf42..12b8352c 100644
--- a/READMEs/README.ja-JP.md
+++ b/READMEs/README.ja-JP.md
@@ -845,7 +845,7 @@ agentmemory のエントリは、`mcpServers` の形式を使うすべてのホ
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` で MCP ツールを有効にします。`--with-hooks` を追加すると、AgentMemory 同梱のネイティブキャプチャプラグインを読み込みます。別のプラグインパッケージは不要です。 [DSH](../docs/dsh.md). |
| **Goose** | Goose の MCP 設定 UI | 同じ `mcpServers` ブロック。`goose configure` → Add Extension → MCP を使用。`~/.config/goose/config.yaml` の直接編集もサポートされていますが、スキーマは `mcpServers:` + `command` ではなく `extensions:` + `cmd` を使います。 |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **任意のエージェント(32+)** | n/a | `npx skillkit install agentmemory` がホストを自動検出してマージします。 |
+| **対応エージェント** | skills のみ | `npx skills add rohitg00/agentmemory`; インストールする skills と対象のエージェントを選択します。 |
ホストの `localhost` に到達できない**サンドボックス化された MCP クライアント**(Flatpak / Snap /制限の強いコンテナ)では、`env` ブロックに `"AGENTMEMORY_FORCE_PROXY": "1"` も設定し、`AGENTMEMORY_URL` をサンドボックスが実際に到達できるルート(例: あなたの LAN IP)に向けてください。
diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md
index 6ad3ce41..37e27d89 100644
--- a/READMEs/README.ko-KR.md
+++ b/READMEs/README.ko-KR.md
@@ -843,7 +843,7 @@ agentmemory 항목은 `mcpServers` 형태를 사용하는 모든 호스트(Curso
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh`는 MCP 도구를 활성화합니다. `--with-hooks`를 추가하면 AgentMemory에 포함된 네이티브 캡처 플러그인을 불러옵니다. 별도 플러그인 패키지는 필요하지 않습니다. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP 설정 UI | 동일한 `mcpServers` 블록. `goose configure` → Add Extension → MCP를 사용하십시오. `~/.config/goose/config.yaml`에서 직접 YAML을 편집할 수도 있지만, 스키마는 `mcpServers:` + `command`가 아니라 `extensions:` + `cmd`를 사용합니다. |
| **Aider** | 해당 없음 | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **모든 에이전트 (32+)** | 해당 없음 | `npx skillkit install agentmemory`가 호스트를 자동으로 감지해 병합합니다. |
+| **지원되는 에이전트** | skills만 설치 | `npx skills add rohitg00/agentmemory`; 설치할 skills와 대상 에이전트를 선택합니다. |
**샌드박스 MCP 클라이언트**(Flatpak / Snap / 제한적인 컨테이너)가 호스트의 `localhost`에 도달할 수 없는 경우: `env` 블록에 `"AGENTMEMORY_FORCE_PROXY": "1"`도 설정하고, `AGENTMEMORY_URL`을 샌드박스가 실제로 도달할 수 있는 경로(예: LAN IP)로 지정하십시오.
diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md
index 19ea33c0..b8bc28c5 100644
--- a/READMEs/README.nb-NO.md
+++ b/READMEs/README.nb-NO.md
@@ -842,7 +842,7 @@ agentmemory-oppføringen er **samme MCP-server-blokk** på tvers av alle verter
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` aktiverer MCP-verktøy. Legg til `--with-hooks` for å laste det native registreringstillegget som følger med AgentMemory. Ingen separat tilleggspakke er nødvendig. [DSH](../docs/dsh.md). |
| **Goose** | Gooses MCP-innstillings-UI | Samme `mcpServers`-blokk; bruk `goose configure` → Add Extension → MCP. Direkte YAML-redigering ved `~/.config/goose/config.yaml` er støttet, men skjemaet bruker `extensions:` + `cmd` (ikke `mcpServers:` + `command`). |
| **Aider** | n/a | Bruk de [autentiserte REST-eksemplene](#validate-a-fresh-install-and-restart-persistence) for å lagre og søke etter minner fra skript. |
-| **Enhver agent (32+)** | n/a | `npx skillkit install agentmemory` oppdager verten automatisk og slår sammen. |
+| **Støttede agenter** | Kun skills | `npx skills add rohitg00/agentmemory`; velg hvilke skills du vil installere, og hvilke agenter de skal installeres for. |
**Sandkasse-MCP-klienter** (Flatpak / Snap / restriktive containere) som ikke kan nå vertens `localhost`: sett også `"AGENTMEMORY_FORCE_PROXY": "1"` i `env`-blokken, og pek `AGENTMEMORY_URL` mot en rute sandkassen faktisk kan nå (f.eks. din LAN-IP).
diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md
index c5c5438d..864d483c 100644
--- a/READMEs/README.nl-NL.md
+++ b/READMEs/README.nl-NL.md
@@ -840,7 +840,7 @@ De agentmemory-entry is hetzelfde **MCP-serverblok** op elke host die de `mcpSer
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` activeert MCP-tools. Voeg `--with-hooks` toe voor de native registratieplugin die bij AgentMemory wordt geleverd. Er is geen apart pluginpakket nodig. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP-instellingen-UI | Hetzelfde `mcpServers`-blok; gebruik `goose configure` → Add Extension → MCP. Direct bewerken van de YAML op `~/.config/goose/config.yaml` wordt ondersteund, maar het schema gebruikt `extensions:` + `cmd` (niet `mcpServers:` + `command`). |
| **Aider** | n/a | Gebruik de [geauthenticeerde REST-voorbeelden](#validate-a-fresh-install-and-restart-persistence) om geheugen vanuit scripts op te slaan en te doorzoeken. |
-| **Elke agent (32+)** | n/a | `npx skillkit install agentmemory` detecteert automatisch de host en voegt samen. |
+| **Ondersteunde agents** | Alleen skills | `npx skills add rohitg00/agentmemory`; kies de skills en de agents waarvoor je ze wilt installeren. |
**Gesandboxte MCP-clients** (Flatpak / Snap / restrictieve containers) die de `localhost` van de host niet kunnen bereiken: stel ook `"AGENTMEMORY_FORCE_PROXY": "1"` in het `env`-blok in, en richt `AGENTMEMORY_URL` op een route die de sandbox daadwerkelijk kan bereiken (bijv. je LAN-IP).
diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md
index 939abce8..5bc50860 100644
--- a/READMEs/README.pl-PL.md
+++ b/READMEs/README.pl-PL.md
@@ -850,7 +850,7 @@ Wpis agentmemory to **ten sam blok serwera MCP** we wszystkich hostach, które u
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` włącza narzędzia MCP. Dodaj `--with-hooks`, aby załadować natywną wtyczkę rejestrowania dołączoną do AgentMemory. Osobny pakiet wtyczki nie jest potrzebny. [DSH](../docs/dsh.md). |
| **Goose** | Interfejs ustawień MCP w Goose | Ten sam blok `mcpServers`; użyj `goose configure` → Add Extension → MCP. Bezpośrednia edycja YAML w `~/.config/goose/config.yaml` jest wspierana, ale schemat używa `extensions:` + `cmd` (nie `mcpServers:` + `command`). |
| **Aider** | n/d | Do zapisu i wyszukiwania ze skryptów użyj [uwierzytelnionych przykładów REST](#validate-a-fresh-install-and-restart-persistence). |
-| **Każdy agent (32+)** | n/d | `npx skillkit install agentmemory` automatycznie wykrywa hosta i scala. |
+| **Obsługiwani agenci** | Tylko skille | `npx skills add rohitg00/agentmemory`; wybierz skille do zainstalowania oraz docelowych agentów. |
**Klienci MCP w sandboksie** (Flatpak / Snap / restrykcyjne kontenery), które nie mają dostępu do `localhost` hosta: ustaw dodatkowo `"AGENTMEMORY_FORCE_PROXY": "1"` w bloku `env` i wskaż `AGENTMEMORY_URL` na trasę, do której sandbox faktycznie ma dostęp (np. twój adres IP w sieci LAN).
diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md
index 775f920f..864862b6 100644
--- a/READMEs/README.pt-BR.md
+++ b/READMEs/README.pt-BR.md
@@ -842,7 +842,7 @@ A entrada do agentmemory é o **mesmo bloco de servidor MCP** em todo host que u
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` ativa as ferramentas MCP. Adicione `--with-hooks` para carregar o plugin nativo de captura incluído no AgentMemory. Não é necessário um pacote adicional. [DSH](../docs/dsh.md). |
| **Goose** | UI de configurações MCP do Goose | Mesmo bloco `mcpServers`; use `goose configure` → Add Extension → MCP. Edição direta do YAML em `~/.config/goose/config.yaml` é suportada, mas o schema usa `extensions:` + `cmd` (não `mcpServers:` + `command`). |
| **Aider** | n/a | Use os [exemplos REST autenticados](#validate-a-fresh-install-and-restart-persistence) para gravar e pesquisar memórias em scripts. |
-| **Qualquer agente (32+)** | n/a | `npx skillkit install agentmemory` autodetecta o host e mescla. |
+| **Agentes compatíveis** | Apenas skills | `npx skills add rohitg00/agentmemory`; escolha as skills e os agentes em que deseja instalá-las. |
**Clientes MCP em sandbox** (Flatpak / Snap / containers restritivos) que não conseguem alcançar o `localhost` do host: defina também `"AGENTMEMORY_FORCE_PROXY": "1"` no bloco `env`, e aponte `AGENTMEMORY_URL` para uma rota que o sandbox consiga de fato alcançar (por exemplo, o IP da sua LAN).
diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md
index 5b1837dc..1c280bcc 100644
--- a/READMEs/README.pt-PT.md
+++ b/READMEs/README.pt-PT.md
@@ -844,7 +844,7 @@ A entrada do agentmemory é o **mesmo bloco de servidor MCP** em todos os anfitr
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` ativa as ferramentas MCP. Adicione `--with-hooks` para carregar o plugin nativo de captura incluído no AgentMemory. Não é necessário um pacote adicional. [DSH](../docs/dsh.md). |
| **Goose** | Settings UI de MCP do Goose | Mesmo bloco `mcpServers`; use `goose configure` → Add Extension → MCP. A edição direta do YAML em `~/.config/goose/config.yaml` é suportada, mas o esquema usa `extensions:` + `cmd` (não `mcpServers:` + `command`). |
| **Aider** | n/a | Use os [exemplos REST autenticados](#validate-a-fresh-install-and-restart-persistence) para gravar e pesquisar memórias em scripts. |
-| **Qualquer agente (32+)** | n/a | `npx skillkit install agentmemory` deteta automaticamente o anfitrião e combina a configuração. |
+| **Agentes suportados** | Apenas skills | `npx skills add rohitg00/agentmemory`; escolha as skills e os agentes onde pretende instalá-las. |
**Clientes MCP em sandbox** (Flatpak / Snap / contentores restritivos) que não conseguem alcançar o `localhost` do anfitrião: defina também `"AGENTMEMORY_FORCE_PROXY": "1"` no bloco `env`, e aponte `AGENTMEMORY_URL` para uma rota que a sandbox consiga efetivamente alcançar (por exemplo, o seu IP de LAN).
diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md
index d9cb8940..b2401fe6 100644
--- a/READMEs/README.ro-RO.md
+++ b/READMEs/README.ro-RO.md
@@ -852,7 +852,7 @@ Intrarea agentmemory este **același bloc de server MCP** pe fiecare host care f
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` activează instrumentele MCP. Adăugați `--with-hooks` pentru pluginul nativ de captură inclus în AgentMemory. Nu este necesar un pachet separat. [DSH](../docs/dsh.md). |
| **Goose** | Interfața de setări MCP din Goose | Același bloc `mcpServers`; folosește `goose configure` → Add Extension → MCP. Editarea directă a YAML-ului la `~/.config/goose/config.yaml` este suportată, dar schema folosește `extensions:` + `cmd` (nu `mcpServers:` + `command`). |
| **Aider** | n/a | Folosește [exemplele REST autentificate](#validate-a-fresh-install-and-restart-persistence) pentru salvare și căutare din scripturi. |
-| **Orice agent (32+)** | n/a | `npx skillkit install agentmemory` detectează automat host-ul și îmbină configurația. |
+| **Agenți compatibili** | Doar skill-uri | `npx skills add rohitg00/agentmemory`; alege skill-urile de instalat și agenții țintă. |
**Clienții MCP sandbox-izați** (Flatpak / Snap / containere restrictive) care nu pot accesa `localhost`-ul host-ului: setează și `"AGENTMEMORY_FORCE_PROXY": "1"` în blocul `env` și direcționează `AGENTMEMORY_URL` către o rută pe care sandbox-ul o poate accesa efectiv (de ex. IP-ul tău din rețeaua locală).
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
index 8319979f..83bbaf21 100644
--- a/READMEs/README.ru-RU.md
+++ b/READMEs/README.ru-RU.md
@@ -852,7 +852,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` включает инструменты MCP. Добавьте `--with-hooks`, чтобы загрузить встроенный в AgentMemory плагин записи событий. Отдельный пакет плагина не нужен. [DSH](../docs/dsh.md). |
| **Goose** | UI настроек MCP в Goose | Тот же блок `mcpServers`; используйте `goose configure` → Add Extension → MCP. Прямое редактирование YAML в `~/.config/goose/config.yaml` поддерживается, но схема использует `extensions:` + `cmd` (а не `mcpServers:` + `command`). |
| **Aider** | н/д | Для сохранения и поиска из скриптов используйте [REST-примеры с авторизацией](#validate-a-fresh-install-and-restart-persistence). |
-| **Любой агент (32+)** | н/д | `npx skillkit install agentmemory` сам определит хост и сольёт настройки. |
+| **Поддерживаемые агенты** | Только skills | `npx skills add rohitg00/agentmemory`; выберите skills для установки и целевых агентов. |
**MCP-клиенты в sandbox** (Flatpak / Snap / ограничивающие контейнеры), которые не могут добраться до `localhost` хоста: дополнительно установите `"AGENTMEMORY_FORCE_PROXY": "1"` в блоке `env` и укажите `AGENTMEMORY_URL` на маршрут, до которого sandbox действительно может дотянуться (например, IP в локальной сети).
diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md
index 0b6266fc..3aa89988 100644
--- a/READMEs/README.sv-SE.md
+++ b/READMEs/README.sv-SE.md
@@ -844,7 +844,7 @@ agentmemory-posten är **samma MCP-serverblock** på alla värdar som använder
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` aktiverar MCP-verktyg. Lägg till `--with-hooks` för att läsa in det inbyggda registreringstillägget som följer med AgentMemory. Inget separat tilläggspaket behövs. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP-inställningsgränssnitt | Samma `mcpServers`-block; använd `goose configure` → Add Extension → MCP. Direkt YAML-redigering i `~/.config/goose/config.yaml` stöds, men schemat använder `extensions:` + `cmd` (inte `mcpServers:` + `command`). |
| **Aider** | n/a | Använd de [autentiserade REST-exemplen](#validate-a-fresh-install-and-restart-persistence) för att spara och söka efter minnen från skript. |
-| **Alla agenter (32+)** | n/a | `npx skillkit install agentmemory` upptäcker värden automatiskt och slår samman. |
+| **Agenter som stöds** | Endast skills | `npx skills add rohitg00/agentmemory`; välj vilka skills som ska installeras och för vilka agenter. |
**Sandboxade MCP-klienter** (Flatpak / Snap / restriktiva containrar) som inte kan nå värdens `localhost`: sätt även `"AGENTMEMORY_FORCE_PROXY": "1"` i `env`-blocket, och peka `AGENTMEMORY_URL` mot en väg som sandboxen faktiskt kan nå (t.ex. din LAN-IP).
diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md
index e92636f8..93b2dde0 100644
--- a/READMEs/README.th-TH.md
+++ b/READMEs/README.th-TH.md
@@ -835,7 +835,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` เปิดใช้งานเครื่องมือ MCP เพิ่ม `--with-hooks` เพื่อโหลดปลั๊กอินบันทึกแบบเนทีฟที่รวมอยู่ใน AgentMemory โดยไม่ต้องติดตั้งแพ็กเกจปลั๊กอินแยกต่างหาก [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP settings UI | ใช้ `mcpServers` block เดียวกัน; ใช้ `goose configure` → Add Extension → MCP การแก้ YAML ตรง ๆ ที่ `~/.config/goose/config.yaml` ก็รองรับ แต่ schema ใช้ `extensions:` + `cmd` (ไม่ใช่ `mcpServers:` + `command`) |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **Any agent (32+)** | n/a | `npx skillkit install agentmemory` จะตรวจจับ host อัตโนมัติและ merge ให้ |
+| **เอเจนต์ที่รองรับ** | เฉพาะ skills | `npx skills add rohitg00/agentmemory`; เลือก skills และเอเจนต์ปลายทางที่จะติดตั้ง |
**MCP client แบบ sandbox** (Flatpak / Snap / container ที่จำกัด) ที่เข้าถึง `localhost` ของ host ไม่ได้: ให้ตั้งค่า `"AGENTMEMORY_FORCE_PROXY": "1"` เพิ่มใน `env` block ด้วย และชี้ `AGENTMEMORY_URL` ไปยัง route ที่ sandbox เข้าถึงได้จริง (เช่น LAN IP ของคุณ)
diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md
index 996fb5de..4c8e2825 100644
--- a/READMEs/README.tl-PH.md
+++ b/READMEs/README.tl-PH.md
@@ -845,7 +845,7 @@ Ang entry ng agentmemory ay ang **parehong MCP server block** sa bawat host na g
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | Ina-activate ng `agentmemory connect dsh` ang mga MCP tool. Idagdag ang `--with-hooks` para i-load ang native capture plugin na kasama sa AgentMemory. Hindi kailangan ng hiwalay na plugin package. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP settings UI | Parehong `mcpServers` block; gamitin ang `goose configure` → Add Extension → MCP. Suportado ang direktang YAML edit sa `~/.config/goose/config.yaml` pero ang schema ay gumagamit ng `extensions:` + `cmd` (hindi `mcpServers:` + `command`). |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **Anumang agent (32+)** | n/a | Awtomatikong tinutuklas at pinagsasama ng `npx skillkit install agentmemory` ang host. |
+| **Mga suportadong agent** | Skills lamang | `npx skills add rohitg00/agentmemory`; piliin ang skills na ii-install at ang mga target na agent. |
**Mga sandboxed MCP client** (Flatpak / Snap / restrictive container) na hindi maabot ang `localhost` ng host: i-set din ang `"AGENTMEMORY_FORCE_PROXY": "1"` sa `env` block, at ituro ang `AGENTMEMORY_URL` sa isang route na talagang maabot ng sandbox (hal. ang LAN IP mo).
diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md
index 46a034c6..014dd3f7 100644
--- a/READMEs/README.tr-TR.md
+++ b/READMEs/README.tr-TR.md
@@ -852,7 +852,7 @@ agentmemory girdisi, `mcpServers` şeklini kullanan her host'ta (Cursor, Claude
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` MCP araçlarını etkinleştirir. AgentMemory ile gelen yerel kayıt eklentisini yüklemek için `--with-hooks` ekleyin. Ayrı bir eklenti paketi gerekmez. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP ayarları arayüzü | Aynı `mcpServers` bloğu; `goose configure` → Add Extension → MCP kullanın. `~/.config/goose/config.yaml`'da doğrudan YAML düzenleme desteklenir, ancak şema `extensions:` + `cmd` kullanır (`mcpServers:` + `command` değil). |
| **Aider** | yok | Betiklerden kaydetmek ve aramak için [kimlik doğrulamalı REST örneklerini](#validate-a-fresh-install-and-restart-persistence) kullanın. |
-| **Herhangi bir ajan (32+)** | yok | `npx skillkit install agentmemory`, host'u otomatik algılar ve birleştirir. |
+| **Desteklenen ajanlar** | Yalnızca beceriler | `npx skills add rohitg00/agentmemory`; yüklenecek becerileri ve hedef ajanları seçin. |
Host'un `localhost`'una erişemeyen **sandboxlanmış MCP istemcileri** (Flatpak / Snap / kısıtlayıcı container'lar) için: `env` bloğunda ayrıca `"AGENTMEMORY_FORCE_PROXY": "1"` ayarlayın ve `AGENTMEMORY_URL`'i sandbox'ın gerçekten erişebileceği bir rotaya (örn. LAN IP'niz) işaret edin.
diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md
index bc335531..1f142d48 100644
--- a/READMEs/README.uk-UA.md
+++ b/READMEs/README.uk-UA.md
@@ -852,7 +852,7 @@ npx skills add rohitg00/agentmemory -y -a '*' # install to every installed age
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` вмикає інструменти MCP. Додайте `--with-hooks`, щоб завантажити вбудований в AgentMemory плагін запису подій. Окремий пакет плагіна не потрібен. [DSH](../docs/dsh.md). |
| **Goose** | Інтерфейс налаштувань MCP Goose | Той самий блок `mcpServers`; скористайтеся `goose configure` → Add Extension → MCP. Пряме редагування YAML у `~/.config/goose/config.yaml` підтримується, але схема використовує `extensions:` + `cmd` (а не `mcpServers:` + `command`). |
| **Aider** | н/д | Для збереження й пошуку зі скриптів використовуйте [REST-приклади з автентифікацією](#validate-a-fresh-install-and-restart-persistence). |
-| **Будь-який агент (32+)** | н/д | `npx skillkit install agentmemory` автоматично визначає хост і об'єднує конфігурацію. |
+| **Підтримувані агенти** | Лише скіли | `npx skills add rohitg00/agentmemory`; виберіть скіли для встановлення та цільових агентів. |
**MCP-клієнти в sandbox** (Flatpak / Snap / обмежувальні контейнери), які не можуть дістатися `localhost` хоста: також встановіть `"AGENTMEMORY_FORCE_PROXY": "1"` у блоці `env` та вкажіть у `AGENTMEMORY_URL` маршрут, якого sandbox справді може досягти (наприклад, вашу IP-адресу в LAN).
diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md
index 19b50c6e..9ea6efaf 100644
--- a/READMEs/README.ur-PK.md
+++ b/READMEs/README.ur-PK.md
@@ -847,7 +847,7 @@ agentmemory کا entry ہر اس host پر **ایک ہی MCP سرور بلاک**
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` سے MCP ٹول فعال ہوتے ہیں۔ AgentMemory میں شامل مقامی کیپچر پلگ ان لوڈ کرنے کے لیے `--with-hooks` شامل کریں۔ الگ پلگ ان پیکیج کی ضرورت نہیں ہے۔ [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP settings UI | وہی `mcpServers` بلاک؛ `goose configure` → Add Extension → MCP استعمال کریں۔ `~/.config/goose/config.yaml` پر براہِ راست YAML ترمیم معاون ہے لیکن schema `extensions:` + `cmd` استعمال کرتا ہے (`mcpServers:` + `command` نہیں)۔ |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **کوئی بھی ایجنٹ (32+)** | n/a | `npx skillkit install agentmemory` host کو خودکار طور پر detect کرتا ہے اور ضم کرتا ہے۔ |
+| **معاونت یافتہ ایجنٹس** | صرف skills | `npx skills add rohitg00/agentmemory`; انسٹال کرنے کے لیے skills اور مطلوبہ ایجنٹس منتخب کریں۔ |
**Sandboxed MCP کلائنٹس** (Flatpak / Snap / restrictive containers) جو host کے `localhost` تک نہیں پہنچ سکتے: `env` بلاک میں `"AGENTMEMORY_FORCE_PROXY": "1"` بھی سیٹ کریں، اور `AGENTMEMORY_URL` کو کسی ایسے route کی طرف پوائنٹ کریں جہاں sandbox واقعی پہنچ سکے (مثلاً آپ کا LAN IP)۔
diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md
index 81de67dd..06aea9a2 100644
--- a/READMEs/README.vi-VN.md
+++ b/READMEs/README.vi-VN.md
@@ -845,7 +845,7 @@ Entry của agentmemory là **cùng một block MCP server** trên mọi host d
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` bật các công cụ MCP. Thêm `--with-hooks` để tải plugin ghi nhận sự kiện gốc đi kèm AgentMemory. Không cần gói plugin riêng. [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP settings UI | Cùng block `mcpServers`; dùng `goose configure` → Add Extension → MCP. Sửa YAML trực tiếp tại `~/.config/goose/config.yaml` cũng được hỗ trợ nhưng schema dùng `extensions:` + `cmd` (không phải `mcpServers:` + `command`). |
| **Aider** | n/a | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **Bất kỳ agent nào (32+)** | n/a | `npx skillkit install agentmemory` tự phát hiện host và gộp. |
+| **Các agent được hỗ trợ** | Chỉ cài skills | `npx skills add rohitg00/agentmemory`; chọn skills cần cài và các agent đích. |
**Các MCP client chạy trong sandbox** (Flatpak / Snap / container hạn chế) không thể chạm tới `localhost` của host: hãy đặt thêm `"AGENTMEMORY_FORCE_PROXY": "1"` trong block `env`, và chỉ `AGENTMEMORY_URL` tới một route mà sandbox thực sự chạm tới được (ví dụ IP LAN của bạn).
diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md
index 11ac5a0c..0941ab0d 100644
--- a/READMEs/README.zh-CN.md
+++ b/READMEs/README.zh-CN.md
@@ -845,7 +845,7 @@ Hermes、OpenClaw、Pi 和 Oh My Pi 的连接器默认安装原生集成和 skil
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` 启用 MCP 工具。添加 `--with-hooks` 可加载 AgentMemory 内置的原生捕获插件,无需额外的插件包。 [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP 设置界面 | 同样的 `mcpServers` 代码块;使用 `goose configure` → Add Extension → MCP。也支持直接编辑 `~/.config/goose/config.yaml`,但其 schema 用的是 `extensions:` + `cmd`(不是 `mcpServers:` + `command`)。 |
| **Aider** | 不适用 | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **任意代理(32+)** | 不适用 | `npx skillkit install agentmemory` 会自动检测宿主并合并配置。 |
+| **支持的代理** | 仅安装 skills | `npx skills add rohitg00/agentmemory`; 选择要安装的 skills 及目标代理。 |
**沙箱化的 MCP 客户端**(Flatpak / Snap / 限制性容器)如果无法访问宿主的 `localhost`:也在 `env` 代码块中设置 `"AGENTMEMORY_FORCE_PROXY": "1"`,并把 `AGENTMEMORY_URL` 指向沙箱真正能访问到的地址(例如你的局域网 IP)。
diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md
index c66b79bb..5a1c9029 100644
--- a/READMEs/README.zh-TW.md
+++ b/READMEs/README.zh-TW.md
@@ -843,7 +843,7 @@ Hermes、OpenClaw、Pi 和 Oh My Pi 的連接器預設安裝原生整合和 skil
| **DeepSeek Harness** | `$DSH_HOME/cordis.patch.yml` | `agentmemory connect dsh` 啟用 MCP 工具。加入 `--with-hooks` 可載入 AgentMemory 內建的原生擷取外掛程式,無需額外的外掛套件。 [DSH](../docs/dsh.md). |
| **Goose** | Goose MCP 設定介面 | 同樣的 `mcpServers` 區塊;使用 `goose configure` → Add Extension → MCP。也支援直接編輯 `~/.config/goose/config.yaml`,但其格式使用 `extensions:` + `cmd`(而非 `mcpServers:` + `command`)。 |
| **Aider** | 不適用 | [REST API](#validate-a-fresh-install-and-restart-persistence) |
-| **任何代理(32+)** | 不適用 | `npx skillkit install agentmemory` 會自動偵測宿主並合併設定。 |
+| **支援的代理** | 僅安裝 skills | `npx skills add rohitg00/agentmemory`; 選擇要安裝的 skills 及目標代理。 |
**沙箱化的 MCP 客戶端**(Flatpak / Snap / 限制較嚴格的容器)若無法連到宿主的 `localhost`:請在 `env` 區塊中也設定 `"AGENTMEMORY_FORCE_PROXY": "1"`,並讓 `AGENTMEMORY_URL` 指向沙箱實際能連到的路徑(例如你的 LAN IP)。
diff --git a/package.json b/package.json
index 3df4c8cc..7e20ad14 100644
--- a/package.json
+++ b/package.json
@@ -29,6 +29,7 @@
"test:vector-recovery:packaged": "node scripts/release-gate/vector-recovery.mjs",
"test:startup:packaged": "node scripts/release-gate/startup.mjs",
"test:summary-recovery:packaged": "node scripts/release-gate/summary-recovery.mjs",
+ "test:cli-diagnostics:packaged": "node scripts/release-gate/cli-diagnostics.mjs",
"test:graph-index:packaged": "node scripts/release-gate/graph-index.mjs",
"test:skills:packaged": "node scripts/release-gate/skills.mjs",
"test:openclaw:packaged": "node scripts/release-gate/openclaw.mjs",
diff --git a/scripts/docs-sync.state.json b/scripts/docs-sync.state.json
index 2693ada3..0538665c 100644
--- a/scripts/docs-sync.state.json
+++ b/scripts/docs-sync.state.json
@@ -26,7 +26,7 @@
"322"
],
"sourceFiles": [
- "253"
+ "254"
],
"loc": [
"58000"
diff --git a/scripts/release-gate/cli-diagnostics.mjs b/scripts/release-gate/cli-diagnostics.mjs
new file mode 100644
index 00000000..05c121ea
--- /dev/null
+++ b/scripts/release-gate/cli-diagnostics.mjs
@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import http from "node:http";
+import { arch, platform, tmpdir } from "node:os";
+import { delimiter, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assertCommandCompleted, assertSupportedPlatform, runCommand } from "./command.mjs";
+
+const repo = resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+const options = { tarball: null, out: null, dependencies: join(repo, "node_modules"), skipBuild: false, keep: false };
+for (let i = 2; i < process.argv.length; i++) {
+ const arg = process.argv[i];
+ if (["--tarball", "--out", "--dependencies"].includes(arg)) {
+ assert(process.argv[i + 1] && !process.argv[i + 1].startsWith("--"), `${arg} requires a path`);
+ options[arg.slice(2)] = resolve(process.argv[++i]);
+ } else if (arg === "--skip-build") options.skipBuild = true;
+ else if (arg === "--keep") options.keep = true;
+ else if (arg === "--help") {
+ console.log("Usage: node scripts/release-gate/cli-diagnostics.mjs [--tarball file.tgz] [--out empty-dir] [--dependencies node_modules] [--skip-build] [--keep]\nRuns the packed CLI's status and doctor against a loopback flags endpoint for each embeddingProvider shape. No engine, no model calls.");
+ process.exit(0);
+ } else throw new Error(`Unknown argument ${arg}`);
+}
+assertSupportedPlatform();
+if (options.out && existsSync(options.out)) assert.equal(readdirSync(options.out).length, 0, "--out must be empty; existing evidence is never overwritten");
+const out = options.out ?? mkdtempSync(join(tmpdir(), "agentmemory-cli-diagnostics-gate-"));
+mkdirSync(out, { recursive: true });
+const root = mkdtempSync(join(tmpdir(), "am-cli-diagnostics-"));
+const home = join(root, "home"), modules = join(root, "runtime/node_modules"), pkgDir = join(modules, "@agentmemory/agentmemory");
+const cli = join(pkgDir, "dist/cli.mjs");
+for (const directory of [home, pkgDir]) mkdirSync(directory, { recursive: true });
+const children = new Set(), results = [], artifact = {};
+const sha = (file) => createHash("sha256").update(readFileSync(file)).digest("hex");
+
+const CASES = [
+ { name: "provider description", flags: { embeddingProvider: "openrouter (1536 dims)" }, label: "openrouter (1536 dims)" },
+ { name: "padded provider", flags: { embeddingProvider: " local (384 dims) " }, label: "local (384 dims)" },
+ { name: "none", flags: { embeddingProvider: "none" }, label: null },
+ { name: "padded none", flags: { embeddingProvider: " none " }, label: null },
+ { name: "empty", flags: { embeddingProvider: "" }, label: null },
+ { name: "whitespace", flags: { embeddingProvider: " \t " }, label: null },
+ { name: "missing", flags: {}, label: null },
+ { name: "non-string", flags: { embeddingProvider: 1536 }, label: null },
+];
+let current = CASES[0];
+const server = http.createServer((request, response) => {
+ const path = new URL(request.url, "http://loopback").pathname;
+ const bodies = {
+ "/agentmemory/health": { status: "healthy", version: "gate", health: { memory: { heapUsed: 0 }, uptimeSeconds: 1 } },
+ "/agentmemory/sessions": { sessions: [] },
+ "/agentmemory/graph/stats": { totalNodes: 0, totalEdges: 0 },
+ "/agentmemory/memories": { latestCount: 0 },
+ "/agentmemory/diagnostics/followup": {},
+ "/agentmemory/config/flags": { provider: "llm", flags: [], ...current.flags },
+ };
+ const body = bodies[path];
+ response.writeHead(body ? 200 : 404, { "content-type": "application/json" });
+ response.end(JSON.stringify(body ?? { error: "not found" }));
+});
+
+function cleanEnv(url) {
+ return {
+ HOME: home, USERPROFILE: home, PATH: [dirname(process.execPath), "/usr/bin", "/bin"].join(delimiter),
+ TMPDIR: tmpdir(), CI: "1", NO_COLOR: "1", LANG: "C.UTF-8", III_TELEMETRY_ENABLED: "false", AGENTMEMORY_URL: url,
+ };
+}
+async function command(executable, args, { name, env = cleanEnv(""), cwd = root, timeoutMs = 90_000 }) {
+ const result = await runCommand(executable, args, { env, cwd, children, timeoutMs });
+ writeFileSync(join(out, `${name}.log`), result.output);
+ assertCommandCompleted(result);
+ assert.equal(result.code, 0, `${name}: ${result.output.slice(-3000)}`);
+ return result.output;
+}
+async function preparePackage() {
+ const dependencyRoot = realpathSync(options.dependencies);
+ let tarball = options.tarball;
+ if (!tarball) {
+ const npmEnv = { ...process.env, npm_config_cache: join(root, "npm-cache") };
+ if (!options.skipBuild) await command("npm", ["run", "build"], { cwd: repo, env: npmEnv, name: "build", timeoutMs: 600_000 });
+ const packDir = join(out, "pack"); mkdirSync(packDir);
+ await command("npm", ["pack", "--json", "--pack-destination", packDir], { cwd: repo, env: npmEnv, name: "pack" });
+ const archives = readdirSync(packDir).filter((name) => name.endsWith(".tgz"));
+ assert.equal(archives.length, 1, "npm pack must produce exactly one archive in the fresh output directory");
+ tarball = join(packDir, archives[0]);
+ }
+ artifact.tarball = tarball; artifact.tarballSha256 = sha(tarball);
+ await command("tar", ["-xzf", tarball, "--strip-components=1", "-C", pkgDir], { name: "extract" });
+ for (const entry of readdirSync(dependencyRoot, { withFileTypes: true })) {
+ if (entry.name.startsWith(".")) continue;
+ if (entry.name.startsWith("@")) {
+ const target = join(modules, entry.name); mkdirSync(target, { recursive: true });
+ for (const name of readdirSync(join(dependencyRoot, entry.name))) {
+ if (entry.name === "@agentmemory" && name === "agentmemory") continue;
+ symlinkSync(join(dependencyRoot, entry.name, name), join(target, name), "dir");
+ }
+ } else symlinkSync(join(dependencyRoot, entry.name), join(modules, entry.name), "dir");
+ }
+ artifact.version = JSON.parse(readFileSync(join(pkgDir, "package.json"), "utf8")).version;
+ artifact.cliSha256 = sha(cli);
+}
+
+try {
+ await preparePackage();
+ await new Promise((done) => server.listen(0, "127.0.0.1", done));
+ const url = `http://127.0.0.1:${server.address().port}`;
+ for (const entry of CASES) {
+ current = entry;
+ try {
+ const slug = entry.name.replace(/\s+/g, "-");
+ const status = await command(process.execPath, [cli, "status"], { name: `status-${slug}`, env: cleanEnv(url) });
+ const embeddings = status.split("\n").find((line) => line.includes("Embeddings:")) ?? "";
+ if (entry.label) assert(embeddings.includes(`✓ ${entry.label}`), `status must name the provider, got: ${embeddings}`);
+ else assert(embeddings.includes("bm25-only") && !embeddings.includes("✓"), `status must report bm25-only, got: ${embeddings}`);
+ const doctor = await command(process.execPath, [cli, "doctor", "--dry-run"], { name: `doctor-${slug}`, env: cleanEnv(url) });
+ const check = doctor.split("\n").find((line) => line.includes("Embedding provider")) ?? "";
+ assert(check.includes(entry.label ? "✓" : "✗"), `doctor must ${entry.label ? "pass" : "fail"} the embedding check, got: ${check}`);
+ results.push({ name: entry.name, status: "pass", statusLine: embeddings.trim(), doctorLine: check.trim() });
+ console.log(`PASS ${entry.name}`);
+ } catch (error) {
+ results.push({ name: entry.name, status: "fail", error: error.message });
+ console.log(`FAIL ${entry.name}: ${error.message}`);
+ }
+ }
+} catch (error) {
+ results.push({ name: "setup", status: "fail", error: error.stack });
+ console.log(`FAIL setup: ${error.message}`);
+} finally {
+ server.closeAllConnections?.();
+ if (server.listening) await new Promise((done) => server.close(done));
+ const passed = results.length === CASES.length && results.every((result) => result.status === "pass");
+ writeFileSync(join(out, "summary.json"), JSON.stringify({ passed, artifact, node: process.version, platform: `${platform()}-${arch()}`, scope: "Packed CLI rendering of synthetic loopback flags responses with cached dependency symlinks. Does not validate provider creation or API reporting. No engine or model.", results, runtimeRetained: options.keep ? root : null }, null, 2) + "\n");
+ if (!options.keep) rmSync(root, { recursive: true, force: true });
+ console.log(`${passed ? "PASS" : "FAIL"}: receipts ${out}`);
+ if (!passed) process.exitCode = 1;
+}
diff --git a/src/cli.ts b/src/cli.ts
index d0c85e03..d73e5d98 100644
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -55,6 +55,7 @@ import {
type RemoveOptions,
} from "./cli/remove-plan.js";
import { portFlagSuffix } from "./cli/ready-hint.js";
+import { embeddingStatusLabel } from "./cli/embedding-status.js";
import { expectedIiiSha256, iiiManualInstallCommand, installIiiArchive } from "./cli/engine-install.js";
import {
runtimeConfigPath,
@@ -1882,7 +1883,8 @@ async function runStatus() {
if (flagsRes) {
const provider = flagsRes.provider === "llm" ? pc.green("✓ llm") : pc.yellow("✗ noop (no key)");
- const embed = flagsRes.embeddingProvider === "embeddings" ? pc.green("✓ embeddings") : pc.dim("bm25-only");
+ const embedding = embeddingStatusLabel(flagsRes.embeddingProvider);
+ const embed = embedding ? pc.green(`✓ ${embedding}`) : pc.dim("bm25-only");
const flagRows = (flagsRes.flags || []).map((f: { key: string; enabled: boolean; label: string }) =>
` ${f.enabled ? pc.green("✓") : pc.dim("✗")} ${pc.bold(f.key.padEnd(32))} ${f.label}`
);
@@ -2175,7 +2177,7 @@ async function passiveServerChecks(): Promise<DoctorCheck[]> {
]);
const hasLlm = flags?.provider === "llm";
- const hasEmbed = flags?.embeddingProvider === "embeddings";
+ const hasEmbed = embeddingStatusLabel(flags?.embeddingProvider) !== null;
const graphNodeCount = graph?.available === false ? null : graph?.totalNodes ?? graph?.nodes ?? graph?.nodeCount ?? null;
const graphHas = typeof graphNodeCount === "number" && graphNodeCount > 0;
diff --git a/src/cli/embedding-status.ts b/src/cli/embedding-status.ts
new file mode 100644
index 00000000..95ff7f2b
--- /dev/null
+++ b/src/cli/embedding-status.ts
@@ -0,0 +1,5 @@
+export function embeddingStatusLabel(provider: unknown): string | null {
+ if (typeof provider !== "string") return null;
+ const value = provider.trim();
+ return value && value !== "none" ? value : null;
+}
diff --git a/src/triggers/api.ts b/src/triggers/api.ts
index 03dbbe9e..e7176ca9 100644
--- a/src/triggers/api.ts
+++ b/src/triggers/api.ts
@@ -69,7 +69,6 @@ import {
getConsolidationDecayDays,
isAutoCompressEnabled,
isContextInjectionEnabled,
- detectEmbeddingProvider,
describeLlmRoute,
detectLlmProviderKind,
getAgentId,
@@ -329,7 +328,7 @@ function sessionFacets(
function describeEmbeddingProvider(): string {
const active = getEmbeddingProvider();
if (active) return `${active.name} (${active.dimensions} dims)`;
- return detectEmbeddingProvider() ?? "none";
+ return "none";
}
const STATUS_CHECK_TIMEOUT_MS = 5000;
diff --git a/test/cli-embedding-status.test.ts b/test/cli-embedding-status.test.ts
new file mode 100644
index 00000000..671ad2ab
--- /dev/null
+++ b/test/cli-embedding-status.test.ts
@@ -0,0 +1,13 @@
+import { describe, it, expect } from "vitest";
+import { embeddingStatusLabel } from "../src/cli/embedding-status.js";
+
+describe("agentmemory status embeddings line", () => {
+ it("shows the provider the server reports", () => {
+ expect(embeddingStatusLabel("openrouter (1536 dims)")).toBe("openrouter (1536 dims)");
+ expect(embeddingStatusLabel(" local (384 dims) ")).toBe("local (384 dims)");
+ });
+
+ it.each([["none"], [" none "], [""], [" \t "], [undefined], [null], [42]])("falls back to bm25-only for %j", (value) => {
+ expect(embeddingStatusLabel(value)).toBeNull();
+ });
+});
diff --git a/test/embedding-status-api.test.ts b/test/embedding-status-api.test.ts
new file mode 100644
index 00000000..7fbdcecd
--- /dev/null
+++ b/test/embedding-status-api.test.ts
@@ -0,0 +1,84 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { randomUUID } from "node:crypto";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import type { HttpRequest } from "@iii-dev/helpers/http";
+
+type Handler = (req: HttpRequest) => Promise<{ status_code: number; body: unknown }>;
+
+let createEmbeddingProvider: typeof import("../src/providers/embedding/index.js").createEmbeddingProvider;
+let setEmbeddingProvider: typeof import("../src/functions/search.js").setEmbeddingProvider;
+let handlers: Map<string, Handler>;
+
+beforeEach(async () => {
+ vi.resetModules();
+ vi.stubEnv("AGENTMEMORY_ENV_FILE", join(tmpdir(), `am-embedding-status-${randomUUID()}.env`));
+ for (const key of [
+ "EMBEDDING_PROVIDER", "GEMINI_API_KEY", "OPENAI_API_KEY",
+ "OPENAI_EMBEDDING_API_KEY", "VOYAGE_API_KEY", "COHERE_API_KEY", "OPENROUTER_API_KEY",
+ ]) vi.stubEnv(key, undefined);
+ ({ createEmbeddingProvider } = await import("../src/providers/embedding/index.js"));
+ ({ setEmbeddingProvider } = await import("../src/functions/search.js"));
+ const { registerApiTriggers } = await import("../src/triggers/api.js");
+ handlers = new Map();
+ const sdk = {
+ registerFunction: (id: string, handler: Handler) => handlers.set(id, handler),
+ registerTrigger: () => {},
+ trigger: async () => null,
+ };
+ const kv = { backend: "file", get: async () => null, list: async () => [] };
+ registerApiTriggers(sdk as never, kv as never);
+});
+
+afterEach(() => {
+ setEmbeddingProvider(null);
+ vi.unstubAllEnvs();
+});
+
+async function expectEmbeddingStatus(expected: string) {
+ const request = { method: "GET", headers: {}, query_params: {} } as HttpRequest;
+ const flags = await handlers.get("api::config-flags")!(request);
+ expect(flags.status_code).toBe(200);
+ expect.soft(flags.body).toMatchObject({ embeddingProvider: expected });
+ const status = await handlers.get("api::status")!(request);
+ expect(status.status_code).toBe(200);
+ expect.soft(status.body).toMatchObject({ provider: { embeddings: expected } });
+}
+
+describe("embedding provider API status", () => {
+ it("reports none when an unsupported setting creates no runtime provider", async () => {
+ vi.stubEnv("EMBEDDING_PROVIDER", "unsupported");
+ const provider = createEmbeddingProvider();
+ expect(provider).toBeNull();
+ setEmbeddingProvider(provider);
+ await expectEmbeddingStatus("none");
+ });
+
+ it("reports none when no embedding provider is configured", async () => {
+ const provider = createEmbeddingProvider();
+ expect(provider).toBeNull();
+ setEmbeddingProvider(provider);
+ await expectEmbeddingStatus("none");
+ });
+
+ it("reports the active provider and dimensions even if configuration changes", async () => {
+ vi.stubEnv("EMBEDDING_PROVIDER", "local");
+ setEmbeddingProvider(createEmbeddingProvider());
+ await expectEmbeddingStatus("local (384 dims)");
+ vi.stubEnv("EMBEDDING_PROVIDER", "unsupported");
+ await expectEmbeddingStatus("local (384 dims)");
+ });
+
+ it("stops reporting a configured provider after it is cleared", async () => {
+ vi.stubEnv("EMBEDDING_PROVIDER", "local");
+ setEmbeddingProvider(createEmbeddingProvider());
+ setEmbeddingProvider(null);
+ await expectEmbeddingStatus("none");
+ });
+
+ it("does not report a provider whose construction failed", async () => {
+ vi.stubEnv("EMBEDDING_PROVIDER", "openai");
+ expect(() => createEmbeddingProvider()).toThrow("API key is required");
+ await expectEmbeddingStatus("none");
+ });
+});