diff --git a/README.md b/README.md index 31ad6a5546..5b06660d45 100644 --- a/README.md +++ b/README.md @@ -474,7 +474,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code without the plugin install (MCP-standalone path) -If you wire agentmemory's MCP server through `~/.claude.json` directly instead of using `/plugin install`, Claude Code never resolves `${CLAUDE_PLUGIN_ROOT}` and you have to point hook scripts at absolute paths in `~/.claude/settings.json`. Those paths typically embed the agentmemory version (e.g. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), so the next upgrade silently breaks every hook. +If you wire agentmemory's MCP server directly through the default `~/.claude.json` file instead of using `/plugin install`, Claude Code never resolves `${CLAUDE_PLUGIN_ROOT}` and you have to point hook scripts at absolute paths in the default `~/.claude/settings.json` file. Those paths typically embed the agentmemory version (e.g. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), so the next upgrade silently breaks every hook. Workaround: @@ -482,7 +482,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -This merges the same hook commands into `~/.claude/settings.json` with absolute paths resolved to the bundled `plugin/` directory of the currently installed `@agentmemory/agentmemory` package. Re-run the command after upgrading agentmemory to refresh the paths. User entries in the same file are preserved; only previous agentmemory entries are replaced. Using the `/plugin install` path remains the recommended approach. +This command configures the MCP server and merges the bundled hooks into Claude Code’s user configuration. When `CLAUDE_CONFIG_DIR` is unset, empty, or whitespace-only, it uses `~/.claude.json` for MCP and `~/.claude/settings.json` for hooks. Other directory values are used exactly as provided, including leading and trailing whitespace. For a custom directory, set `CLAUDE_CONFIG_DIR` to the same non-empty value for this command and Claude Code; the files are then `$CLAUDE_CONFIG_DIR/.claude.json` and `$CLAUDE_CONFIG_DIR/settings.json`, respectively. Claude Code must receive this value in its launch environment, even if the connector reads it from AgentMemory’s `.env`. Create the custom directory before running this command; otherwise, the connector skips Claude Code as not detected. If the shell value is whitespace-only, unset `CLAUDE_CONFIG_DIR` before launching Claude Code so it also uses the default profile. Use an absolute path. Relative paths are resolved from the working directory, so both commands must run from the same directory. + +Hook commands use absolute paths to the installed package’s bundled `plugin/` directory. Re-run the command after upgrading agentmemory to refresh those paths. User entries in the configuration files are preserved; only previous agentmemory entries are replaced. Using `/plugin install` remains the recommended approach. For a remote server with the plugin, enter its `https://` URL and secret in the plugin settings that Claude Code asks for when you enable the plugin. The hooks and the bundled MCP server read both from there. With the URL setting empty, they use `AGENTMEMORY_URL` from your environment, then `http://localhost:3111`; with the secret setting empty, they send only the local server's own secret, and only to a loopback address. With `agentmemory connect claude-code` there are no plugin settings: set `AGENTMEMORY_URL` and `AGENTMEMORY_SECRET` in the environment that starts Claude Code. diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md index 13a79a42b6..78d9780860 100644 --- a/READMEs/README.ar-SA.md +++ b/READMEs/README.ar-SA.md @@ -448,7 +448,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code بدون تثبيت الإضافة (مسار MCP القائم بذاته) -إذا ربطت خادم MCP الخاص بـ agentmemory عبر `~/.claude.json` مباشرة بدلًا من استخدام `/plugin install`، فإن Claude Code لن يحلّ `${CLAUDE_PLUGIN_ROOT}` مطلقًا، وستحتاج إلى توجيه نصوص الخطافات إلى مسارات مطلقة في `~/.claude/settings.json`. وتُضمِّن تلك المسارات عادة إصدار agentmemory (مثل `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)، فتنكسر جميع الخطافات بصمت عند الترقية التالية. +إذا ربطت خادم MCP الخاص بـ agentmemory عبر `~/.claude.json` (المسار الافتراضي) مباشرة بدلًا من استخدام `/plugin install`، فإن Claude Code لن يحلّ `${CLAUDE_PLUGIN_ROOT}` مطلقًا، وستحتاج إلى توجيه نصوص الخطافات إلى مسارات مطلقة في `~/.claude/settings.json` (المسار الافتراضي). وتُضمِّن تلك المسارات عادة إصدار agentmemory (مثل `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)، فتنكسر جميع الخطافات بصمت عند الترقية التالية. الحل البديل: @@ -456,7 +456,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -يُدمج هذا الأمر نفس أوامر الخطافات في `~/.claude/settings.json` بمسارات مطلقة تُحلَّل إلى دليل `plugin/` المُضمَّن في حزمة `@agentmemory/agentmemory` المثبَّتة حاليًا. أعد تشغيل الأمر بعد ترقية agentmemory لتحديث المسارات. تُحفظ إدخالات المستخدم في نفس الملف؛ ويُستبدل إدخالات agentmemory السابقة فقط. يظل استخدام مسار `/plugin install` هو الأسلوب المُوصى به. +يضبط هذا الأمر خادم MCP ويدمج الخطافات المضمّنة في إعدادات مستخدم Claude Code. عندما لا يكون `CLAUDE_CONFIG_DIR` مضبوطًا أو تكون قيمته فارغة أو مؤلفة من مسافات بيضاء فقط، يستخدم `~/.claude.json` لإعدادات MCP و`~/.claude/settings.json` للخطافات. تُستخدم قيم الأدلة الأخرى كما هي تمامًا، بما في ذلك المسافات البيضاء في البداية والنهاية. لاستخدام دليل مخصص، اضبط `CLAUDE_CONFIG_DIR` على القيمة غير الفارغة نفسها عند تشغيل هذا الأمر وClaude Code؛ وعندها يكون الملفان `$CLAUDE_CONFIG_DIR/.claude.json` و`$CLAUDE_CONFIG_DIR/settings.json`، على الترتيب. يجب أن يتلقى Claude Code هذه القيمة في بيئة تشغيله، حتى إذا قرأها الموصل من ملف `.env` الخاص بـ AgentMemory. أنشئ الدليل المخصص قبل تشغيل هذا الأمر؛ وإلا فسيتجاوز الموصل Claude Code باعتباره غير مكتشف. إذا كانت قيمة المتغير في بيئة shell مؤلفة من مسافات بيضاء فقط، فألغِ تعيين `CLAUDE_CONFIG_DIR` قبل تشغيل Claude Code ليستخدم الإعدادات الافتراضية أيضًا. استخدم مسارًا مطلقًا. تُحل المسارات النسبية انطلاقًا من دليل العمل، لذا يجب تشغيل الأمرين من الدليل نفسه. + +تستخدم أوامر الخطافات مسارات مطلقة إلى دليل `plugin/` المضمّن في الحزمة المثبّتة. أعد تشغيل الأمر بعد ترقية agentmemory لتحديث تلك المسارات. تُحفظ إدخالات المستخدم في ملفات الإعدادات؛ ولا تُستبدل إلا إدخالات agentmemory السابقة. يظل استخدام `/plugin install` هو النهج الموصى به. بالنسبة للنشر عن بُعد أو المحمي، شغّل Claude Code مع ضبط `AGENTMEMORY_URL` و`AGENTMEMORY_SECRET`. تُمرّر الإضافة كلتا القيمتين إلى خادم MCP المُضمَّن بها؛ وعندما يكون `AGENTMEMORY_URL` فارغًا، يستخدم وسيط MCP (shim) عنوان `http://localhost:3111`. ### Codex CLI (منصة إضافات Codex) diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md index 98bcbaa9ce..b8b974530a 100644 --- a/READMEs/README.bn-BD.md +++ b/READMEs/README.bn-BD.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### প্লাগইন ইনস্টল ছাড়া Claude Code (MCP-স্ট্যান্ডঅ্যালোন পাথ) -আপনি `/plugin install` ব্যবহার না করে সরাসরি `~/.claude.json`-এর মাধ্যমে agentmemory-র MCP সার্ভার ওয়্যার করলে, Claude Code কখনো `${CLAUDE_PLUGIN_ROOT}` রিজলভ করে না এবং আপনাকে `~/.claude/settings.json`-এ হুক স্ক্রিপ্টগুলো অ্যাবসোলিউট পাথে পয়েন্ট করতে হয়। সেই পাথগুলোতে সাধারণত agentmemory-র ভার্সন এমবেড থাকে (যেমন `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), তাই পরের আপগ্রেড নিঃশব্দে প্রতিটি হুক ভেঙে দেয়। +আপনি `/plugin install` ব্যবহার না করে সরাসরি `~/.claude.json` (ডিফল্ট পথ)-এর মাধ্যমে agentmemory-র MCP সার্ভার ওয়্যার করলে, Claude Code কখনো `${CLAUDE_PLUGIN_ROOT}` রিজলভ করে না এবং আপনাকে `~/.claude/settings.json` (ডিফল্ট পথ)-এ হুক স্ক্রিপ্টগুলো অ্যাবসোলিউট পাথে পয়েন্ট করতে হয়। সেই পাথগুলোতে সাধারণত agentmemory-র ভার্সন এমবেড থাকে (যেমন `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), তাই পরের আপগ্রেড নিঃশব্দে প্রতিটি হুক ভেঙে দেয়। ওয়ার্কঅ্যারাউন্ড: @@ -452,7 +452,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -এটি একই হুক কমান্ডগুলো `~/.claude/settings.json`-এ মার্জ করে, বর্তমানে ইনস্টল করা `@agentmemory/agentmemory` প্যাকেজের বান্ডলড `plugin/` ডিরেক্টরির অ্যাবসোলিউট পাথ দিয়ে। পাথ রিফ্রেশ করতে agentmemory আপগ্রেড করার পর কমান্ডটি আবার চালান। একই ফাইলের ইউজার এন্ট্রিগুলো রক্ষিত থাকে; শুধু আগের agentmemory এন্ট্রিগুলো রিপ্লেস হয়। `/plugin install` পাথটি এখনও সুপারিশকৃত পদ্ধতি। +এই কমান্ড MCP সার্ভার কনফিগার করে এবং সঙ্গে থাকা hook-গুলো Claude Code-এর ব্যবহারকারী কনফিগারেশনে যুক্ত করে। `CLAUDE_CONFIG_DIR` সেট করা না থাকলে, খালি থাকলে বা শুধু ফাঁকা অক্ষর থাকলে, এটি MCP-এর জন্য `~/.claude.json` এবং hook-এর জন্য `~/.claude/settings.json` ব্যবহার করে। অন্য ডিরেক্টরি মানগুলো শুরু ও শেষের ফাঁকা স্থানসহ হুবহু ব্যবহার করা হয়। কাস্টম ডিরেক্টরি ব্যবহার করতে এই কমান্ড এবং Claude Code উভয়ের জন্য `CLAUDE_CONFIG_DIR`-এ একই খালি নয় এমন মান সেট করুন; তখন ফাইল দুটি হবে যথাক্রমে `$CLAUDE_CONFIG_DIR/.claude.json` এবং `$CLAUDE_CONFIG_DIR/settings.json`। কানেক্টর AgentMemory-এর `.env` থেকে মানটি পড়লেও Claude Code চালু করার এনভায়রনমেন্টে এই মান থাকতে হবে। এই কমান্ড চালানোর আগে কাস্টম ডিরেক্টরি তৈরি করুন; না থাকলে কানেক্টর Claude Code-কে শনাক্ত করতে না পেরে এড়িয়ে যাবে। Shell-এর মানে শুধু ফাঁকা অক্ষর থাকলে, Claude Code চালুর আগে `CLAUDE_CONFIG_DIR` আনসেট করুন, যাতে সেটিও ডিফল্ট প্রোফাইল ব্যবহার করে। একটি পরম পথ ব্যবহার করুন। আপেক্ষিক পথ কর্মরত ডিরেক্টরির ভিত্তিতে নির্ধারিত হয়, তাই উভয় কমান্ড একই ডিরেক্টরি থেকে চালাতে হবে। + +Hook কমান্ডগুলো ইনস্টল করা প্যাকেজের সঙ্গে থাকা `plugin/` ডিরেক্টরির অ্যাবসোলিউট পথ ব্যবহার করে। agentmemory আপগ্রেড করার পরে পথগুলো হালনাগাদ করতে কমান্ডটি আবার চালান। কনফিগারেশন ফাইলে ব্যবহারকারীর এন্ট্রিগুলো সংরক্ষিত থাকে; শুধু আগের agentmemory এন্ট্রিগুলো প্রতিস্থাপিত হয়। `/plugin install` ব্যবহার করাই সুপারিশকৃত পদ্ধতি। রিমোট বা প্রোটেক্টেড ডিপ্লয়মেন্টের জন্য, `AGENTMEMORY_URL` এবং `AGENTMEMORY_SECRET` সেট করে Claude Code লঞ্চ করুন। প্লাগইন দুটি ভ্যালুই তার বান্ডলড MCP সার্ভারে পাস করে; `AGENTMEMORY_URL` খালি থাকলে, MCP শিম `http://localhost:3111` ব্যবহার করে। ### Codex CLI (Codex প্লাগইন প্ল্যাটফর্ম) diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md index 5a64f8b08a..f0013ec701 100644 --- a/READMEs/README.cs-CZ.md +++ b/READMEs/README.cs-CZ.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code bez instalace pluginu (cesta MCP-standalone) -Pokud zapojíte server MCP agentmemory přímo přes `~/.claude.json` místo použití `/plugin install`, Claude Code nikdy nevyřeší `${CLAUDE_PLUGIN_ROOT}` a musíte nasměrovat skripty hooks na absolutní cesty v `~/.claude/settings.json`. Tyto cesty typicky obsahují verzi agentmemory (např. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), takže další upgrade tiše rozbije všechny hooks. +Pokud zapojíte server MCP agentmemory přímo přes `~/.claude.json` (výchozí cesta) místo použití `/plugin install`, Claude Code nikdy nevyřeší `${CLAUDE_PLUGIN_ROOT}` a musíte nasměrovat skripty hooks na absolutní cesty v `~/.claude/settings.json` (výchozí cesta). Tyto cesty typicky obsahují verzi agentmemory (např. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), takže další upgrade tiše rozbije všechny hooks. Řešení: @@ -454,7 +454,9 @@ Pokud zapojíte server MCP agentmemory přímo přes `~/.claude.json` místo pou agentmemory connect claude-code --with-hooks ``` -Toto sloučí stejné příkazy hooks do `~/.claude/settings.json` s absolutními cestami vyřešenými na balíčený adresář `plugin/` aktuálně nainstalovaného balíčku `@agentmemory/agentmemory`. Po upgradu agentmemory příkaz spusťte znovu, aby se cesty obnovily. Uživatelské položky ve stejném souboru zůstanou zachovány; nahrazeny jsou pouze předchozí položky agentmemory. Doporučovaným přístupem zůstává cesta přes `/plugin install`. +Tento příkaz nastaví server MCP a sloučí přibalené hooky do uživatelské konfigurace Claude Code. Pokud `CLAUDE_CONFIG_DIR` není nastavena, je prázdná nebo obsahuje pouze bílé znaky, použije pro MCP soubor `~/.claude.json` a pro hooky `~/.claude/settings.json`. Ostatní hodnoty adresáře se používají přesně tak, jak byly zadány, včetně úvodních a koncových bílých znaků. Chcete-li použít vlastní adresář, nastavte pro tento příkaz i Claude Code stejnou neprázdnou hodnotu `CLAUDE_CONFIG_DIR`; MCP pak použije `$CLAUDE_CONFIG_DIR/.claude.json` a hooky `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code musí tuto hodnotu obdržet ve svém spouštěcím prostředí, i když ji konektor načítá ze souboru `.env` AgentMemory. Vlastní adresář vytvořte před spuštěním tohoto příkazu; jinak konektor Claude Code nerozpozná a přeskočí jej. Pokud hodnota v shellu obsahuje pouze bílé znaky, před spuštěním Claude Code zrušte nastavení `CLAUDE_CONFIG_DIR`, aby také použil výchozí profil. Použijte absolutní cestu. Relativní cesty se vyhodnocují vůči pracovnímu adresáři, takže oba příkazy musí být spuštěny ze stejného adresáře. + +Příkazy hooků používají absolutní cesty do adresáře `plugin/` přibaleného v nainstalovaném balíčku. Po aktualizaci agentmemory spusťte příkaz znovu, aby se tyto cesty obnovily. Uživatelské položky v konfiguračních souborech zůstanou zachovány; nahradí se pouze předchozí položky agentmemory. Doporučeným postupem zůstává `/plugin install`. Pro vzdálená nebo chráněná nasazení spusťte Claude Code s nastaveným `AGENTMEMORY_URL` a `AGENTMEMORY_SECRET`. Plugin obě hodnoty předá svému zabalenému serveru MCP; když je `AGENTMEMORY_URL` prázdné, shim MCP použije `http://localhost:3111`. ### Codex CLI (platforma pluginů Codex) diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md index 2b4f540c29..87eaf80f35 100644 --- a/READMEs/README.da-DK.md +++ b/READMEs/README.da-DK.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code uden plugin-installation (MCP-standalone-vej) -Hvis du forbinder agentmemorys MCP-server via `~/.claude.json` direkte i stedet for at bruge `/plugin install`, opløser Claude Code aldrig `${CLAUDE_PLUGIN_ROOT}`, og du skal pege hook-scripts på absolutte paths i `~/.claude/settings.json`. Disse paths indeholder typisk agentmemory-versionen (f.eks. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så den næste opgradering stille og roligt bryder hver hook. +Hvis du forbinder agentmemorys MCP-server via `~/.claude.json` (standardsti) direkte i stedet for at bruge `/plugin install`, opløser Claude Code aldrig `${CLAUDE_PLUGIN_ROOT}`, og du skal pege hook-scripts på absolutte paths i `~/.claude/settings.json` (standardsti). Disse paths indeholder typisk agentmemory-versionen (f.eks. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så den næste opgradering stille og roligt bryder hver hook. Løsning: @@ -449,7 +449,9 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Dette sammenføjer de samme hook-kommandoer i `~/.claude/settings.json` med absolutte paths, der peger på den medfølgende `plugin/`-mappe i den aktuelt installerede `@agentmemory/agentmemory`-pakke. Kør kommandoen igen efter opgradering af agentmemory for at opdatere paths. Brugerens egne indgange i samme fil bevares; kun tidligere agentmemory-indgange udskiftes. At bruge `/plugin install`-vejen er stadig den anbefalede metode. +Denne kommando konfigurerer MCP-serveren og fletter de medfølgende hooks ind i Claude Codes brugerkonfiguration. Hvis `CLAUDE_CONFIG_DIR` ikke er sat, er tom eller kun indeholder blanktegn, bruges `~/.claude.json` til MCP og `~/.claude/settings.json` til hooks. Andre mappeværdier bruges præcis som angivet, inklusive indledende og afsluttende blanktegn. Hvis du vil bruge en brugerdefineret mappe, skal `CLAUDE_CONFIG_DIR` have den samme ikke-tomme værdi for både denne kommando og Claude Code; filerne bliver da henholdsvis `$CLAUDE_CONFIG_DIR/.claude.json` og `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code skal modtage værdien i sit startmiljø, selv hvis connectoren læser den fra AgentMemorys `.env`. Opret den brugerdefinerede mappe, før du kører kommandoen; ellers springer connectoren Claude Code over, fordi det ikke bliver fundet. Hvis værdien i shellen kun indeholder blanktegn, skal du fjerne `CLAUDE_CONFIG_DIR` fra miljøet, før du starter Claude Code, så det også bruger standardprofilen. Brug en absolut sti. Relative stier fortolkes ud fra arbejdsmappen, så begge kommandoer skal køres fra samme mappe. + +Hook-kommandoerne bruger absolutte stier til den installerede pakkes medfølgende `plugin/`-mappe. Kør kommandoen igen efter en opgradering af agentmemory for at opdatere stierne. Brugerens egne indgange i konfigurationsfilerne bevares; kun tidligere agentmemory-indgange erstattes. Det anbefales fortsat at bruge `/plugin install`. Til eksterne eller beskyttede deployments, start Claude Code med `AGENTMEMORY_URL` og `AGENTMEMORY_SECRET` sat. Pluginet sender begge værdier videre til sin medfølgende MCP-server; når `AGENTMEMORY_URL` er tom, bruger MCP-shimmen `http://localhost:3111`. ### Codex CLI (Codex-plugin-platform) diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md index f4053424a3..cb790134e8 100644 --- a/READMEs/README.de-DE.md +++ b/READMEs/README.de-DE.md @@ -439,7 +439,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code ohne Plugin-Installation (MCP-Standalone-Pfad) -Wenn Sie den MCP-Server von agentmemory direkt über `~/.claude.json` verdrahten anstatt über `/plugin install`, löst Claude Code `${CLAUDE_PLUGIN_ROOT}` niemals auf, und Sie müssen Hook-Skripte in `~/.claude/settings.json` auf absolute Pfade zeigen lassen. Diese Pfade enthalten typischerweise die agentmemory-Version (z. B. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), sodass das nächste Upgrade jeden Hook stillschweigend bricht. +Wenn Sie den MCP-Server von agentmemory direkt über `~/.claude.json` (Standardpfad) verdrahten anstatt über `/plugin install`, löst Claude Code `${CLAUDE_PLUGIN_ROOT}` niemals auf, und Sie müssen Hook-Skripte in `~/.claude/settings.json` (Standardpfad) auf absolute Pfade zeigen lassen. Diese Pfade enthalten typischerweise die agentmemory-Version (z. B. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), sodass das nächste Upgrade jeden Hook stillschweigend bricht. Workaround: @@ -447,7 +447,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -Das mischt dieselben Hook-Befehle in `~/.claude/settings.json` ein, mit absoluten Pfaden, die in das mitgelieferte `plugin/`-Verzeichnis des aktuell installierten `@agentmemory/agentmemory`-Pakets auflösen. Führen Sie den Befehl nach einem agentmemory-Upgrade erneut aus, um die Pfade zu aktualisieren. Eigene Einträge in derselben Datei bleiben erhalten; nur frühere agentmemory-Einträge werden ersetzt. Den `/plugin install`-Pfad zu nutzen, bleibt der empfohlene Ansatz. +Dieser Befehl konfiguriert den MCP-Server und fügt die mitgelieferten Hooks zur Benutzerkonfiguration von Claude Code hinzu. Wenn `CLAUDE_CONFIG_DIR` nicht gesetzt oder leer ist oder nur Leerraum enthält, verwendet er `~/.claude.json` für MCP und `~/.claude/settings.json` für Hooks. Andere Verzeichniswerte werden unverändert verwendet, einschließlich Leerraum am Anfang und Ende. Für ein benutzerdefiniertes Verzeichnis muss `CLAUDE_CONFIG_DIR` für diesen Befehl und Claude Code denselben nicht leeren Wert haben; die Dateien sind dann `$CLAUDE_CONFIG_DIR/.claude.json` für MCP und `$CLAUDE_CONFIG_DIR/settings.json` für Hooks. Claude Code muss diesen Wert in seiner Startumgebung erhalten, auch wenn der Connector ihn aus der `.env` von AgentMemory liest. Erstellen Sie das benutzerdefinierte Verzeichnis vor dem Ausführen dieses Befehls; andernfalls wird Claude Code als nicht erkannt übersprungen. Wenn der Wert in der Shell nur Leerraum enthält, entfernen Sie `CLAUDE_CONFIG_DIR` vor dem Start von Claude Code aus der Umgebung, damit auch Claude Code das Standardprofil verwendet. Verwende einen absoluten Pfad. Relative Pfade werden vom Arbeitsverzeichnis aus aufgelöst, daher müssen beide Befehle im selben Verzeichnis ausgeführt werden. + +Die Hook-Befehle verwenden absolute Pfade zum mitgelieferten Verzeichnis `plugin/` des installierten Pakets. Führen Sie den Befehl nach einem Upgrade von agentmemory erneut aus, um diese Pfade zu aktualisieren. Benutzereinträge in den Konfigurationsdateien bleiben erhalten; nur bisherige agentmemory-Einträge werden ersetzt. Die Verwendung von `/plugin install` bleibt der empfohlene Weg. Für entfernte oder geschützte Deployments starten Sie Claude Code mit gesetztem `AGENTMEMORY_URL` und `AGENTMEMORY_SECRET`. Das Plugin reicht beide Werte an seinen mitgelieferten MCP-Server weiter; ist `AGENTMEMORY_URL` leer, verwendet das MCP-Shim `http://localhost:3111`. ### Codex CLI (Codex-Plugin-Plattform) diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md index 87964c0e5c..bf7fb21375 100644 --- a/READMEs/README.el-GR.md +++ b/READMEs/README.el-GR.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code χωρίς εγκατάσταση plugin (αυτόνομη διαδρομή MCP) -Αν συνδέσετε τον διακομιστή MCP του agentmemory μέσω του `~/.claude.json` απευθείας αντί να χρησιμοποιήσετε το `/plugin install`, το Claude Code δεν επιλύει ποτέ το `${CLAUDE_PLUGIN_ROOT}` και πρέπει να δείξετε τα scripts των hooks σε απόλυτες διαδρομές στο `~/.claude/settings.json`. Αυτές οι διαδρομές συνήθως ενσωματώνουν την έκδοση του agentmemory (π.χ. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), οπότε η επόμενη αναβάθμιση χαλάει σιωπηλά κάθε hook. +Αν συνδέσετε τον διακομιστή MCP του agentmemory μέσω του `~/.claude.json` (προεπιλεγμένη διαδρομή) απευθείας αντί να χρησιμοποιήσετε το `/plugin install`, το Claude Code δεν επιλύει ποτέ το `${CLAUDE_PLUGIN_ROOT}` και πρέπει να δείξετε τα scripts των hooks σε απόλυτες διαδρομές στο `~/.claude/settings.json` (προεπιλεγμένη διαδρομή). Αυτές οι διαδρομές συνήθως ενσωματώνουν την έκδοση του agentmemory (π.χ. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), οπότε η επόμενη αναβάθμιση χαλάει σιωπηλά κάθε hook. Λύση παράκαμψης: @@ -454,7 +454,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Αυτό συγχωνεύει τις ίδιες εντολές hook στο `~/.claude/settings.json` με απόλυτες διαδρομές που αναλύονται στον ενσωματωμένο κατάλογο `plugin/` του πακέτου `@agentmemory/agentmemory` που είναι τρέχουσα εγκατεστημένο. Εκτελέστε ξανά την εντολή μετά την αναβάθμιση του agentmemory για να ανανεωθούν οι διαδρομές. Οι καταχωρήσεις του χρήστη στο ίδιο αρχείο διατηρούνται· αντικαθίστανται μόνο οι προηγούμενες καταχωρήσεις του agentmemory. Η χρήση της διαδρομής `/plugin install` παραμένει η συνιστώμενη προσέγγιση. +Αυτή η εντολή ρυθμίζει τον διακομιστή MCP και συγχωνεύει τα ενσωματωμένα hooks στη διαμόρφωση χρήστη του Claude Code. Αν το `CLAUDE_CONFIG_DIR` δεν έχει οριστεί, είναι κενό ή περιέχει μόνο κενούς χαρακτήρες, χρησιμοποιεί το `~/.claude.json` για το MCP και το `~/.claude/settings.json` για τα hooks. Οι υπόλοιπες τιμές καταλόγου χρησιμοποιούνται ακριβώς όπως δίνονται, μαζί με τυχόν κενούς χαρακτήρες στην αρχή και στο τέλος. Για προσαρμοσμένο κατάλογο, ορίστε την ίδια μη κενή τιμή του `CLAUDE_CONFIG_DIR` για αυτή την εντολή και το Claude Code, οπότε τα αρχεία θα είναι `$CLAUDE_CONFIG_DIR/.claude.json` και `$CLAUDE_CONFIG_DIR/settings.json`, αντίστοιχα. Το Claude Code πρέπει να λάβει αυτή την τιμή στο περιβάλλον εκκίνησής του, ακόμη και αν ο connector τη διαβάζει από το `.env` του AgentMemory. Δημιουργήστε τον προσαρμοσμένο κατάλογο πριν εκτελέσετε αυτή την εντολή, διαφορετικά ο connector παραλείπει το Claude Code επειδή δεν το εντοπίζει. Αν η τιμή στο shell περιέχει μόνο κενούς χαρακτήρες, καταργήστε το `CLAUDE_CONFIG_DIR` από το περιβάλλον πριν ξεκινήσετε το Claude Code, ώστε να χρησιμοποιήσει και αυτό το προεπιλεγμένο προφίλ. Χρησιμοποιήστε απόλυτη διαδρομή. Οι σχετικές διαδρομές επιλύονται ως προς τον κατάλογο εργασίας, οπότε και οι δύο εντολές πρέπει να εκτελούνται από τον ίδιο κατάλογο. + +Οι εντολές των hooks χρησιμοποιούν απόλυτες διαδρομές προς τον ενσωματωμένο κατάλογο `plugin/` του εγκατεστημένου πακέτου. Εκτελέστε ξανά την εντολή μετά την αναβάθμιση του agentmemory για να ενημερώσετε αυτές τις διαδρομές. Οι καταχωρίσεις χρήστη στα αρχεία διαμόρφωσης διατηρούνται και αντικαθίστανται μόνο οι προηγούμενες καταχωρίσεις του agentmemory. Η χρήση του `/plugin install` παραμένει η προτεινόμενη προσέγγιση. Για απομακρυσμένες ή προστατευμένες αναπτύξεις, εκκινήστε το Claude Code με ρυθμισμένα τα `AGENTMEMORY_URL` και `AGENTMEMORY_SECRET`. Το plugin περνάει και τις δύο τιμές στον ενσωματωμένο διακομιστή MCP του· όταν το `AGENTMEMORY_URL` είναι άδειο, το MCP shim χρησιμοποιεί το `http://localhost:3111`. ### Codex CLI (πλατφόρμα plugin του Codex) diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md index ec06c15d98..3a7431ae59 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code sin instalar el plugin (ruta MCP standalone) -Si conectas el servidor MCP de agentmemory directamente vía `~/.claude.json` en lugar de usar `/plugin install`, Claude Code nunca resuelve `${CLAUDE_PLUGIN_ROOT}` y tienes que apuntar los scripts de hook a rutas absolutas en `~/.claude/settings.json`. Esas rutas suelen incluir la versión de agentmemory (p. ej. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), por lo que la siguiente actualización rompe silenciosamente todos los hooks. +Si conectas el servidor MCP de agentmemory directamente vía `~/.claude.json` (ruta predeterminada) en lugar de usar `/plugin install`, Claude Code nunca resuelve `${CLAUDE_PLUGIN_ROOT}` y tienes que apuntar los scripts de hook a rutas absolutas en `~/.claude/settings.json` (ruta predeterminada). Esas rutas suelen incluir la versión de agentmemory (p. ej. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), por lo que la siguiente actualización rompe silenciosamente todos los hooks. Workaround: @@ -449,7 +449,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -Esto fusiona los mismos comandos de hook en `~/.claude/settings.json` con rutas absolutas que apuntan al directorio `plugin/` empaquetado del paquete `@agentmemory/agentmemory` actualmente instalado. Vuelve a ejecutar el comando tras actualizar agentmemory para refrescar las rutas. Las entradas de usuario en el mismo fichero se preservan; solo se reemplazan las entradas previas de agentmemory. La ruta vía `/plugin install` sigue siendo la recomendada. +Este comando configura el servidor MCP y fusiona los hooks incluidos en la configuración de usuario de Claude Code. Si `CLAUDE_CONFIG_DIR` no está definida, está vacía o contiene solo espacios en blanco, usa `~/.claude.json` para MCP y `~/.claude/settings.json` para los hooks. Los demás valores de directorio se usan tal como se proporcionan, incluidos los espacios en blanco iniciales y finales. Para usar un directorio personalizado, establece `CLAUDE_CONFIG_DIR` con el mismo valor no vacío para este comando y para Claude Code; los archivos serán entonces `$CLAUDE_CONFIG_DIR/.claude.json` y `$CLAUDE_CONFIG_DIR/settings.json`, respectivamente. Claude Code debe recibir este valor en su entorno de inicio, aunque el conector lo lea del archivo `.env` de AgentMemory. Crea el directorio personalizado antes de ejecutar este comando; de lo contrario, el conector omite Claude Code porque no lo detecta. Si el valor en el shell contiene solo espacios en blanco, elimina `CLAUDE_CONFIG_DIR` del entorno antes de iniciar Claude Code para que también use el perfil predeterminado. Usa una ruta absoluta. Las rutas relativas se resuelven desde el directorio de trabajo, por lo que ambos comandos deben ejecutarse desde el mismo directorio. + +Los comandos de los hooks usan rutas absolutas al directorio `plugin/` incluido en el paquete instalado. Vuelve a ejecutar el comando tras actualizar agentmemory para refrescar esas rutas. Las entradas de usuario en los archivos de configuración se conservan; solo se reemplazan las entradas previas de agentmemory. El uso de `/plugin install` sigue siendo la opción recomendada. Para despliegues remotos o protegidos, lanza Claude Code con `AGENTMEMORY_URL` y `AGENTMEMORY_SECRET` definidos. El plugin pasa ambos valores a su servidor MCP empaquetado; cuando `AGENTMEMORY_URL` está vacío, el shim MCP usa `http://localhost:3111`. ### Codex CLI (plataforma de plugins Codex) diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md index e31f85b642..0172827e40 100644 --- a/READMEs/README.fi-FI.md +++ b/READMEs/README.fi-FI.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code ilman pluginin asennusta (itsenäinen MCP-reitti) -Jos kytket agentmemoryn MCP-palvelimen tiedoston `~/.claude.json` kautta suoraan sen sijaan, että käyttäisit `/plugin install`-komentoa, Claude Code ei koskaan ratkaise muuttujaa `${CLAUDE_PLUGIN_ROOT}`, ja sinun on osoitettava hook-skriptit absoluuttisiin polkuihin tiedostossa `~/.claude/settings.json`. Nämä polut sisältävät tyypillisesti agentmemoryn versionumeron (esim. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), niin että seuraava päivitys hajottaa hiljaisesti kaikki hookit. +Jos kytket agentmemoryn MCP-palvelimen tiedoston `~/.claude.json` (oletuspolku) kautta suoraan sen sijaan, että käyttäisit `/plugin install`-komentoa, Claude Code ei koskaan ratkaise muuttujaa `${CLAUDE_PLUGIN_ROOT}`, ja sinun on osoitettava hook-skriptit absoluuttisiin polkuihin tiedostossa `~/.claude/settings.json` (oletuspolku). Nämä polut sisältävät tyypillisesti agentmemoryn versionumeron (esim. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), niin että seuraava päivitys hajottaa hiljaisesti kaikki hookit. Kiertotapa: @@ -454,7 +454,9 @@ Kiertotapa: agentmemory connect claude-code --with-hooks ``` -Tämä yhdistää samat hook-komennot tiedostoon `~/.claude/settings.json` absoluuttisilla poluilla, jotka osoittavat asennetun `@agentmemory/agentmemory`-paketin mukana tulevaan `plugin/`-hakemistoon. Aja komento uudelleen agentmemoryn päivityksen jälkeen päivittääksesi polut. Käyttäjän omat merkinnät samassa tiedostossa säilyvät; vain aiemmat agentmemory-merkinnät korvataan. `/plugin install`-reitti pysyy suositeltuna lähestymistapana. +Tämä komento määrittää MCP-palvelimen ja yhdistää mukana tulevat hookit Claude Coden käyttäjäkohtaisiin asetuksiin. Jos `CLAUDE_CONFIG_DIR` on asettamatta, tyhjä tai sisältää vain tyhjiä merkkejä, se käyttää MCP:lle tiedostoa `~/.claude.json` ja hookeille tiedostoa `~/.claude/settings.json`. Muut hakemistopolut säilytetään täsmälleen annettuina, myös alun ja lopun tyhjät merkit mukaan lukien. Jos haluat käyttää omaa hakemistoa, aseta `CLAUDE_CONFIG_DIR` samaksi ei-tyhjäksi arvoksi sekä tälle komennolle että Claude Codelle; tiedostot ovat tällöin `$CLAUDE_CONFIG_DIR/.claude.json` MCP:lle ja `$CLAUDE_CONFIG_DIR/settings.json` hookeille. Claude Coden on saatava tämä arvo käynnistysympäristöstään, vaikka yhdistin lukisi sen AgentMemoryn `.env`-tiedostosta. Luo oma hakemisto ennen tämän komennon suorittamista; muuten yhdistin ohittaa Claude Coden, koska sitä ei tunnisteta. Jos shellin arvo sisältää vain tyhjiä merkkejä, poista `CLAUDE_CONFIG_DIR` ympäristöstä ennen Claude Coden käynnistämistä, jotta myös se käyttää oletusprofiilia. Käytä absoluuttista polkua. Suhteelliset polut tulkitaan työhakemiston perusteella, joten molemmat komennot on suoritettava samasta hakemistosta. + +Hook-komennot käyttävät absoluuttisia polkuja asennetun paketin mukana tulevaan `plugin/`-hakemistoon. Suorita komento uudelleen agentmemoryn päivityksen jälkeen, jotta polut päivittyvät. Käyttäjän omat merkinnät asetustiedostoissa säilytetään; vain aiemmat agentmemory-merkinnät korvataan. `/plugin install` on edelleen suositeltu tapa. Etä- tai suojattuja käyttöönottoja varten käynnistä Claude Code `AGENTMEMORY_URL`- ja `AGENTMEMORY_SECRET`-muuttujat asetettuina. Plugin välittää molemmat arvot sen mukana tulevalle MCP-palvelimelle; kun `AGENTMEMORY_URL` on tyhjä, MCP-shim käyttää osoitetta `http://localhost:3111`. ### Codex CLI (Codexin plugin-alusta) diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md index 9af69d3629..0a3a1f01b2 100644 --- a/READMEs/README.fr-FR.md +++ b/READMEs/README.fr-FR.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code sans l'installation du plugin (chemin MCP-standalone) -Si vous câblez le serveur MCP d'agentmemory via `~/.claude.json` directement plutôt qu'en utilisant `/plugin install`, Claude Code ne résout jamais `${CLAUDE_PLUGIN_ROOT}` et vous devez pointer les scripts de hooks vers des chemins absolus dans `~/.claude/settings.json`. Ces chemins embarquent typiquement la version d'agentmemory (par ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), donc la prochaine mise à niveau casse silencieusement chaque hook. +Si vous câblez le serveur MCP d'agentmemory via `~/.claude.json` (chemin par défaut) directement plutôt qu'en utilisant `/plugin install`, Claude Code ne résout jamais `${CLAUDE_PLUGIN_ROOT}` et vous devez pointer les scripts de hooks vers des chemins absolus dans `~/.claude/settings.json` (chemin par défaut). Ces chemins embarquent typiquement la version d'agentmemory (par ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), donc la prochaine mise à niveau casse silencieusement chaque hook. Solution de contournement : @@ -449,7 +449,9 @@ Solution de contournement : agentmemory connect claude-code --with-hooks ``` -Cela fusionne les mêmes commandes de hooks dans `~/.claude/settings.json` avec des chemins absolus résolus vers le répertoire `plugin/` embarqué dans le paquet `@agentmemory/agentmemory` actuellement installé. Relancez la commande après chaque mise à niveau d'agentmemory pour rafraîchir les chemins. Les entrées utilisateur dans le même fichier sont préservées ; seules les entrées agentmemory précédentes sont remplacées. Le chemin `/plugin install` reste l'approche recommandée. +Cette commande configure le serveur MCP et fusionne les hooks inclus dans la configuration utilisateur de Claude Code. Si `CLAUDE_CONFIG_DIR` est absente, vide ou composée uniquement d’espaces, elle utilise `~/.claude.json` pour MCP et `~/.claude/settings.json` pour les hooks. Les autres valeurs de répertoire sont utilisées telles quelles, y compris les espaces en début et en fin de valeur. Pour utiliser un répertoire personnalisé, attribuez la même valeur non vide à `CLAUDE_CONFIG_DIR` pour cette commande et pour Claude Code ; les fichiers sont alors `$CLAUDE_CONFIG_DIR/.claude.json` et `$CLAUDE_CONFIG_DIR/settings.json`, respectivement. Claude Code doit recevoir cette valeur dans son environnement de lancement, même si le connecteur la lit dans le fichier `.env` d’AgentMemory. Créez le répertoire personnalisé avant d’exécuter cette commande ; sinon, Claude Code n’est pas détecté et le connecteur l’ignore. Si la valeur dans le shell ne contient que des espaces, supprimez `CLAUDE_CONFIG_DIR` de l’environnement avant de lancer Claude Code pour qu’il utilise aussi le profil par défaut. Utilisez un chemin absolu. Les chemins relatifs sont résolus à partir du répertoire de travail ; les deux commandes doivent donc être exécutées depuis le même répertoire. + +Les commandes des hooks utilisent des chemins absolus vers le répertoire `plugin/` inclus dans le paquet installé. Relancez la commande après la mise à niveau d’agentmemory pour actualiser ces chemins. Les entrées utilisateur dans les fichiers de configuration sont conservées ; seules les anciennes entrées d’agentmemory sont remplacées. L’utilisation de `/plugin install` reste l’approche recommandée. Pour des déploiements distants ou protégés, lancez Claude Code avec `AGENTMEMORY_URL` et `AGENTMEMORY_SECRET` définis. Le plugin transmet les deux valeurs à son serveur MCP embarqué ; quand `AGENTMEMORY_URL` est vide, le shim MCP utilise `http://localhost:3111`. ### Codex CLI (plateforme de plugins Codex) diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md index 034ed34170..3be44ec90b 100644 --- a/READMEs/README.he-IL.md +++ b/READMEs/README.he-IL.md @@ -448,7 +448,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code בלי התקנת ה-plugin (נתיב MCP בלבד) -אם אתם מחווטים את שרת ה-MCP של agentmemory ישירות דרך `~/.claude.json` במקום להשתמש ב-`/plugin install`, Claude Code לעולם לא פותר את `${CLAUDE_PLUGIN_ROOT}` ואתם חייבים להפנות את סקריפטי ה-hook ל-paths מוחלטים בתוך `~/.claude/settings.json`. ה-paths האלה בדרך כלל מטמיעים בתוכם את גרסת agentmemory (למשל `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), כך שהשדרוג הבא שובר בשקט כל hook. +אם אתם מחווטים את שרת ה-MCP של agentmemory ישירות דרך `~/.claude.json` (נתיב ברירת המחדל) במקום להשתמש ב-`/plugin install`, Claude Code לעולם לא פותר את `${CLAUDE_PLUGIN_ROOT}` ואתם חייבים להפנות את סקריפטי ה-hook ל-paths מוחלטים בתוך `~/.claude/settings.json` (נתיב ברירת המחדל). ה-paths האלה בדרך כלל מטמיעים בתוכם את גרסת agentmemory (למשל `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), כך שהשדרוג הבא שובר בשקט כל hook. פתרון עוקף: @@ -456,7 +456,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -זה ממזג את אותן פקודות hook לתוך `~/.claude/settings.json` עם paths מוחלטים שנפתרים לתיקיית `plugin/` המצורפת של חבילת `@agentmemory/agentmemory` המותקנת כעת. יש להריץ את הפקודה מחדש אחרי שדרוג agentmemory כדי לרפרש את ה-paths. רשומות משתמש בקובץ עצמו נשמרות; רק רשומות agentmemory קודמות מוחלפות. השימוש בנתיב `/plugin install` נשאר הגישה המומלצת. +הפקודה מגדירה את שרת ה-MCP וממזגת את ה-hooks המצורפים לתצורת המשתמש של Claude Code. אם `CLAUDE_CONFIG_DIR` אינו מוגדר, ריק או מכיל רק תווי רווח, היא משתמשת ב-`~/.claude.json` עבור MCP וב-`~/.claude/settings.json` עבור hooks. ערכי תיקייה אחרים משמשים בדיוק כפי שהוזנו, כולל תווי רווח בתחילת הערך ובסופו. כדי להשתמש בתיקייה מותאמת אישית, הגדירו את `CLAUDE_CONFIG_DIR` לאותו ערך שאינו ריק גם עבור הפקודה הזו וגם עבור Claude Code; הקבצים יהיו אז `$CLAUDE_CONFIG_DIR/.claude.json` ו-`$CLAUDE_CONFIG_DIR/settings.json`, בהתאמה. Claude Code חייב לקבל את הערך בסביבת ההפעלה שלו, גם אם המחבר קורא אותו מקובץ `.env` של AgentMemory. צרו את התיקייה המותאמת אישית לפני הפעלת הפקודה; אחרת המחבר מדלג על Claude Code כי הוא לא זוהה. אם הערך ב-shell מכיל רק תווי רווח, הסירו את `CLAUDE_CONFIG_DIR` מהסביבה לפני הפעלת Claude Code כדי שגם הוא ישתמש בפרופיל ברירת המחדל. השתמשו בנתיב מוחלט. נתיבים יחסיים מפוענחים ביחס לתיקיית העבודה, ולכן יש להריץ את שתי הפקודות מאותה תיקייה. + +פקודות ה-hook משתמשות בנתיבים מוחלטים לתיקיית `plugin/` המצורפת לחבילה המותקנת. הפעילו שוב את הפקודה לאחר שדרוג agentmemory כדי לרענן את הנתיבים. רשומות המשתמש בקובצי התצורה נשמרות; רק רשומות קודמות של agentmemory מוחלפות. השימוש ב-`/plugin install` נותר הדרך המומלצת. ל-deployments מרוחקים או מוגנים, הפעילו את Claude Code עם `AGENTMEMORY_URL` ו-`AGENTMEMORY_SECRET` מוגדרים. ה-plugin מעביר את שני הערכים לשרת ה-MCP המצורף שלו; כש-`AGENTMEMORY_URL` ריק, ה-shim של MCP משתמש ב-`http://localhost:3111`. ### Codex CLI (פלטפורמת plugin של Codex) diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md index 117ad51d40..54d699d5a3 100644 --- a/READMEs/README.hi-IN.md +++ b/READMEs/README.hi-IN.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Plugin install के बिना Claude Code (MCP-standalone path) -अगर आप `/plugin install` का उपयोग करने के बजाय `~/.claude.json` के माध्यम से सीधे agentmemory का MCP server connect करते हैं, तो Claude Code कभी भी `${CLAUDE_PLUGIN_ROOT}` resolve नहीं करता और आपको hook scripts को `~/.claude/settings.json` में absolute paths पर point करना पड़ता है। ये paths आमतौर पर agentmemory version को embed करते हैं (जैसे `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), इसलिए अगला upgrade चुपचाप हर hook को तोड़ देता है। +अगर आप `/plugin install` का उपयोग करने के बजाय `~/.claude.json` (डिफ़ॉल्ट पथ) के माध्यम से सीधे agentmemory का MCP server connect करते हैं, तो Claude Code कभी भी `${CLAUDE_PLUGIN_ROOT}` resolve नहीं करता और आपको hook scripts को `~/.claude/settings.json` (डिफ़ॉल्ट पथ) में absolute paths पर point करना पड़ता है। ये paths आमतौर पर agentmemory version को embed करते हैं (जैसे `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), इसलिए अगला upgrade चुपचाप हर hook को तोड़ देता है। Workaround: @@ -452,7 +452,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -यह वही hook commands को `~/.claude/settings.json` में merge करता है, current installed `@agentmemory/agentmemory` package की bundled `plugin/` directory पर resolve किए गए absolute paths के साथ। agentmemory upgrade करने के बाद paths refresh करने के लिए command फिर से चलाएँ। उसी file में user entries preserved रहती हैं; केवल पिछली agentmemory entries replace होती हैं। `/plugin install` path अनुशंसित approach बनी रहती है। +यह कमांड MCP सर्वर को कॉन्फ़िगर करता है और साथ आए hooks को Claude Code के उपयोगकर्ता कॉन्फ़िगरेशन में मिलाता है। यदि `CLAUDE_CONFIG_DIR` सेट नहीं है, खाली है या उसमें केवल व्हाइटस्पेस हैं, तो यह MCP के लिए `~/.claude.json` और hooks के लिए `~/.claude/settings.json` का उपयोग करता है। डायरेक्टरी के अन्य मान आगे-पीछे के व्हाइटस्पेस सहित ठीक वैसे ही इस्तेमाल होते हैं जैसे दिए गए हैं। कस्टम डायरेक्टरी के लिए इस कमांड और Claude Code दोनों में `CLAUDE_CONFIG_DIR` का एक ही गैर-खाली मान सेट करें; तब फ़ाइलें क्रमशः `$CLAUDE_CONFIG_DIR/.claude.json` और `$CLAUDE_CONFIG_DIR/settings.json` होंगी। Claude Code के लॉन्च वातावरण में यह मान होना चाहिए, भले ही कनेक्टर इसे AgentMemory की `.env` से पढ़ता हो। इस कमांड को चलाने से पहले कस्टम डायरेक्टरी बनाएँ; अन्यथा कनेक्टर Claude Code को नहीं पहचान पाता और उसे छोड़ देता है। यदि shell के मान में केवल व्हाइटस्पेस हैं, तो Claude Code लॉन्च करने से पहले `CLAUDE_CONFIG_DIR` अनसेट करें, ताकि वह भी डिफ़ॉल्ट प्रोफ़ाइल का उपयोग करे। निरपेक्ष पथ का उपयोग करें। सापेक्ष पथ कार्यशील डायरेक्टरी के आधार पर तय होते हैं, इसलिए दोनों कमांड एक ही डायरेक्टरी से चलाएँ। + +Hook कमांड इंस्टॉल किए गए पैकेज की साथ आई `plugin/` डायरेक्टरी के ऐब्सोल्यूट पथ इस्तेमाल करते हैं। agentmemory अपग्रेड करने के बाद इन पथों को रीफ़्रेश करने के लिए कमांड फिर से चलाएँ। कॉन्फ़िगरेशन फ़ाइलों में उपयोगकर्ता की प्रविष्टियाँ बनी रहती हैं; केवल पिछली agentmemory प्रविष्टियाँ बदली जाती हैं। `/plugin install` का उपयोग करना अब भी अनुशंसित तरीका है। Remote या protected deployments के लिए, Claude Code को `AGENTMEMORY_URL` और `AGENTMEMORY_SECRET` set के साथ launch करें। Plugin दोनों values को अपने bundled MCP server के माध्यम से pass करता है; जब `AGENTMEMORY_URL` खाली होता है, तो MCP shim `http://localhost:3111` का उपयोग करता है। ### Codex CLI (Codex plugin platform) diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md index d3cdef2c89..798b32c527 100644 --- a/READMEs/README.hu-HU.md +++ b/READMEs/README.hu-HU.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code a plugin telepítése nélkül (önálló MCP útvonal) -Ha az agentmemory MCP szerverét közvetlenül a `~/.claude.json`-ban kötöd be, a `/plugin install` használata helyett, a Claude Code soha nem oldja fel a `${CLAUDE_PLUGIN_ROOT}`-ot, és a hook-szkripteket abszolút elérési utakra kell mutatnod a `~/.claude/settings.json`-ban. Ezek az útvonalak jellemzően beágyazzák az agentmemory verziószámát (pl. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), így a következő frissítés némán elront minden hookot. +Ha az agentmemory MCP szerverét közvetlenül a `~/.claude.json` (alapértelmezett útvonal)-ban kötöd be, a `/plugin install` használata helyett, a Claude Code soha nem oldja fel a `${CLAUDE_PLUGIN_ROOT}`-ot, és a hook-szkripteket abszolút elérési utakra kell mutatnod a `~/.claude/settings.json` (alapértelmezett útvonal)-ban. Ezek az útvonalak jellemzően beágyazzák az agentmemory verziószámát (pl. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), így a következő frissítés némán elront minden hookot. Megoldás: @@ -452,7 +452,9 @@ Megoldás: agentmemory connect claude-code --with-hooks ``` -Ez ugyanazokat a hook-parancsokat olvasztja be a `~/.claude/settings.json`-ba, abszolút elérési utakkal, amelyek a jelenleg telepített `@agentmemory/agentmemory` csomag becsomagolt `plugin/` mappájára mutatnak. Futtasd újra a parancsot az agentmemory frissítése után, hogy felfrissítsd az útvonalakat. A felhasználó saját bejegyzései ugyanabban a fájlban megmaradnak; csak a korábbi agentmemory-bejegyzések kerülnek lecserélésre. A `/plugin install` útvonal marad az ajánlott megközelítés. +Ez a parancs beállítja az MCP-kiszolgálót, és beolvasztja a mellékelt hookokat a Claude Code felhasználói konfigurációjába. Ha a `CLAUDE_CONFIG_DIR` nincs beállítva, üres, vagy csak üres karaktereket tartalmaz, az MCP-hez a `~/.claude.json`, a hookokhoz pedig a `~/.claude/settings.json` fájlt használja. A többi könyvtárérték változatlanul kerül felhasználásra, az elején és végén lévő üres karakterekkel együtt. Egyéni könyvtár használatához állítsd a `CLAUDE_CONFIG_DIR` változót ugyanarra a nem üres értékre ennél a parancsnál és a Claude Code-nál is; ekkor az MCP fájlja `$CLAUDE_CONFIG_DIR/.claude.json`, a hookoké pedig `$CLAUDE_CONFIG_DIR/settings.json` lesz. A Claude Code-nak az indítási környezetében meg kell kapnia ezt az értéket akkor is, ha a csatlakozó az AgentMemory `.env` fájljából olvassa be. A parancs futtatása előtt hozd létre az egyéni könyvtárat; különben a csatlakozó nem észleli a Claude Code-ot, és kihagyja. Ha a shellben az érték csak üres karaktereket tartalmaz, a Claude Code indítása előtt töröld a `CLAUDE_CONFIG_DIR` változót a környezetből, hogy az is az alapértelmezett profilt használja. Használj abszolút elérési utat. A relatív utak a munkakönyvtárhoz képest értendők, ezért mindkét parancsot ugyanabból a könyvtárból kell futtatni. + +A hook-parancsok a telepített csomaghoz mellékelt `plugin/` könyvtárra mutató abszolút útvonalakat használnak. Az agentmemory frissítése után futtasd újra a parancsot az útvonalak frissítéséhez. A konfigurációs fájlok felhasználói bejegyzései megmaradnak; csak a korábbi agentmemory-bejegyzések cserélődnek le. Továbbra is a `/plugin install` használata az ajánlott megoldás. Távoli vagy védett telepítésekhez indítsd el a Claude Code-ot az `AGENTMEMORY_URL` és az `AGENTMEMORY_SECRET` beállításával. A plugin mindkét értéket továbbadja a becsomagolt MCP szerverének; amikor az `AGENTMEMORY_URL` üres, az MCP shim a `http://localhost:3111`-et használja. ### Codex CLI (Codex plugin platform) diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md index c4e5f5a9ef..8ea3eb0972 100644 --- a/READMEs/README.id-ID.md +++ b/READMEs/README.id-ID.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code tanpa instalasi plugin (jalur MCP-standalone) -Jika Anda menyambungkan server MCP agentmemory lewat `~/.claude.json` secara langsung tanpa memakai `/plugin install`, Claude Code tidak pernah meresolusi `${CLAUDE_PLUGIN_ROOT}` dan Anda harus mengarahkan script hook ke path absolut di `~/.claude/settings.json`. Path tersebut biasanya menyertakan versi agentmemory (misalnya `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), sehingga upgrade berikutnya diam-diam merusak setiap hook. +Jika Anda menyambungkan server MCP agentmemory lewat `~/.claude.json` (jalur default) secara langsung tanpa memakai `/plugin install`, Claude Code tidak pernah meresolusi `${CLAUDE_PLUGIN_ROOT}` dan Anda harus mengarahkan script hook ke path absolut di `~/.claude/settings.json` (jalur default). Path tersebut biasanya menyertakan versi agentmemory (misalnya `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), sehingga upgrade berikutnya diam-diam merusak setiap hook. Solusinya: @@ -452,7 +452,9 @@ Solusinya: agentmemory connect claude-code --with-hooks ``` -Ini menggabungkan perintah hook yang sama ke `~/.claude/settings.json` dengan path absolut yang diresolusi ke direktori `plugin/` bundel dari paket `@agentmemory/agentmemory` yang sedang terpasang. Jalankan ulang perintah ini setelah upgrade agentmemory untuk menyegarkan path-nya. Entri pengguna di file yang sama tetap dipertahankan; hanya entri agentmemory sebelumnya yang diganti. Jalur `/plugin install` tetap menjadi pendekatan yang direkomendasikan. +Perintah ini mengonfigurasi server MCP dan menggabungkan hook bawaan ke konfigurasi pengguna Claude Code. Jika `CLAUDE_CONFIG_DIR` tidak diatur, kosong, atau hanya berisi whitespace, perintah ini menggunakan `~/.claude.json` untuk MCP dan `~/.claude/settings.json` untuk hook. Nilai direktori lainnya digunakan persis seperti yang diberikan, termasuk whitespace di awal dan akhir. Untuk direktori khusus, atur `CLAUDE_CONFIG_DIR` ke nilai tidak kosong yang sama untuk perintah ini dan Claude Code; file yang digunakan menjadi `$CLAUDE_CONFIG_DIR/.claude.json` dan `$CLAUDE_CONFIG_DIR/settings.json`, masing-masing. Claude Code harus menerima nilai ini di lingkungan saat dijalankan, meskipun konektor membacanya dari `.env` milik AgentMemory. Buat direktori khusus sebelum menjalankan perintah ini; jika tidak, konektor melewati Claude Code karena tidak terdeteksi. Jika nilai di shell hanya berisi whitespace, hapus `CLAUDE_CONFIG_DIR` dari lingkungan sebelum menjalankan Claude Code agar juga menggunakan profil default. Gunakan jalur absolut. Jalur relatif ditentukan berdasarkan direktori kerja, jadi kedua perintah harus dijalankan dari direktori yang sama. + +Perintah hook menggunakan jalur absolut ke direktori `plugin/` bawaan paket yang terpasang. Jalankan ulang perintah ini setelah memperbarui agentmemory untuk menyegarkan jalur tersebut. Entri pengguna dalam file konfigurasi tetap dipertahankan; hanya entri agentmemory sebelumnya yang diganti. Penggunaan `/plugin install` tetap menjadi pendekatan yang disarankan. Untuk deployment remote atau terlindungi, jalankan Claude Code dengan `AGENTMEMORY_URL` dan `AGENTMEMORY_SECRET` yang sudah diset. Plugin ini meneruskan kedua nilai itu ke server MCP bundelnya; ketika `AGENTMEMORY_URL` kosong, shim MCP memakai `http://localhost:3111`. ### Codex CLI (platform plugin Codex) diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md index 1db24899f8..5ff741a840 100644 --- a/READMEs/README.it-IT.md +++ b/READMEs/README.it-IT.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code senza l'installazione del plugin (percorso MCP standalone) -Se collegi il server MCP di agentmemory tramite `~/.claude.json` direttamente invece di usare `/plugin install`, Claude Code non risolve mai `${CLAUDE_PLUGIN_ROOT}` e devi puntare gli script degli hook a percorsi assoluti in `~/.claude/settings.json`. Questi percorsi di solito incorporano la versione di agentmemory (ad es. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), quindi il prossimo aggiornamento rompe silenziosamente ogni hook. +Se collegi il server MCP di agentmemory tramite `~/.claude.json` (percorso predefinito) direttamente invece di usare `/plugin install`, Claude Code non risolve mai `${CLAUDE_PLUGIN_ROOT}` e devi puntare gli script degli hook a percorsi assoluti in `~/.claude/settings.json` (percorso predefinito). Questi percorsi di solito incorporano la versione di agentmemory (ad es. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), quindi il prossimo aggiornamento rompe silenziosamente ogni hook. Soluzione alternativa: @@ -449,7 +449,9 @@ Soluzione alternativa: agentmemory connect claude-code --with-hooks ``` -Questo unisce gli stessi comandi degli hook in `~/.claude/settings.json` con percorsi assoluti risolti verso la directory `plugin/` incorporata nel pacchetto `@agentmemory/agentmemory` attualmente installato. Riesegui il comando dopo aver aggiornato agentmemory per aggiornare i percorsi. Le voci dell'utente nello stesso file vengono preservate; vengono sostituite solo le voci precedenti di agentmemory. Usare il percorso `/plugin install` resta l'approccio consigliato. +Questo comando configura il server MCP e unisce gli hook inclusi alla configurazione utente di Claude Code. Se `CLAUDE_CONFIG_DIR` non è impostata, è vuota o contiene solo spazi, usa `~/.claude.json` per MCP e `~/.claude/settings.json` per gli hook. Gli altri valori di directory vengono usati esattamente come forniti, inclusi gli spazi iniziali e finali. Per una directory personalizzata, imposta `CLAUDE_CONFIG_DIR` sullo stesso valore non vuoto sia per questo comando sia per Claude Code; i file saranno quindi rispettivamente `$CLAUDE_CONFIG_DIR/.claude.json` e `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code deve ricevere questo valore nel proprio ambiente di avvio, anche se il connettore lo legge dal file `.env` di AgentMemory. Crea la directory personalizzata prima di eseguire questo comando; altrimenti il connettore ignora Claude Code perché non viene rilevato. Se il valore nella shell contiene solo spazi, rimuovi `CLAUDE_CONFIG_DIR` dall’ambiente prima di avviare Claude Code, in modo che usi anch’esso il profilo predefinito. Usa un percorso assoluto. I percorsi relativi vengono risolti dalla directory di lavoro, quindi entrambi i comandi devono essere eseguiti dalla stessa directory. + +I comandi degli hook usano percorsi assoluti verso la directory `plugin/` inclusa nel pacchetto installato. Riesegui il comando dopo aver aggiornato agentmemory per aggiornare questi percorsi. Le voci utente nei file di configurazione vengono preservate; vengono sostituite solo le precedenti voci di agentmemory. L’uso di `/plugin install` rimane l’approccio consigliato. Per deployment remoti o protetti, avvia Claude Code con `AGENTMEMORY_URL` e `AGENTMEMORY_SECRET` impostati. Il plugin passa entrambi i valori al suo server MCP incorporato; quando `AGENTMEMORY_URL` è vuoto, lo shim MCP usa `http://localhost:3111`. ### Codex CLI (piattaforma plugin di Codex) diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md index 679309b6b8..7b6e36d5bc 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### プラグインをインストールしない Claude Code(MCP スタンドアロン経路) -`/plugin install` を使わず `~/.claude.json` から直接 agentmemory の MCP サーバーを配線する場合、Claude Code は `${CLAUDE_PLUGIN_ROOT}` を一切解決しないため、hook スクリプトを `~/.claude/settings.json` 内の絶対パスに向ける必要があります。これらのパスには通常 agentmemory のバージョンが埋め込まれる(例: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)ため、次のアップグレードで全 hook が静かに壊れます。 +`/plugin install` を使わず `~/.claude.json`(既定のパス) から直接 agentmemory の MCP サーバーを配線する場合、Claude Code は `${CLAUDE_PLUGIN_ROOT}` を一切解決しないため、hook スクリプトを `~/.claude/settings.json`(既定のパス) 内の絶対パスに向ける必要があります。これらのパスには通常 agentmemory のバージョンが埋め込まれる(例: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)ため、次のアップグレードで全 hook が静かに壊れます。 回避策: @@ -452,7 +452,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -同じ hook コマンドを `~/.claude/settings.json` にマージし、現在インストールされている `@agentmemory/agentmemory` パッケージの同梱 `plugin/` ディレクトリに解決された絶対パスを書き込みます。agentmemory をアップグレードしたら、このコマンドを再実行してパスを更新してください。同じファイル内のユーザーエントリは保持され、以前の agentmemory エントリだけが置き換えられます。`/plugin install` の経路が推奨アプローチであることに変わりはありません。 +このコマンドは MCP サーバーを設定し、同梱の hook を Claude Code のユーザー設定にマージします。`CLAUDE_CONFIG_DIR` が未設定、空、または空白のみの場合、MCP には `~/.claude.json`、hook には `~/.claude/settings.json` を使います。それ以外のディレクトリ値は、前後の空白を含めて指定どおりに使われます。カスタムディレクトリを使う場合は、このコマンドと Claude Code の両方に同じ空でない `CLAUDE_CONFIG_DIR` の値を設定してください。その場合、ファイルはそれぞれ `$CLAUDE_CONFIG_DIR/.claude.json` と `$CLAUDE_CONFIG_DIR/settings.json` になります。コネクターが AgentMemory の `.env` から値を読み込む場合でも、Claude Code 自身の起動環境にこの値を設定する必要があります。このコマンドを実行する前にカスタムディレクトリを作成してください。存在しない場合、Claude Code は未検出としてスキップされます。shell の値が空白のみの場合は、Claude Code の起動前に `CLAUDE_CONFIG_DIR` を解除し、Claude Code 側でも既定のプロファイルが使われるようにしてください。絶対パスを使ってください。相対パスは作業ディレクトリを基準に解決されるため、両方のコマンドを同じディレクトリから実行する必要があります。 + +Hook コマンドは、インストール済みパッケージに同梱された `plugin/` ディレクトリへの絶対パスを使います。agentmemory のアップグレード後にコマンドを再実行して、これらのパスを更新してください。設定ファイル内のユーザーのエントリは保持され、以前の agentmemory のエントリだけが置き換えられます。引き続き `/plugin install` の利用を推奨します。 リモートや保護されたデプロイでは、`AGENTMEMORY_URL` と `AGENTMEMORY_SECRET` を設定して Claude Code を起動してください。プラグインはこの両方の値を同梱の MCP サーバーに渡します。`AGENTMEMORY_URL` が空の場合、MCP shim は `http://localhost:3111` にフォールバックします。 ### Codex CLI(Codex プラグインプラットフォーム) diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md index 68a70a99f8..6d60a7874b 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -442,7 +442,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### 플러그인 설치 없이 Claude Code 사용 (MCP 독립형 경로) -`/plugin install`을 사용하는 대신 `~/.claude.json`을 통해 agentmemory의 MCP 서버를 직접 연결하면, Claude Code는 `${CLAUDE_PLUGIN_ROOT}`를 해석하지 못하므로 `~/.claude/settings.json`의 hook 스크립트를 절대 경로로 지정해야 합니다. 이런 경로는 보통 agentmemory 버전을 포함하기 때문에(예: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), 다음 업그레이드에서 모든 hook이 조용히 깨질 수 있습니다. +`/plugin install`을 사용하는 대신 `~/.claude.json` (기본 경로)을 통해 agentmemory의 MCP 서버를 직접 연결하면, Claude Code는 `${CLAUDE_PLUGIN_ROOT}`를 해석하지 못하므로 `~/.claude/settings.json` (기본 경로)의 hook 스크립트를 절대 경로로 지정해야 합니다. 이런 경로는 보통 agentmemory 버전을 포함하기 때문에(예: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), 다음 업그레이드에서 모든 hook이 조용히 깨질 수 있습니다. 해결책: @@ -450,7 +450,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -이 명령은 현재 설치된 `@agentmemory/agentmemory` 패키지의 번들된 `plugin/` 디렉터리로 해석된 절대 경로를 사용해, 동일한 hook 명령을 `~/.claude/settings.json`에 병합합니다. agentmemory를 업그레이드한 뒤에는 동일한 명령을 다시 실행해서 경로를 갱신하십시오. 같은 파일의 사용자 항목은 보존되며, 이전 agentmemory 항목만 교체됩니다. `/plugin install` 경로를 사용하는 것이 여전히 권장되는 방식입니다. +이 명령은 MCP 서버를 구성하고 번들 hook을 Claude Code의 사용자 설정에 병합합니다. `CLAUDE_CONFIG_DIR`가 설정되지 않았거나 비어 있거나 공백만 포함하면 MCP에는 `~/.claude.json`을, hook에는 `~/.claude/settings.json`을 사용합니다. 그 밖의 디렉터리 값은 앞뒤 공백을 포함해 입력한 그대로 사용합니다. 사용자 지정 디렉터리를 사용하려면 이 명령과 Claude Code 양쪽에 `CLAUDE_CONFIG_DIR`를 동일한 비어 있지 않은 값으로 설정하세요. 그러면 각각 `$CLAUDE_CONFIG_DIR/.claude.json`과 `$CLAUDE_CONFIG_DIR/settings.json`을 사용합니다. 커넥터가 AgentMemory의 `.env`에서 값을 읽더라도 Claude Code 자체의 실행 환경에 이 값이 전달되어야 합니다. 이 명령을 실행하기 전에 사용자 지정 디렉터리를 만드세요. 디렉터리가 없으면 커넥터는 Claude Code를 감지하지 못한 것으로 처리하고 건너뜁니다. shell 값이 공백만 포함하면 Claude Code를 시작하기 전에 `CLAUDE_CONFIG_DIR`를 해제하여 Claude Code도 기본 프로필을 사용하도록 하세요. 절대 경로를 사용하세요. 상대 경로는 작업 디렉터리를 기준으로 해석되므로 두 명령을 같은 디렉터리에서 실행해야 합니다. + +Hook 명령은 설치된 패키지에 포함된 `plugin/` 디렉터리의 절대 경로를 사용합니다. agentmemory를 업그레이드한 후 명령을 다시 실행하여 경로를 갱신하세요. 설정 파일에 있는 사용자 항목은 유지되며, 이전 agentmemory 항목만 교체됩니다. `/plugin install` 사용을 계속 권장합니다. 원격 또는 보호된 배포의 경우, `AGENTMEMORY_URL`과 `AGENTMEMORY_SECRET`을 설정한 채로 Claude Code를 실행하십시오. 플러그인은 두 값을 모두 번들된 MCP 서버로 전달합니다. `AGENTMEMORY_URL`이 비어 있으면 MCP shim은 `http://localhost:3111`을 사용합니다. ### Codex CLI (Codex 플러그인 플랫폼) diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md index 906c9afed5..d7c70aab9a 100644 --- a/READMEs/README.nb-NO.md +++ b/READMEs/README.nb-NO.md @@ -439,7 +439,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code uten plugin-installasjon (MCP-frittstående vei) -Hvis du kobler agentmemorys MCP-server direkte gjennom `~/.claude.json` i stedet for å bruke `/plugin install`, løser Claude Code aldri opp `${CLAUDE_PLUGIN_ROOT}`, og du må peke hook-skriptene til absolutte stier i `~/.claude/settings.json`. Disse stiene bygger typisk inn agentmemory-versjonen (f.eks. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så neste oppgradering knekker stille hver hook. +Hvis du kobler agentmemorys MCP-server direkte gjennom `~/.claude.json` (standardsti) i stedet for å bruke `/plugin install`, løser Claude Code aldri opp `${CLAUDE_PLUGIN_ROOT}`, og du må peke hook-skriptene til absolutte stier i `~/.claude/settings.json` (standardsti). Disse stiene bygger typisk inn agentmemory-versjonen (f.eks. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så neste oppgradering knekker stille hver hook. Løsning: @@ -447,7 +447,9 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Dette slår sammen de samme hook-kommandoene inn i `~/.claude/settings.json` med absolutte stier løst opp mot den medfølgende `plugin/`-katalogen til den installerte `@agentmemory/agentmemory`-pakken. Kjør kommandoen på nytt etter at du har oppgradert agentmemory for å oppdatere stiene. Brukeroppføringer i samme fil bevares; kun tidligere agentmemory-oppføringer byttes ut. Å bruke `/plugin install`-veien er fortsatt den anbefalte metoden. +Denne kommandoen konfigurerer MCP-serveren og fletter de medfølgende hookene inn i Claude Codes brukerkonfigurasjon. Hvis `CLAUDE_CONFIG_DIR` ikke er satt, er tom eller bare inneholder blanktegn, brukes `~/.claude.json` for MCP og `~/.claude/settings.json` for hooks. Andre mappeverdier brukes nøyaktig som angitt, inkludert innledende og avsluttende blanktegn. For en egendefinert mappe setter du `CLAUDE_CONFIG_DIR` til den samme ikke-tomme verdien for både denne kommandoen og Claude Code; filene blir da henholdsvis `$CLAUDE_CONFIG_DIR/.claude.json` og `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code må motta verdien i oppstartsmiljøet sitt, selv om koblingen leser den fra AgentMemorys `.env`. Opprett den egendefinerte mappen før du kjører kommandoen; ellers hopper koblingen over Claude Code fordi det ikke blir oppdaget. Hvis verdien i skallet bare inneholder blanktegn, fjern `CLAUDE_CONFIG_DIR` fra miljøet før du starter Claude Code, slik at det også bruker standardprofilen. Bruk en absolutt sti. Relative stier tolkes fra arbeidsmappen, så begge kommandoene må kjøres fra samme mappe. + +Hook-kommandoene bruker absolutte stier til den installerte pakkens medfølgende `plugin/`-mappe. Kjør kommandoen på nytt etter en oppgradering av agentmemory for å oppdatere stiene. Brukerens egne oppføringer i konfigurasjonsfilene beholdes; bare tidligere agentmemory-oppføringer erstattes. Det anbefales fortsatt å bruke `/plugin install`. For eksterne eller beskyttede distribusjoner, start Claude Code med `AGENTMEMORY_URL` og `AGENTMEMORY_SECRET` satt. Pluginen sender begge verdiene videre til sin medfølgende MCP-server; når `AGENTMEMORY_URL` er tom, bruker MCP-shimmen `http://localhost:3111`. ### Codex CLI (Codex-plugin-plattformen) diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md index 82f7752da7..b9b607267c 100644 --- a/READMEs/README.nl-NL.md +++ b/READMEs/README.nl-NL.md @@ -439,7 +439,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code zonder de plugin-installatie (MCP-standalone pad) -Als je de MCP-server van agentmemory rechtstreeks via `~/.claude.json` koppelt in plaats van `/plugin install` te gebruiken, lost Claude Code `${CLAUDE_PLUGIN_ROOT}` nooit op en moet je hook-scripts naar absolute paden in `~/.claude/settings.json` laten verwijzen. Die paden bevatten doorgaans de agentmemory-versie (bijv. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), waardoor de volgende upgrade stilletjes elke hook stuk maakt. +Als je de MCP-server van agentmemory rechtstreeks via `~/.claude.json` (standaardpad) koppelt in plaats van `/plugin install` te gebruiken, lost Claude Code `${CLAUDE_PLUGIN_ROOT}` nooit op en moet je hook-scripts naar absolute paden in `~/.claude/settings.json` (standaardpad) laten verwijzen. Die paden bevatten doorgaans de agentmemory-versie (bijv. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), waardoor de volgende upgrade stilletjes elke hook stuk maakt. Workaround: @@ -447,7 +447,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -Dit voegt dezelfde hook-commando's samen in `~/.claude/settings.json`, met absolute paden die verwijzen naar de gebundelde `plugin/`-map van het momenteel geïnstalleerde `@agentmemory/agentmemory`-package. Voer het commando opnieuw uit na het upgraden van agentmemory om de paden te verversen. Gebruikersinvoer in hetzelfde bestand blijft behouden; alleen eerdere agentmemory-invoer wordt vervangen. Het `/plugin install`-pad blijft de aanbevolen aanpak. +Dit commando configureert de MCP-server en voegt de meegeleverde hooks samen met de gebruikersconfiguratie van Claude Code. Als `CLAUDE_CONFIG_DIR` niet is ingesteld, leeg is of alleen witruimte bevat, gebruikt het `~/.claude.json` voor MCP en `~/.claude/settings.json` voor hooks. Andere mapwaarden worden precies gebruikt zoals opgegeven, inclusief witruimte aan het begin en einde. Voor een aangepaste map stel je `CLAUDE_CONFIG_DIR` voor zowel dit commando als Claude Code in op dezelfde niet-lege waarde; de bestanden zijn dan respectievelijk `$CLAUDE_CONFIG_DIR/.claude.json` en `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code moet deze waarde ontvangen in zijn opstartomgeving, ook als de connector die uit het `.env`-bestand van AgentMemory leest. Maak de aangepaste map aan voordat je dit commando uitvoert; anders slaat de connector Claude Code over omdat het niet wordt gedetecteerd. Als de waarde in de shell alleen witruimte bevat, verwijder dan `CLAUDE_CONFIG_DIR` uit de omgeving voordat je Claude Code start, zodat het ook het standaardprofiel gebruikt. Gebruik een absoluut pad. Relatieve paden worden vanuit de werkmap bepaald, dus beide opdrachten moeten vanuit dezelfde map worden uitgevoerd. + +Hook-commando’s gebruiken absolute paden naar de meegeleverde map `plugin/` van het geïnstalleerde pakket. Voer het commando na het upgraden van agentmemory opnieuw uit om deze paden te vernieuwen. Gebruikersinvoer in de configuratiebestanden blijft behouden; alleen eerdere agentmemory-invoer wordt vervangen. Het gebruik van `/plugin install` blijft de aanbevolen aanpak. Voor remote of beveiligde deployments start je Claude Code met `AGENTMEMORY_URL` en `AGENTMEMORY_SECRET` ingesteld. De plugin geeft beide waarden door aan zijn gebundelde MCP-server; wanneer `AGENTMEMORY_URL` leeg is, gebruikt de MCP-shim `http://localhost:3111`. ### Codex CLI (Codex-pluginplatform) diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md index bc03deaebe..2187b03456 100644 --- a/READMEs/README.pl-PL.md +++ b/READMEs/README.pl-PL.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code bez instalacji pluginu (ścieżka samodzielnego MCP) -Jeśli podłączasz serwer MCP agentmemory bezpośrednio przez `~/.claude.json` zamiast używać `/plugin install`, Claude Code nigdy nie rozwiąże `${CLAUDE_PLUGIN_ROOT}` i musisz wskazać skryptom hooków bezwzględne ścieżki w `~/.claude/settings.json`. Te ścieżki zwykle zawierają w sobie wersję agentmemory (np. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), więc kolejna aktualizacja po cichu psuje każdy hook. +Jeśli podłączasz serwer MCP agentmemory bezpośrednio przez `~/.claude.json` (domyślna ścieżka) zamiast używać `/plugin install`, Claude Code nigdy nie rozwiąże `${CLAUDE_PLUGIN_ROOT}` i musisz wskazać skryptom hooków bezwzględne ścieżki w `~/.claude/settings.json` (domyślna ścieżka). Te ścieżki zwykle zawierają w sobie wersję agentmemory (np. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), więc kolejna aktualizacja po cichu psuje każdy hook. Rozwiązanie zastępcze: @@ -452,7 +452,9 @@ Rozwiązanie zastępcze: agentmemory connect claude-code --with-hooks ``` -To scala te same komendy hooków do `~/.claude/settings.json`, z bezwzględnymi ścieżkami rozwiązanymi do dołączonego katalogu `plugin/` aktualnie zainstalowanego pakietu `@agentmemory/agentmemory`. Uruchom tę komendę ponownie po aktualizacji agentmemory, aby odświeżyć ścieżki. Wpisy użytkownika w tym samym pliku są zachowywane; zastępowane są tylko wcześniejsze wpisy agentmemory. Zalecanym podejściem pozostaje ścieżka `/plugin install`. +Ta komenda konfiguruje serwer MCP i scala dołączone hooki z konfiguracją użytkownika Claude Code. Jeśli `CLAUDE_CONFIG_DIR` nie jest ustawiona, jest pusta lub zawiera tylko białe znaki, używa `~/.claude.json` dla MCP i `~/.claude/settings.json` dla hooków. Pozostałe wartości katalogu są używane dokładnie w podanej postaci, łącznie z białymi znakami na początku i końcu. Aby użyć własnego katalogu, ustaw `CLAUDE_CONFIG_DIR` na tę samą niepustą wartość dla tej komendy i Claude Code; pliki będą wtedy miały ścieżki odpowiednio `$CLAUDE_CONFIG_DIR/.claude.json` i `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code musi otrzymać tę wartość w swoim środowisku uruchomieniowym, nawet jeśli konektor odczytuje ją z pliku `.env` AgentMemory. Utwórz własny katalog przed uruchomieniem tej komendy; w przeciwnym razie konektor pominie Claude Code jako niewykryty. Jeśli wartość w powłoce zawiera tylko białe znaki, usuń `CLAUDE_CONFIG_DIR` ze środowiska przed uruchomieniem Claude Code, aby również używał profilu domyślnego. Użyj ścieżki bezwzględnej. Ścieżki względne są rozwiązywane względem katalogu roboczego, więc oba polecenia muszą być uruchamiane z tego samego katalogu. + +Komendy hooków używają bezwzględnych ścieżek do katalogu `plugin/` dołączonego do zainstalowanego pakietu. Po aktualizacji agentmemory uruchom komendę ponownie, aby odświeżyć te ścieżki. Wpisy użytkownika w plikach konfiguracyjnych są zachowywane; zastępowane są tylko poprzednie wpisy agentmemory. Zalecanym sposobem pozostaje użycie `/plugin install`. Dla zdalnych lub chronionych wdrożeń uruchom Claude Code z ustawionymi `AGENTMEMORY_URL` i `AGENTMEMORY_SECRET`. Plugin przekazuje obie wartości dalej do swojego dołączonego serwera MCP; gdy `AGENTMEMORY_URL` jest puste, shim MCP używa `http://localhost:3111`. ### Codex CLI (platforma pluginów Codex) diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md index c057540f82..e4f9122860 100644 --- a/READMEs/README.pt-BR.md +++ b/READMEs/README.pt-BR.md @@ -439,7 +439,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code sem instalar o plugin (caminho MCP standalone) -Se você cabear o servidor MCP do agentmemory via `~/.claude.json` diretamente em vez de usar `/plugin install`, o Claude Code nunca resolve `${CLAUDE_PLUGIN_ROOT}` e você tem que apontar os scripts de hook para caminhos absolutos em `~/.claude/settings.json`. Esses caminhos tipicamente embutem a versão do agentmemory (ex.: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), então a próxima atualização quebra silenciosamente todos os hooks. +Se você cabear o servidor MCP do agentmemory via `~/.claude.json` (caminho padrão) diretamente em vez de usar `/plugin install`, o Claude Code nunca resolve `${CLAUDE_PLUGIN_ROOT}` e você tem que apontar os scripts de hook para caminhos absolutos em `~/.claude/settings.json` (caminho padrão). Esses caminhos tipicamente embutem a versão do agentmemory (ex.: `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), então a próxima atualização quebra silenciosamente todos os hooks. Contorno: @@ -447,7 +447,9 @@ Contorno: agentmemory connect claude-code --with-hooks ``` -Isso mescla os mesmos comandos de hook em `~/.claude/settings.json` com caminhos absolutos resolvidos para o diretório `plugin/` empacotado do pacote `@agentmemory/agentmemory` atualmente instalado. Rode o comando novamente após atualizar o agentmemory para atualizar os caminhos. Entradas de usuário no mesmo arquivo são preservadas; apenas entradas anteriores do agentmemory são substituídas. Usar o caminho `/plugin install` continua sendo a abordagem recomendada. +Este comando configura o servidor MCP e mescla os hooks incluídos à configuração de usuário do Claude Code. Se `CLAUDE_CONFIG_DIR` não estiver definida, estiver vazia ou contiver apenas espaços em branco, ele usa `~/.claude.json` para MCP e `~/.claude/settings.json` para hooks. Os demais valores de diretório são usados exatamente como fornecidos, incluindo espaços em branco no início e no fim. Para usar um diretório personalizado, defina `CLAUDE_CONFIG_DIR` com o mesmo valor não vazio para este comando e para o Claude Code; os arquivos serão então `$CLAUDE_CONFIG_DIR/.claude.json` e `$CLAUDE_CONFIG_DIR/settings.json`, respectivamente. O Claude Code deve receber esse valor no ambiente em que é iniciado, mesmo que o conector o leia do arquivo `.env` do AgentMemory. Crie o diretório personalizado antes de executar este comando; caso contrário, o conector ignora o Claude Code por não detectá-lo. Se o valor no shell contiver apenas espaços em branco, remova `CLAUDE_CONFIG_DIR` do ambiente antes de iniciar o Claude Code para que ele também use o perfil padrão. Use um caminho absoluto. Caminhos relativos são resolvidos a partir do diretório de trabalho, portanto os dois comandos devem ser executados no mesmo diretório. + +Os comandos dos hooks usam caminhos absolutos para o diretório `plugin/` incluído no pacote instalado. Execute o comando novamente após atualizar o agentmemory para atualizar esses caminhos. As entradas de usuário nos arquivos de configuração são preservadas; apenas as entradas anteriores do agentmemory são substituídas. O uso de `/plugin install` continua sendo a abordagem recomendada. Para deploys remotos ou protegidos, inicie o Claude Code com `AGENTMEMORY_URL` e `AGENTMEMORY_SECRET` definidos. O plugin repassa ambos os valores para seu servidor MCP empacotado; quando `AGENTMEMORY_URL` está vazio, o shim MCP usa `http://localhost:3111`. ### Codex CLI (plataforma de plugins do Codex) diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md index 4df36d9384..95b0455b6f 100644 --- a/READMEs/README.pt-PT.md +++ b/READMEs/README.pt-PT.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code sem instalar o plugin (caminho MCP standalone) -Se ligar o servidor MCP do agentmemory através de `~/.claude.json` diretamente, em vez de usar `/plugin install`, o Claude Code nunca resolve `${CLAUDE_PLUGIN_ROOT}` e tem de apontar os scripts de hook para caminhos absolutos em `~/.claude/settings.json`. Esses caminhos normalmente incorporam a versão do agentmemory (por exemplo, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), por isso a atualização seguinte quebra silenciosamente todos os hooks. +Se ligar o servidor MCP do agentmemory através de `~/.claude.json` (caminho predefinido) diretamente, em vez de usar `/plugin install`, o Claude Code nunca resolve `${CLAUDE_PLUGIN_ROOT}` e tem de apontar os scripts de hook para caminhos absolutos em `~/.claude/settings.json` (caminho predefinido). Esses caminhos normalmente incorporam a versão do agentmemory (por exemplo, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), por isso a atualização seguinte quebra silenciosamente todos os hooks. Solução alternativa: @@ -449,7 +449,9 @@ Solução alternativa: agentmemory connect claude-code --with-hooks ``` -Isto combina os mesmos comandos de hook em `~/.claude/settings.json` com caminhos absolutos resolvidos para o diretório `plugin/` empacotado do pacote `@agentmemory/agentmemory` atualmente instalado. Volte a executar o comando depois de atualizar o agentmemory para atualizar os caminhos. As entradas do utilizador no mesmo ficheiro são preservadas; só as entradas anteriores do agentmemory são substituídas. Usar o caminho `/plugin install` continua a ser a abordagem recomendada. +Este comando configura o servidor MCP e funde os hooks incluídos com a configuração de utilizador do Claude Code. Se `CLAUDE_CONFIG_DIR` não estiver definida, estiver vazia ou contiver apenas espaços em branco, usa `~/.claude.json` para MCP e `~/.claude/settings.json` para os hooks. Os restantes valores de diretório são usados exatamente como fornecidos, incluindo espaços em branco no início e no fim. Para usar um diretório personalizado, defina `CLAUDE_CONFIG_DIR` com o mesmo valor não vazio para este comando e para o Claude Code; os ficheiros serão então `$CLAUDE_CONFIG_DIR/.claude.json` e `$CLAUDE_CONFIG_DIR/settings.json`, respetivamente. O Claude Code tem de receber este valor no seu ambiente de arranque, mesmo que o conector o leia do ficheiro `.env` do AgentMemory. Crie o diretório personalizado antes de executar este comando; caso contrário, o conector ignora o Claude Code por não o detetar. Se o valor na shell contiver apenas espaços em branco, remova `CLAUDE_CONFIG_DIR` do ambiente antes de iniciar o Claude Code para que também use o perfil predefinido. Utilize um caminho absoluto. Os caminhos relativos são resolvidos a partir do diretório de trabalho, pelo que ambos os comandos têm de ser executados no mesmo diretório. + +Os comandos dos hooks usam caminhos absolutos para o diretório `plugin/` incluído no pacote instalado. Volte a executar o comando depois de atualizar o agentmemory para atualizar esses caminhos. As entradas do utilizador nos ficheiros de configuração são preservadas; só as entradas anteriores do agentmemory são substituídas. O uso de `/plugin install` continua a ser a abordagem recomendada. Para implementações remotas ou protegidas, inicie o Claude Code com `AGENTMEMORY_URL` e `AGENTMEMORY_SECRET` definidas. O plugin passa ambos os valores ao seu servidor MCP empacotado; quando `AGENTMEMORY_URL` está vazia, o shim MCP usa `http://localhost:3111`. ### Codex CLI (plataforma de plugins do Codex) diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md index 04daaa1692..70b9f9f03d 100644 --- a/READMEs/README.ro-RO.md +++ b/READMEs/README.ro-RO.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code fără instalarea plugin-ului (cale MCP independentă) -Dacă conectezi serverul MCP al agentmemory direct prin `~/.claude.json`, în loc să folosești `/plugin install`, Claude Code nu rezolvă niciodată `${CLAUDE_PLUGIN_ROOT}` și trebuie să indici scripturile de hook prin căi absolute în `~/.claude/settings.json`. Aceste căi includ de obicei versiunea agentmemory (de ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), astfel încât următoarea actualizare rupe silențios fiecare hook. +Dacă conectezi serverul MCP al agentmemory direct prin `~/.claude.json` (cale implicită), în loc să folosești `/plugin install`, Claude Code nu rezolvă niciodată `${CLAUDE_PLUGIN_ROOT}` și trebuie să indici scripturile de hook prin căi absolute în `~/.claude/settings.json` (cale implicită). Aceste căi includ de obicei versiunea agentmemory (de ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), astfel încât următoarea actualizare rupe silențios fiecare hook. Soluție alternativă: @@ -454,7 +454,9 @@ Soluție alternativă: agentmemory connect claude-code --with-hooks ``` -Aceasta îmbină aceleași comenzi de hook în `~/.claude/settings.json`, cu căi absolute rezolvate către directorul `plugin/` inclus în pachetul `@agentmemory/agentmemory` instalat curent. Rulează din nou comanda după actualizarea agentmemory, pentru a reîmprospăta căile. Intrările proprii ale utilizatorului din același fișier sunt păstrate; sunt înlocuite doar intrările anterioare ale agentmemory. Folosirea căii `/plugin install` rămâne abordarea recomandată. +Această comandă configurează serverul MCP și îmbină hook-urile incluse cu configurația de utilizator a Claude Code. Dacă `CLAUDE_CONFIG_DIR` nu este setată, este goală sau conține doar spații albe, folosește `~/.claude.json` pentru MCP și `~/.claude/settings.json` pentru hook-uri. Celelalte valori de director sunt folosite exact așa cum sunt furnizate, inclusiv spațiile albe de la început și de la sfârșit. Pentru un director personalizat, setați `CLAUDE_CONFIG_DIR` la aceeași valoare nevidă atât pentru această comandă, cât și pentru Claude Code; fișierele vor fi atunci `$CLAUDE_CONFIG_DIR/.claude.json` și, respectiv, `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code trebuie să primească această valoare în mediul său de pornire, chiar dacă conectorul o citește din fișierul `.env` al AgentMemory. Creați directorul personalizat înainte de a rula această comandă; altfel, conectorul omite Claude Code deoarece nu îl detectează. Dacă valoarea din shell conține doar spații albe, eliminați `CLAUDE_CONFIG_DIR` din mediu înainte de a porni Claude Code, pentru ca și acesta să folosească profilul implicit. Folosește o cale absolută. Căile relative sunt interpretate pornind de la directorul de lucru, deci ambele comenzi trebuie executate din același director. + +Comenzile hook-urilor folosesc căi absolute către directorul `plugin/` inclus în pachetul instalat. Rulați din nou comanda după actualizarea agentmemory pentru a reîmprospăta aceste căi. Intrările utilizatorului din fișierele de configurare sunt păstrate; sunt înlocuite doar intrările anterioare ale agentmemory. Utilizarea `/plugin install` rămâne abordarea recomandată. Pentru deployment-uri la distanță sau protejate, pornește Claude Code cu `AGENTMEMORY_URL` și `AGENTMEMORY_SECRET` setate. Plugin-ul transmite ambele valori către serverul MCP inclus; când `AGENTMEMORY_URL` este gol, shim-ul MCP folosește `http://localhost:3111`. ### Codex CLI (platforma de plugin-uri Codex) diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md index 3dc2bd036b..a9673fe347 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code без установки плагина (путь MCP-standalone) -Если подключать MCP-сервер agentmemory через `~/.claude.json` напрямую, минуя `/plugin install`, Claude Code никогда не разрешит `${CLAUDE_PLUGIN_ROOT}`, и в `~/.claude/settings.json` придётся прописывать абсолютные пути к скриптам хуков. Эти пути обычно включают версию agentmemory (например, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), так что следующее обновление тихо ломает каждый хук. +Если подключать MCP-сервер agentmemory через `~/.claude.json` (путь по умолчанию) напрямую, минуя `/plugin install`, Claude Code никогда не разрешит `${CLAUDE_PLUGIN_ROOT}`, и в `~/.claude/settings.json` (путь по умолчанию) придётся прописывать абсолютные пути к скриптам хуков. Эти пути обычно включают версию agentmemory (например, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), так что следующее обновление тихо ломает каждый хук. Обходное решение: @@ -454,7 +454,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Это вливает те же команды хуков в `~/.claude/settings.json` с абсолютными путями, разрешёнными в каталог `plugin/` текущего установленного пакета `@agentmemory/agentmemory`. После обновления agentmemory запустите команду ещё раз, чтобы освежить пути. Записи пользователя в этом файле сохраняются; заменяются только предыдущие записи agentmemory. Рекомендуемым способом остаётся путь через `/plugin install`. +Эта команда настраивает MCP-сервер и добавляет поставляемые с пакетом хуки в пользовательскую конфигурацию Claude Code. Если `CLAUDE_CONFIG_DIR` не задана, пуста или содержит только пробельные символы, для MCP используется `~/.claude.json`, а для хуков — `~/.claude/settings.json`. Остальные значения каталога используются без изменений, включая пробельные символы в начале и конце. Чтобы использовать свой каталог, задайте одинаковое непустое значение `CLAUDE_CONFIG_DIR` для этой команды и Claude Code; тогда файлы будут находиться в `$CLAUDE_CONFIG_DIR/.claude.json` и `$CLAUDE_CONFIG_DIR/settings.json` соответственно. Claude Code должен получить это значение в своём окружении при запуске, даже если коннектор читает его из файла `.env` AgentMemory. Создайте свой каталог перед выполнением этой команды; иначе коннектор пропустит Claude Code как не обнаруженный. Если значение в оболочке содержит только пробельные символы, удалите `CLAUDE_CONFIG_DIR` из окружения перед запуском Claude Code, чтобы он также использовал профиль по умолчанию. Используйте абсолютный путь. Относительные пути разрешаются от рабочего каталога, поэтому обе команды нужно запускать из одного каталога. + +Команды хуков используют абсолютные пути к каталогу `plugin/` из установленного пакета. После обновления agentmemory запустите команду ещё раз, чтобы обновить эти пути. Пользовательские записи в файлах конфигурации сохраняются; заменяются только предыдущие записи agentmemory. Использование `/plugin install` остаётся рекомендуемым способом. Для удалённых или защищённых развёртываний запускайте Claude Code с заданными `AGENTMEMORY_URL` и `AGENTMEMORY_SECRET`. Плагин пробрасывает оба значения во встроенный MCP-сервер; если `AGENTMEMORY_URL` пуст, MCP-shim использует `http://localhost:3111`. ### Codex CLI (платформа плагинов Codex) diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md index a3cc9e47c3..66ecf10b29 100644 --- a/READMEs/README.sv-SE.md +++ b/READMEs/README.sv-SE.md @@ -441,7 +441,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code utan plugin-installationen (fristående MCP-väg) -Om du kopplar in agentmemorys MCP-server via `~/.claude.json` direkt istället för att använda `/plugin install`, löser Claude Code aldrig upp `${CLAUDE_PLUGIN_ROOT}`, och du måste peka hook-skripten mot absoluta sökvägar i `~/.claude/settings.json`. Dessa sökvägar innehåller vanligtvis agentmemory-versionen (t.ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så nästa uppgradering bryter varje hook i det tysta. +Om du kopplar in agentmemorys MCP-server via `~/.claude.json` (standardsökväg) direkt istället för att använda `/plugin install`, löser Claude Code aldrig upp `${CLAUDE_PLUGIN_ROOT}`, och du måste peka hook-skripten mot absoluta sökvägar i `~/.claude/settings.json` (standardsökväg). Dessa sökvägar innehåller vanligtvis agentmemory-versionen (t.ex. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), så nästa uppgradering bryter varje hook i det tysta. Lösning: @@ -449,7 +449,9 @@ Lösning: agentmemory connect claude-code --with-hooks ``` -Detta slår samman samma hook-kommandon i `~/.claude/settings.json` med absoluta sökvägar som löses upp till den medföljande `plugin/`-katalogen i det för tillfället installerade paketet `@agentmemory/agentmemory`. Kör kommandot igen efter att du har uppgraderat agentmemory för att uppdatera sökvägarna. Användarens egna poster i samma fil bevaras; endast tidigare agentmemory-poster ersätts. Att använda vägen `/plugin install` är fortfarande den rekommenderade metoden. +Det här kommandot konfigurerar MCP-servern och slår samman de medföljande hookarna med Claude Codes användarkonfiguration. Om `CLAUDE_CONFIG_DIR` inte är satt, är tom eller bara innehåller blanktecken används `~/.claude.json` för MCP och `~/.claude/settings.json` för hooks. Övriga katalogvärden används exakt som de anges, inklusive inledande och avslutande blanktecken. För en egen katalog ställer du in `CLAUDE_CONFIG_DIR` till samma icke-tomma värde för både det här kommandot och Claude Code; filerna blir då `$CLAUDE_CONFIG_DIR/.claude.json` respektive `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code måste få värdet i sin startmiljö, även om anslutningsmodulen läser det från AgentMemorys `.env`. Skapa den egna katalogen innan du kör kommandot; annars hoppar anslutningsmodulen över Claude Code eftersom det inte upptäcks. Om värdet i skalet bara innehåller blanktecken tar du bort `CLAUDE_CONFIG_DIR` från miljön innan du startar Claude Code, så att det också använder standardprofilen. Använd en absolut sökväg. Relativa sökvägar utgår från arbetskatalogen, så båda kommandona måste köras från samma katalog. + +Hook-kommandona använder absoluta sökvägar till det installerade paketets medföljande katalog `plugin/`. Kör kommandot igen efter en uppgradering av agentmemory för att uppdatera sökvägarna. Användarens egna poster i konfigurationsfilerna bevaras; bara tidigare agentmemory-poster ersätts. Att använda `/plugin install` är fortfarande det rekommenderade sättet. För fjärr- eller skyddade driftsättningar, starta Claude Code med `AGENTMEMORY_URL` och `AGENTMEMORY_SECRET` satta. Plugin-programmet skickar båda värdena vidare till sin medföljande MCP-server; när `AGENTMEMORY_URL` är tomt använder MCP-shimmen `http://localhost:3111`. ### Codex CLI (Codex-plugin-plattformen) diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md index 2c33f0df62..1b72209ffc 100644 --- a/READMEs/README.th-TH.md +++ b/READMEs/README.th-TH.md @@ -438,7 +438,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code without the plugin install (MCP-standalone path) -ถ้าคุณเชื่อมต่อ MCP server ของ agentmemory ผ่าน `~/.claude.json` โดยตรงแทนการใช้ `/plugin install`, Claude Code จะไม่ resolve `${CLAUDE_PLUGIN_ROOT}` เลย และคุณต้องชี้ hook script ไปที่ absolute path ใน `~/.claude/settings.json` path เหล่านั้นมักจะฝังเวอร์ชันของ agentmemory ไว้ด้วย (เช่น `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`) ดังนั้นการ upgrade ครั้งต่อไปจะทำให้ hook ทุกตัวพังแบบไม่มีเสียงเตือน +ถ้าคุณเชื่อมต่อ MCP server ของ agentmemory ผ่าน `~/.claude.json` (เส้นทางเริ่มต้น) โดยตรงแทนการใช้ `/plugin install`, Claude Code จะไม่ resolve `${CLAUDE_PLUGIN_ROOT}` เลย และคุณต้องชี้ hook script ไปที่ absolute path ใน `~/.claude/settings.json` (เส้นทางเริ่มต้น) path เหล่านั้นมักจะฝังเวอร์ชันของ agentmemory ไว้ด้วย (เช่น `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`) ดังนั้นการ upgrade ครั้งต่อไปจะทำให้ hook ทุกตัวพังแบบไม่มีเสียงเตือน วิธีแก้: @@ -446,7 +446,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -คำสั่งนี้จะ merge คำสั่ง hook เดียวกันเข้าไปใน `~/.claude/settings.json` โดยใช้ absolute path ที่ resolve ไปยัง directory `plugin/` ที่แพ็กเกจ `@agentmemory/agentmemory` เวอร์ชันที่ติดตั้งอยู่ในปัจจุบัน ให้รันคำสั่งนี้ซ้ำอีกครั้งหลัง upgrade agentmemory เพื่อ refresh path รายการของผู้ใช้ในไฟล์เดียวกันจะยังคงอยู่ มีเพียงรายการของ agentmemory เดิมที่จะถูกแทนที่ การใช้เส้นทาง `/plugin install` ยังคงเป็นวิธีที่แนะนำ +คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ MCP และรวม hook ที่ให้มากับแพ็กเกจเข้ากับการกำหนดค่าผู้ใช้ของ Claude Code หากไม่ได้ตั้งค่า `CLAUDE_CONFIG_DIR` มีค่าว่าง หรือมีแต่ช่องว่าง จะใช้ `~/.claude.json` สำหรับ MCP และ `~/.claude/settings.json` สำหรับ hook ค่าไดเรกทอรีอื่นจะถูกใช้ตามที่ระบุทุกตัวอักษร รวมถึงช่องว่างที่ต้นและท้ายค่า หากต้องการใช้ไดเรกทอรีที่กำหนดเอง ให้ตั้งค่า `CLAUDE_CONFIG_DIR` เป็นค่าเดียวกันที่ไม่ว่างทั้งสำหรับคำสั่งนี้และ Claude Code โดยไฟล์ที่ใช้จะเป็น `$CLAUDE_CONFIG_DIR/.claude.json` และ `$CLAUDE_CONFIG_DIR/settings.json` ตามลำดับ Claude Code ต้องได้รับค่านี้ในสภาพแวดล้อมที่ใช้เริ่มโปรแกรม แม้ว่าตัวเชื่อมต่อจะอ่านค่าจากไฟล์ `.env` ของ AgentMemory ก็ตาม สร้างไดเรกทอรีที่กำหนดเองก่อนรันคำสั่งนี้ มิฉะนั้นตัวเชื่อมต่อจะข้าม Claude Code เนื่องจากตรวจไม่พบ หากค่าใน shell มีแต่ช่องว่าง ให้ยกเลิกการตั้งค่า `CLAUDE_CONFIG_DIR` ก่อนเริ่ม Claude Code เพื่อให้ใช้โปรไฟล์เริ่มต้นเช่นกัน ใช้พาธแบบสัมบูรณ์ พาธแบบสัมพัทธ์จะอ้างอิงจากไดเรกทอรีทำงาน ดังนั้นต้องเรียกใช้ทั้งสองคำสั่งจากไดเรกทอรีเดียวกัน + +คำสั่ง hook ใช้เส้นทางแบบสัมบูรณ์ไปยังไดเรกทอรี `plugin/` ที่ให้มากับแพ็กเกจที่ติดตั้ง หลังอัปเกรด agentmemory ให้รันคำสั่งนี้อีกครั้งเพื่ออัปเดตเส้นทาง รายการของผู้ใช้ในไฟล์กำหนดค่าจะยังคงอยู่ โดยจะแทนที่เฉพาะรายการเดิมของ agentmemory เท่านั้น การใช้ `/plugin install` ยังคงเป็นแนวทางที่แนะนำ สำหรับการ deploy แบบ remote หรือแบบที่มีการป้องกัน ให้เปิด Claude Code โดยตั้งค่า `AGENTMEMORY_URL` และ `AGENTMEMORY_SECRET` ไว้ plugin จะส่งค่าทั้งสองนี้ต่อไปยัง MCP server ที่ bundle มาด้วย เมื่อ `AGENTMEMORY_URL` เป็นค่าว่าง MCP shim จะใช้ `http://localhost:3111` ### Codex CLI (Codex plugin platform) diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md index 60847a4785..9ae0a145a5 100644 --- a/READMEs/README.tl-PH.md +++ b/READMEs/README.tl-PH.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code nang walang plugin install (MCP-standalone path) -Kung i-wire mo ang MCP server ng agentmemory gamit ang `~/.claude.json` nang direkta sa halip na gamitin ang `/plugin install`, hindi kailanman nireresolba ng Claude Code ang `${CLAUDE_PLUGIN_ROOT}` at kailangan mong ituro ang hook scripts sa absolute paths sa `~/.claude/settings.json`. Karaniwang naka-embed sa mga path na ito ang bersyon ng agentmemory (hal. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), kaya tahimik na masisira ng susunod na upgrade ang bawat hook. +Kung i-wire mo ang MCP server ng agentmemory gamit ang `~/.claude.json` (default na path) nang direkta sa halip na gamitin ang `/plugin install`, hindi kailanman nireresolba ng Claude Code ang `${CLAUDE_PLUGIN_ROOT}` at kailangan mong ituro ang hook scripts sa absolute paths sa `~/.claude/settings.json` (default na path). Karaniwang naka-embed sa mga path na ito ang bersyon ng agentmemory (hal. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), kaya tahimik na masisira ng susunod na upgrade ang bawat hook. Workaround: @@ -452,7 +452,9 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -Pinagsasama nito ang parehong hook commands sa `~/.claude/settings.json` gamit ang absolute paths na nireresolba sa bundled `plugin/` directory ng kasalukuyang naka-install na `@agentmemory/agentmemory` package. Patakbuhin ulit ang command pagkatapos i-upgrade ang agentmemory para i-refresh ang mga path. Napapanatili ang mga entry ng user sa parehong file; ang mga nakaraang entry ng agentmemory lamang ang napapalitan. Ang paggamit ng `/plugin install` path ay nananatiling inirerekomendang paraan. +Kino-configure ng command na ito ang MCP server at pinagsasama ang mga bundled hook sa user configuration ng Claude Code. Kung hindi naka-set ang `CLAUDE_CONFIG_DIR`, blangko ito, o puro whitespace ang laman, ginagamit nito ang `~/.claude.json` para sa MCP at `~/.claude/settings.json` para sa mga hook. Ginagamit ang iba pang directory value nang eksakto sa ibinigay, kasama ang whitespace sa simula at dulo. Para sa custom na directory, itakda ang `CLAUDE_CONFIG_DIR` sa parehong hindi blangkong value para sa command na ito at sa Claude Code; ang mga file ay magiging `$CLAUDE_CONFIG_DIR/.claude.json` at `$CLAUDE_CONFIG_DIR/settings.json`, ayon sa pagkakasunod. Kailangang matanggap ng Claude Code ang value na ito sa environment na ginagamit sa paglulunsad nito, kahit binabasa ito ng connector mula sa `.env` ng AgentMemory. Gawin ang custom na directory bago patakbuhin ang command na ito; kung wala ito, lalaktawan ng connector ang Claude Code dahil hindi ito ma-detect. Kung puro whitespace ang value sa shell, alisin ang `CLAUDE_CONFIG_DIR` sa environment bago ilunsad ang Claude Code para gamitin din nito ang default na profile. Gumamit ng absolute path. Ang mga relative path ay nakabatay sa working directory, kaya dapat patakbuhin ang parehong command mula sa iisang directory. + +Gumagamit ang mga hook command ng absolute paths patungo sa bundled na `plugin/` directory ng naka-install na package. Patakbuhin muli ang command pagkatapos i-upgrade ang agentmemory upang i-refresh ang mga path. Pinananatili ang mga entry ng user sa mga configuration file; ang mga dating entry ng agentmemory lamang ang pinapalitan. Ang paggamit ng `/plugin install` pa rin ang inirerekomendang paraan. Para sa remote o protected deployment, patakbuhin ang Claude Code na naka-set ang `AGENTMEMORY_URL` at `AGENTMEMORY_SECRET`. Ipinapasa ng plugin ang dalawang value papunta sa bundled MCP server nito; kapag walang laman ang `AGENTMEMORY_URL`, gumagamit ang MCP shim ng `http://localhost:3111`. ### Codex CLI (Codex plugin platform) diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md index c414df3087..d9b39460f3 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Eklenti kurulumu olmadan Claude Code (MCP-bağımsız yol) -agentmemory'nin MCP sunucusunu `/plugin install` kullanmak yerine doğrudan `~/.claude.json` üzerinden bağlarsanız, Claude Code `${CLAUDE_PLUGIN_ROOT}`'u asla çözümlemez ve hook scriptlerini `~/.claude/settings.json` içinde absolute path'lere yöneltmeniz gerekir. Bu path'ler genellikle agentmemory sürümünü gömer (örn. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), bu yüzden bir sonraki yükseltme her hook'u sessizce bozar. +agentmemory'nin MCP sunucusunu `/plugin install` kullanmak yerine doğrudan `~/.claude.json` (varsayılan yol) üzerinden bağlarsanız, Claude Code `${CLAUDE_PLUGIN_ROOT}`'u asla çözümlemez ve hook scriptlerini `~/.claude/settings.json` (varsayılan yol) içinde absolute path'lere yöneltmeniz gerekir. Bu path'ler genellikle agentmemory sürümünü gömer (örn. `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), bu yüzden bir sonraki yükseltme her hook'u sessizce bozar. Geçici çözüm: @@ -454,7 +454,9 @@ Geçici çözüm: agentmemory connect claude-code --with-hooks ``` -Bu, aynı hook komutlarını, şu anda kurulu olan `@agentmemory/agentmemory` paketinin paketlenmiş `plugin/` dizinine çözümlenen absolute path'lerle `~/.claude/settings.json` içine birleştirir. Path'leri yenilemek için agentmemory'yi yükselttikten sonra komutu yeniden çalıştırın. Aynı dosyadaki kullanıcı girdileri korunur; yalnızca önceki agentmemory girdileri değiştirilir. `/plugin install` yolunu kullanmak, önerilen yaklaşım olmayı sürdürür. +Bu komut MCP sunucusunu yapılandırır ve paketle gelen hook’ları Claude Code’un kullanıcı yapılandırmasına birleştirir. `CLAUDE_CONFIG_DIR` ayarlanmamışsa, boşsa veya yalnızca boşluk karakterleri içeriyorsa MCP için `~/.claude.json`, hook’lar için `~/.claude/settings.json` kullanılır. Diğer dizin değerleri, baştaki ve sondaki boşluk karakterleri de dâhil olmak üzere aynen kullanılır. Özel bir dizin kullanmak için `CLAUDE_CONFIG_DIR` değerini hem bu komut hem de Claude Code için aynı, boş olmayan değere ayarlayın; dosyalar sırasıyla `$CLAUDE_CONFIG_DIR/.claude.json` ve `$CLAUDE_CONFIG_DIR/settings.json` olur. Bağlayıcı değeri AgentMemory’nin `.env` dosyasından okusa bile Claude Code bu değeri kendi başlatma ortamında almalıdır. Bu komutu çalıştırmadan önce özel dizini oluşturun; aksi hâlde bağlayıcı Claude Code’u algılanmadığı için atlar. Shell’deki değer yalnızca boşluk karakterleri içeriyorsa Claude Code’u başlatmadan önce `CLAUDE_CONFIG_DIR` değişkenini ortamdan kaldırın; böylece o da varsayılan profili kullanır. Mutlak bir yol kullanın. Göreli yollar çalışma dizinine göre çözümlenir; bu nedenle her iki komut da aynı dizinden çalıştırılmalıdır. + +Hook komutları, kurulu paketin içerdiği `plugin/` dizinine giden mutlak yolları kullanır. Bu yolları yenilemek için agentmemory’yi yükselttikten sonra komutu yeniden çalıştırın. Yapılandırma dosyalarındaki kullanıcı girdileri korunur; yalnızca önceki agentmemory girdileri değiştirilir. `/plugin install` kullanımı önerilen yaklaşım olmaya devam eder. Uzak veya korumalı dağıtımlar için Claude Code'u `AGENTMEMORY_URL` ve `AGENTMEMORY_SECRET` ayarlanmış şekilde başlatın. Eklenti, her iki değeri de paketlenmiş MCP sunucusuna iletir; `AGENTMEMORY_URL` boş olduğunda MCP shim'i `http://localhost:3111`'i kullanır. ### Codex CLI (Codex eklenti platformu) diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md index f6c7cbeffe..18768910b9 100644 --- a/READMEs/README.uk-UA.md +++ b/READMEs/README.uk-UA.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code без встановлення плагіна (автономний шлях MCP) -Якщо ви підключаєте MCP-сервер agentmemory напряму через `~/.claude.json`, а не через `/plugin install`, Claude Code ніколи не розгортає `${CLAUDE_PLUGIN_ROOT}`, і вам доведеться вказувати абсолютні шляхи до скриптів хуків у `~/.claude/settings.json`. Ці шляхи, як правило, містять версію agentmemory (наприклад, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), тому наступне оновлення непомітно зламає кожен хук. +Якщо ви підключаєте MCP-сервер agentmemory напряму через `~/.claude.json` (типовий шлях), а не через `/plugin install`, Claude Code ніколи не розгортає `${CLAUDE_PLUGIN_ROOT}`, і вам доведеться вказувати абсолютні шляхи до скриптів хуків у `~/.claude/settings.json` (типовий шлях). Ці шляхи, як правило, містять версію agentmemory (наприклад, `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), тому наступне оновлення непомітно зламає кожен хук. Обхідне рішення: @@ -454,7 +454,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Ця команда об'єднує ті самі команди хуків у `~/.claude/settings.json`, використовуючи абсолютні шляхи, визначені до вбудованого каталогу `plugin/` наразі встановленого пакета `@agentmemory/agentmemory`. Повторно запустіть команду після оновлення agentmemory, щоб оновити шляхи. Записи користувача в тому самому файлі зберігаються; замінюються лише попередні записи agentmemory. Шлях через `/plugin install` залишається рекомендованим підходом. +Ця команда налаштовує MCP-сервер і додає включені до пакета хуки до конфігурації користувача Claude Code. Якщо `CLAUDE_CONFIG_DIR` не задано, вона порожня або містить лише пробільні символи, для MCP використовується `~/.claude.json`, а для хуків — `~/.claude/settings.json`. Інші значення каталогу використовуються без змін, включно з пробільними символами на початку та в кінці. Щоб використовувати власний каталог, задайте однакове непорожнє значення `CLAUDE_CONFIG_DIR` для цієї команди та Claude Code; тоді файлами будуть відповідно `$CLAUDE_CONFIG_DIR/.claude.json` і `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code має отримати це значення у своєму середовищі запуску, навіть якщо конектор читає його з файлу `.env` AgentMemory. Створіть власний каталог перед виконанням цієї команди; інакше конектор пропустить Claude Code як невиявлений. Якщо значення в оболонці містить лише пробільні символи, вилучіть `CLAUDE_CONFIG_DIR` із середовища перед запуском Claude Code, щоб він також використовував типовий профіль. Використовуйте абсолютний шлях. Відносні шляхи визначаються від робочого каталогу, тому обидві команди потрібно запускати з одного каталогу. + +Команди хуків використовують абсолютні шляхи до каталогу `plugin/`, включеного до встановленого пакета. Після оновлення agentmemory запустіть команду ще раз, щоб оновити ці шляхи. Записи користувача у файлах конфігурації зберігаються; замінюються лише попередні записи agentmemory. Використання `/plugin install` залишається рекомендованим підходом. Для віддалених або захищених розгортань запускайте Claude Code зі встановленими `AGENTMEMORY_URL` та `AGENTMEMORY_SECRET`. Плагін передає обидва значення своєму вбудованому MCP-серверу; якщо `AGENTMEMORY_URL` порожній, MCP-шим використовує `http://localhost:3111`. ### Codex CLI (платформа плагінів Codex) diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md index 5f04968cc3..7f720d8083 100644 --- a/READMEs/README.ur-PK.md +++ b/READMEs/README.ur-PK.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code بغیر plugin انسٹال کے (MCP-standalone راستہ) -اگر آپ `/plugin install` استعمال کرنے کے بجائے agentmemory کے MCP سرور کو براہِ راست `~/.claude.json` کے ذریعے جوڑتے ہیں، تو Claude Code کبھی `${CLAUDE_PLUGIN_ROOT}` کو resolve نہیں کرتا اور آپ کو hook اسکرپٹس کو `~/.claude/settings.json` میں absolute paths کی طرف پوائنٹ کرنا پڑتا ہے۔ یہ paths عام طور پر agentmemory کا ورژن شامل رکھتے ہیں (مثلاً `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)، لہٰذا اگلا اپ گریڈ خاموشی سے ہر ہک کو توڑ دیتا ہے۔ +اگر آپ `/plugin install` استعمال کرنے کے بجائے agentmemory کے MCP سرور کو براہِ راست `~/.claude.json` (پہلے سے طے شدہ راستہ) کے ذریعے جوڑتے ہیں، تو Claude Code کبھی `${CLAUDE_PLUGIN_ROOT}` کو resolve نہیں کرتا اور آپ کو hook اسکرپٹس کو `~/.claude/settings.json` (پہلے سے طے شدہ راستہ) میں absolute paths کی طرف پوائنٹ کرنا پڑتا ہے۔ یہ paths عام طور پر agentmemory کا ورژن شامل رکھتے ہیں (مثلاً `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`)، لہٰذا اگلا اپ گریڈ خاموشی سے ہر ہک کو توڑ دیتا ہے۔ متبادل حل: @@ -454,7 +454,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -یہ انہی hook کمانڈز کو `~/.claude/settings.json` میں ضم کرتا ہے، ان absolute paths کے ساتھ جو currently installed `@agentmemory/agentmemory` پیکیج کی bundled `plugin/` ڈائرکٹری سے resolve ہوتے ہیں۔ paths کو تازہ کرنے کے لیے agentmemory اپ گریڈ کرنے کے بعد یہ کمانڈ دوبارہ چلائیں۔ اسی فائل میں موجود صارف کے entries محفوظ رہتے ہیں؛ صرف پہلے والے agentmemory entries تبدیل ہوتے ہیں۔ `/plugin install` راستہ استعمال کرنا ہی تجویز کردہ طریقہ رہتا ہے۔ +یہ کمانڈ MCP سرور کو کنفیگر کرتی ہے اور ساتھ آنے والے hooks کو Claude Code کی صارف کنفیگریشن میں ضم کرتی ہے۔ اگر `CLAUDE_CONFIG_DIR` سیٹ نہیں ہے، خالی ہے یا اس میں صرف وائٹ اسپیس ہے تو یہ MCP کے لیے `~/.claude.json` اور hooks کے لیے `~/.claude/settings.json` استعمال کرتی ہے۔ ڈائرکٹری کی دیگر قدریں بالکل اسی طرح استعمال ہوتی ہیں جیسے دی گئی ہوں، بشمول شروع اور آخر کی وائٹ اسپیس۔ اپنی مرضی کی ڈائرکٹری کے لیے اس کمانڈ اور Claude Code دونوں کے لیے `CLAUDE_CONFIG_DIR` کی ایک ہی غیر خالی قدر سیٹ کریں؛ تب فائلیں بالترتیب `$CLAUDE_CONFIG_DIR/.claude.json` اور `$CLAUDE_CONFIG_DIR/settings.json` ہوں گی۔ Claude Code کو یہ قدر اپنے لانچ ماحول میں ملنی چاہیے، چاہے کنیکٹر اسے AgentMemory کی `.env` سے پڑھتا ہو۔ اس کمانڈ کو چلانے سے پہلے اپنی مرضی کی ڈائرکٹری بنائیں؛ ورنہ کنیکٹر Claude Code کو شناخت نہ ہونے کی وجہ سے چھوڑ دے گا۔ اگر shell کی قدر میں صرف وائٹ اسپیس ہو تو Claude Code شروع کرنے سے پہلے ماحول سے `CLAUDE_CONFIG_DIR` ہٹا دیں تاکہ وہ بھی پہلے سے طے شدہ پروفائل استعمال کرے۔ مطلق راستہ استعمال کریں۔ نسبتی راستے کام کی ڈائریکٹری کے لحاظ سے متعین ہوتے ہیں، اس لیے دونوں کمانڈز ایک ہی ڈائریکٹری سے چلائیں۔ + +Hook کمانڈز انسٹال شدہ پیکیج کے ساتھ آنے والی `plugin/` ڈائرکٹری کے مطلق راستے استعمال کرتی ہیں۔ agentmemory اپ گریڈ کرنے کے بعد ان راستوں کو تازہ کرنے کے لیے کمانڈ دوبارہ چلائیں۔ کنفیگریشن فائلوں میں صارف کی entries محفوظ رہتی ہیں؛ صرف agentmemory کی پچھلی entries تبدیل ہوتی ہیں۔ `/plugin install` کا استعمال ہی تجویز کردہ طریقہ رہتا ہے۔ ریموٹ یا محفوظ deployments کے لیے، Claude Code کو `AGENTMEMORY_URL` اور `AGENTMEMORY_SECRET` سیٹ کر کے لانچ کریں۔ plugin دونوں قدریں اپنے bundled MCP سرور تک پہنچاتا ہے؛ جب `AGENTMEMORY_URL` خالی ہو، تو MCP shim `http://localhost:3111` استعمال کرتا ہے۔ ### Codex CLI (Codex plugin پلیٹ فارم) diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md index a58f67266f..3015eb123a 100644 --- a/READMEs/README.vi-VN.md +++ b/READMEs/README.vi-VN.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code không cài plugin (đường MCP độc lập) -Nếu bạn kết nối MCP server của agentmemory qua `~/.claude.json` trực tiếp thay vì dùng `/plugin install`, Claude Code sẽ không bao giờ resolve `${CLAUDE_PLUGIN_ROOT}` và bạn phải chỉ các hook script tới đường dẫn tuyệt đối trong `~/.claude/settings.json`. Các đường dẫn đó thường nhúng cả phiên bản agentmemory (ví dụ `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), nên lần nâng cấp kế tiếp sẽ lặng lẽ làm hỏng mọi hook. +Nếu bạn kết nối MCP server của agentmemory qua `~/.claude.json` (đường dẫn mặc định) trực tiếp thay vì dùng `/plugin install`, Claude Code sẽ không bao giờ resolve `${CLAUDE_PLUGIN_ROOT}` và bạn phải chỉ các hook script tới đường dẫn tuyệt đối trong `~/.claude/settings.json` (đường dẫn mặc định). Các đường dẫn đó thường nhúng cả phiên bản agentmemory (ví dụ `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`), nên lần nâng cấp kế tiếp sẽ lặng lẽ làm hỏng mọi hook. Cách khắc phục tạm: @@ -452,7 +452,9 @@ Cách khắc phục tạm: agentmemory connect claude-code --with-hooks ``` -Lệnh này gộp cùng các hook command đó vào `~/.claude/settings.json` với đường dẫn tuyệt đối được resolve tới thư mục `plugin/` đi kèm của package `@agentmemory/agentmemory` đang được cài. Chạy lại lệnh này sau khi nâng cấp agentmemory để làm mới các đường dẫn. Các entry của người dùng trong cùng file được giữ lại; chỉ các entry agentmemory trước đó bị thay thế. Dùng đường `/plugin install` vẫn là cách được khuyến nghị. +Lệnh này cấu hình máy chủ MCP và gộp các hook đi kèm vào cấu hình người dùng của Claude Code. Nếu `CLAUDE_CONFIG_DIR` chưa được đặt, rỗng hoặc chỉ chứa khoảng trắng, lệnh dùng `~/.claude.json` cho MCP và `~/.claude/settings.json` cho các hook. Các giá trị thư mục khác được dùng đúng như đã cung cấp, kể cả khoảng trắng ở đầu và cuối. Để dùng thư mục tùy chỉnh, hãy đặt `CLAUDE_CONFIG_DIR` thành cùng một giá trị không rỗng cho cả lệnh này và Claude Code; khi đó, các tệp lần lượt là `$CLAUDE_CONFIG_DIR/.claude.json` và `$CLAUDE_CONFIG_DIR/settings.json`. Claude Code phải nhận giá trị này trong môi trường khởi chạy của chính nó, ngay cả khi trình kết nối đọc giá trị từ tệp `.env` của AgentMemory. Tạo thư mục tùy chỉnh trước khi chạy lệnh này; nếu thư mục chưa tồn tại, trình kết nối sẽ bỏ qua Claude Code vì không phát hiện được. Nếu giá trị trong shell chỉ chứa khoảng trắng, hãy xóa `CLAUDE_CONFIG_DIR` khỏi môi trường trước khi khởi chạy Claude Code để nó cũng dùng cấu hình mặc định. Hãy dùng đường dẫn tuyệt đối. Đường dẫn tương đối được xác định theo thư mục làm việc, nên cả hai lệnh phải được chạy từ cùng một thư mục. + +Các lệnh hook dùng đường dẫn tuyệt đối đến thư mục `plugin/` đi kèm trong gói đã cài đặt. Chạy lại lệnh sau khi nâng cấp agentmemory để cập nhật các đường dẫn này. Các mục của người dùng trong tệp cấu hình được giữ nguyên; chỉ các mục agentmemory trước đó bị thay thế. Dùng `/plugin install` vẫn là cách được khuyến nghị. Với các deployment từ xa hoặc được bảo vệ, hãy khởi chạy Claude Code với `AGENTMEMORY_URL` và `AGENTMEMORY_SECRET` đã được đặt. Plugin sẽ truyền cả hai giá trị này xuống MCP server đi kèm của nó; khi `AGENTMEMORY_URL` để trống, MCP shim dùng `http://localhost:3111`. ### Codex CLI (nền tảng plugin của Codex) diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md index d065aa3500..0620f10fea 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -444,7 +444,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code 不使用插件安装(MCP 独立路径) -如果你直接通过 `~/.claude.json` 接入 agentmemory 的 MCP 服务器,而不是使用 `/plugin install`,Claude Code 永远不会解析 `${CLAUDE_PLUGIN_ROOT}`,你必须把 hook 脚本指向 `~/.claude/settings.json` 中的绝对路径。这些路径通常会嵌入 agentmemory 的版本号(例如 `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`),因此下一次升级会悄悄破坏所有 hooks。 +如果你直接通过 `~/.claude.json`(默认路径)接入 agentmemory 的 MCP 服务器,而不是使用 `/plugin install`,Claude Code 永远不会解析 `${CLAUDE_PLUGIN_ROOT}`,你必须把 hook 脚本指向 `~/.claude/settings.json`(默认路径)中的绝对路径。这些路径通常会嵌入 agentmemory 的版本号(例如 `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`),因此下一次升级会悄悄破坏所有 hooks。 变通方法: @@ -452,7 +452,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -这会把同样的 hook 命令合并进 `~/.claude/settings.json`,绝对路径会解析到当前安装的 `@agentmemory/agentmemory` 包自带的 `plugin/` 目录。升级 agentmemory 之后重新运行该命令以刷新路径。同一文件中的用户条目会被保留;只会替换之前的 agentmemory 条目。仍然推荐使用 `/plugin install` 路径。 +此命令会配置 MCP 服务器,并将包内的 hook 合并到 Claude Code 的用户配置中。`CLAUDE_CONFIG_DIR` 未设置、为空或仅含空白时,MCP 使用 `~/.claude.json`,hook 使用 `~/.claude/settings.json`。其他目录值按原样使用,包括首尾空白。若使用自定义目录,请为此命令和 Claude Code 设置相同且非空的 `CLAUDE_CONFIG_DIR`,此时两份配置文件分别为 `$CLAUDE_CONFIG_DIR/.claude.json` 和 `$CLAUDE_CONFIG_DIR/settings.json`。即使连接器从 AgentMemory 的 `.env` 读取该值,Claude Code 自身的启动环境中也必须设置该值。运行此命令前请先创建自定义目录;目录不存在时,连接器会以未检测到 Claude Code 为由跳过。若 shell 中的值仅含空白,请在启动 Claude Code 前取消 `CLAUDE_CONFIG_DIR`,使其也使用默认配置。建议使用绝对路径。相对路径以工作目录为基准,因此两个命令必须从同一目录启动。 + +Hook 命令使用绝对路径,指向已安装包内的 `plugin/` 目录。升级 agentmemory 后,请重新运行此命令以刷新这些路径。配置文件中的用户条目会保留,仅替换之前的 agentmemory 条目。仍推荐使用 `/plugin install`。 对于远程或受保护的部署,启动 Claude Code 时设置好 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。插件会把这两个值传递给它捆绑的 MCP 服务器;当 `AGENTMEMORY_URL` 为空时,MCP shim 会使用 `http://localhost:3111`。 ### Codex CLI(Codex 插件平台) diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md index 1c5117fbb5..b0f4b0b7bb 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -442,7 +442,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate #### Claude Code 若未安裝外掛(MCP 獨立路徑) -若你直接透過 `~/.claude.json` 連接 agentmemory 的 MCP 伺服器,而不是使用 `/plugin install`,Claude Code 永遠不會解析 `${CLAUDE_PLUGIN_ROOT}`,你必須把 hook 腳本指向 `~/.claude/settings.json` 中的絕對路徑。這些路徑通常會嵌入 agentmemory 的版本號(例如 `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`),因此下次升級會靜默破壞每一個 hook。 +若你直接透過 `~/.claude.json`(預設路徑)連接 agentmemory 的 MCP 伺服器,而不是使用 `/plugin install`,Claude Code 永遠不會解析 `${CLAUDE_PLUGIN_ROOT}`,你必須把 hook 腳本指向 `~/.claude/settings.json`(預設路徑)中的絕對路徑。這些路徑通常會嵌入 agentmemory 的版本號(例如 `~/.codex/plugins/cache/agentmemory/agentmemory/0.9.22/scripts/…`),因此下次升級會靜默破壞每一個 hook。 變通方法: @@ -450,7 +450,9 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -這會把同樣的 hook 指令合併到 `~/.claude/settings.json` 中,絕對路徑會解析到目前安裝的 `@agentmemory/agentmemory` 套件所捆綁的 `plugin/` 目錄。升級 agentmemory 後重新執行此指令以刷新路徑。同一檔案中既有的使用者條目會被保留;只有先前的 agentmemory 條目會被取代。仍然建議使用 `/plugin install` 路徑。 +此指令會設定 MCP 伺服器,並將套件內的 hook 合併到 Claude Code 的使用者設定中。`CLAUDE_CONFIG_DIR` 未設定、為空或僅含空白時,MCP 使用 `~/.claude.json`,hook 使用 `~/.claude/settings.json`。其他目錄值按原樣使用,包括首尾空白。若使用自訂目錄,請為此指令和 Claude Code 設定相同且非空的 `CLAUDE_CONFIG_DIR`,此時兩份設定檔分別為 `$CLAUDE_CONFIG_DIR/.claude.json` 和 `$CLAUDE_CONFIG_DIR/settings.json`。即使連接器從 AgentMemory 的 `.env` 讀取該值,Claude Code 本身的啟動環境中也必須設定該值。執行此指令前請先建立自訂目錄;目錄不存在時,連接器會以未偵測到 Claude Code 為由略過。若 shell 中的值僅含空白,請在啟動 Claude Code 前取消 `CLAUDE_CONFIG_DIR`,使其也使用預設設定。建議使用絕對路徑。相對路徑以工作目錄為基準,因此兩個命令必須從同一目錄啟動。 + +Hook 指令使用絕對路徑,指向已安裝套件內的 `plugin/` 目錄。升級 agentmemory 後,請重新執行此指令以更新這些路徑。設定檔中的使用者條目會保留,僅取代先前的 agentmemory 條目。仍建議使用 `/plugin install`。 若用於遠端或受保護的部署,啟動 Claude Code 時請設定 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。外掛會把這兩個值都傳給它捆綁的 MCP 伺服器;當 `AGENTMEMORY_URL` 為空時,MCP shim 會使用 `http://localhost:3111`。 ### Codex CLI(Codex 外掛平台) diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index 1882be86cc..271468bf2e 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -1,7 +1,8 @@ -import { existsSync, mkdirSync, writeFileSync } from "node:fs"; +import { existsSync, mkdirSync, statSync, writeFileSync } from "node:fs"; import { homedir } from "node:os"; -import { join } from "node:path"; +import { isAbsolute, join, normalize, resolve } from "node:path"; import * as p from "@clack/prompts"; +import { isEnvFileValue } from "../../config.js"; import type { ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js"; import { AGENTMEMORY_MCP_BLOCK, @@ -18,9 +19,18 @@ import { type HookManifest, } from "./codex-hooks.js"; -const CLAUDE_DIR = join(homedir(), ".claude"); -const CLAUDE_JSON = join(homedir(), ".claude.json"); -const CLAUDE_SETTINGS = join(CLAUDE_DIR, "settings.json"); +function claudeConfigPaths() { + const rawConfigDir = process.env["CLAUDE_CONFIG_DIR"]; + const configDir = rawConfigDir?.trim() ? rawConfigDir : undefined; + const dir = configDir ? normalize(configDir) : join(homedir(), ".claude"); + return { + rawConfigDir, + configDir, + dir, + mcp: configDir ? join(dir, ".claude.json") : join(homedir(), ".claude.json"), + settings: join(dir, "settings.json"), + }; +} type ClaudeMcpEntry = typeof AGENTMEMORY_MCP_BLOCK; type ClaudeConfig = { @@ -45,10 +55,48 @@ export const adapter: ConnectAdapter = { "→ Using MCP. Hooks are also available — see https://github.com/rohitg00/agentmemory#claude-code-one-block-paste-it.", detect(): boolean { - return existsSync(CLAUDE_DIR); + const { configDir, dir } = claudeConfigPaths(); + let detected: boolean; + try { + detected = statSync(dir, { throwIfNoEntry: false })?.isDirectory() ?? false; + } catch (err) { + const code = (err as NodeJS.ErrnoException).code; + if (code !== "EACCES" && code !== "EPERM") throw err; + p.log.warn( + `Cannot inspect Claude Code configuration directory ${JSON.stringify(dir)} (${code}). Check directory permissions and retry.`, + ); + return false; + } + if (!detected && configDir) { + p.log.warn( + `Claude Code configuration path ${JSON.stringify(configDir)} is not an existing directory. Create it or correct CLAUDE_CONFIG_DIR; check for unintended leading or trailing whitespace.`, + ); + } + return detected; }, async install(opts: ConnectOptions): Promise { + const { rawConfigDir, configDir, dir: CLAUDE_DIR, mcp: CLAUDE_JSON } = claudeConfigPaths(); + const fromEnvFile = isEnvFileValue("CLAUDE_CONFIG_DIR"); + if (configDir && fromEnvFile) { + p.log.warn( + `CLAUDE_CONFIG_DIR was loaded only from agentmemory's env file. Launch Claude Code with the same CLAUDE_CONFIG_DIR value ${JSON.stringify(configDir)} so it reads the same MCP and hook configuration.`, + ); + } else if (rawConfigDir && !configDir && !fromEnvFile) { + p.log.warn( + "CLAUDE_CONFIG_DIR contains only whitespace. AgentMemory will use the default Claude Code profile. Unset CLAUDE_CONFIG_DIR before launching Claude Code so it uses the same profile.", + ); + } + if (configDir && configDir !== configDir.trim()) { + p.log.warn( + `CLAUDE_CONFIG_DIR contains leading or trailing whitespace. Using the path exactly as provided: ${JSON.stringify(configDir)}. If this is unintended, correct CLAUDE_CONFIG_DIR and rerun this command.`, + ); + } + if (configDir && !isAbsolute(configDir)) { + p.log.warn( + `CLAUDE_CONFIG_DIR is relative and resolves to ${JSON.stringify(resolve(configDir))} from this working directory. Set the same absolute path for agentmemory and Claude Code so they use the same profile.`, + ); + } const existing = readJsonSafe(CLAUDE_JSON); const next: ClaudeConfig = existing ? { ...existing } : {}; const servers: Record = { @@ -116,6 +164,7 @@ export const adapter: ConnectAdapter = { }; function installClaudeHooks(opts: ConnectOptions): ConnectResult { + const { dir: CLAUDE_DIR, settings: CLAUDE_SETTINGS } = claudeConfigPaths(); let pluginRoot: string; try { pluginRoot = findPluginRoot(); diff --git a/src/config.ts b/src/config.ts index 4841361beb..d0653bea67 100644 --- a/src/config.ts +++ b/src/config.ts @@ -41,6 +41,7 @@ function writeProviderNoticeOnce(text: string): void { // mutate the file between cases reset the module (clearing this via reload) or // call __resetEnvFileCache(). let envFileCache: Record | undefined; +const hydratedEnvValues = new Map(); function loadEnvFile(): Record { if (envFileCache) return envFileCache; @@ -120,11 +121,19 @@ export function isRealProviderKey( export function hydrateProcessEnvFromFile(): Record { const beforeHydration = { ...process.env }; for (const [k, v] of Object.entries(loadEnvFile())) { - if (process.env[k] === undefined) process.env[k] = v; + if (process.env[k] === undefined) { + process.env[k] = v; + hydratedEnvValues.set(k, v); + } } return beforeHydration; } +export function isEnvFileValue(key: string): boolean { + const hydrated = hydratedEnvValues.get(key); + return hydrated !== undefined && process.env[key] === hydrated; +} + // Warn once when a configured model is in the premium tier and likely to burn // money on background compression. Captured workload data shows ~$5/35h on // claude-sonnet-4 vs ~$0.46/35h on deepseek-v4-pro for the same compression diff --git a/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index 4955131c1e..c79acb3cd1 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,5 +1,6 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; -import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; +import { spawnSync } from "node:child_process"; +import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, symlinkSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; import { @@ -116,6 +117,7 @@ describe("connect claude-code --with-hooks", () => { home = mkdtempSync(join(tmpdir(), "am-claude-hooks-")); vi.stubEnv("HOME", home); vi.stubEnv("USERPROFILE", home); + vi.stubEnv("CLAUDE_CONFIG_DIR", undefined); vi.resetModules(); }); @@ -145,4 +147,452 @@ describe("connect claude-code --with-hooks", () => { ...buildMergedHooks(null, PLUGIN_ROOT, "hooks.json").hooks["Stop"]!, ]); }); + + it("detects Claude Code in CLAUDE_CONFIG_DIR without a default directory", async () => { + const configDir = join(home, "custom Claude config"); + mkdirSync(configDir); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + expect(adapter.detect()).toBe(true); + expect(existsSync(join(home, ".claude"))).toBe(false); + }); + + it.skipIf(process.platform === "win32")("preserves a literal trailing space instead of changing a different profile", async () => { + const configDir = join(home, "custom Claude config "); + const trimmedDir = configDir.trim(); + mkdirSync(configDir); + mkdirSync(trimmedDir); + writeFileSync(join(trimmedDir, ".claude.json"), '{"keep":"trimmed MCP"}'); + writeFileSync(join(trimmedDir, "settings.json"), '{"keep":"trimmed settings"}'); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + expect(adapter.detect()).toBe(true); + expect(await adapter.install({ dryRun: false, force: false, withHooks: true })).toMatchObject({ + kind: "installed", + mutatedPath: join(configDir, ".claude.json"), + }); + expect(JSON.parse(readFileSync(join(configDir, "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + expect(readFileSync(join(trimmedDir, ".claude.json"), "utf-8")).toBe('{"keep":"trimmed MCP"}'); + expect(readFileSync(join(trimmedDir, "settings.json"), "utf-8")).toBe('{"keep":"trimmed settings"}'); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }); + + it("skips a custom profile directory that does not exist", async () => { + const configDir = join(home, "missing Claude config"); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { resolveAdapter, runAdapter } = await import("../src/cli/connect/index.js"); + expect(await runAdapter(resolveAdapter("claude-code")!, { + dryRun: false, + force: false, + withHooks: true, + guidelines: false, + })).toEqual({ kind: "skipped", reason: "not-detected" }); + expect(existsSync(configDir)).toBe(false); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }); + + it.each(["custom", "default"])("skips a %s profile path that is a file", async (profile) => { + const configDir = join(home, profile === "custom" ? "Claude config" : ".claude"); + writeFileSync(configDir, "keep this file"); + if (profile === "custom") vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { resolveAdapter, runAdapter } = await import("../src/cli/connect/index.js"); + expect(await runAdapter(resolveAdapter("claude-code")!, { + dryRun: false, + force: false, + withHooks: true, + guidelines: false, + })).toEqual({ kind: "skipped", reason: "not-detected" }); + expect(readFileSync(configDir, "utf-8")).toBe("keep this file"); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + }); + + it("uses a profile override set after the adapter was imported for detection, MCP and hooks", async () => { + const { adapter } = await import("../src/cli/connect/claude-code.js"); + const configDir = join(home, "late Claude config"); + mkdirSync(configDir); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + expect(adapter.detect()).toBe(true); + expect(await adapter.install({ dryRun: false, force: false, withHooks: true })).toMatchObject({ + kind: "installed", + mutatedPath: join(configDir, ".claude.json"), + }); + expect(JSON.parse(readFileSync(join(configDir, "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }); + + describe.skipIf(process.platform === "win32")("CLI env-file hydration", () => { + it.each([ + { source: "default .env", customEnvFile: false, shellOverride: false, matchingShell: false, padding: "none" }, + { source: "AGENTMEMORY_ENV_FILE", customEnvFile: true, shellOverride: false, matchingShell: false, padding: "none" }, + { source: "shell overriding the env file", customEnvFile: true, shellOverride: true, matchingShell: false, padding: "none" }, + { source: "matching shell and env-file values", customEnvFile: true, shellOverride: true, matchingShell: true, padding: "none" }, + { source: "a literal env-file value with surrounding spaces", customEnvFile: true, shellOverride: false, matchingShell: false, padding: "both" }, + { source: "a literal shell value with leading spaces", customEnvFile: true, shellOverride: true, matchingShell: false, padding: "leading" }, + { source: "a literal shell value with trailing spaces", customEnvFile: true, shellOverride: true, matchingShell: false, padding: "trailing" }, + ])("installs MCP and hooks using $source", ({ customEnvFile, shellOverride, matchingShell, padding }) => { + const fileProfile = join(home, "env-file Claude config"); + const shellProfile = join(home, "shell Claude config"); + const withPadding = (value: string) => + `${padding === "leading" || padding === "both" ? " " : ""}${value}${padding === "trailing" || padding === "both" ? " " : ""}`; + const fileValue = shellOverride ? fileProfile : withPadding(fileProfile); + const selectedValue = shellOverride && !matchingShell ? withPadding(shellProfile) : fileValue; + const selected = resolve(home, selectedValue); + mkdirSync(fileProfile); + mkdirSync(shellProfile); + mkdirSync(selected, { recursive: true }); + mkdirSync(join(home, ".agentmemory")); + const envFile = customEnvFile + ? join(home, "custom.env") + : join(home, ".agentmemory", ".env"); + writeFileSync(envFile, `CLAUDE_CONFIG_DIR="${fileValue}"\n`); + + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: customEnvFile ? envFile : undefined, + CLAUDE_CONFIG_DIR: shellOverride ? selectedValue : undefined, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + if (shellOverride) { + expect(output).not.toContain("CLAUDE_CONFIG_DIR was loaded only"); + } else { + expect(output).toContain("CLAUDE_CONFIG_DIR was loaded only from agentmemory's env file."); + expect(output).toContain(`Launch Claude Code with the same CLAUDE_CONFIG_DIR value ${JSON.stringify(selectedValue)}`); + expect(output.match(/CLAUDE_CONFIG_DIR was loaded only/g)).toHaveLength(1); + expect(output.indexOf("CLAUDE_CONFIG_DIR was loaded only")).toBeLessThan(output.indexOf("wired into")); + } + if (padding === "none" || padding === "trailing") { + expect(output).not.toContain("CLAUDE_CONFIG_DIR is relative"); + } + if (padding === "none") { + expect(output).not.toContain("CLAUDE_CONFIG_DIR contains leading or trailing whitespace"); + } else { + expect(output).toContain(`Using the path exactly as provided: ${JSON.stringify(selectedValue)}`); + expect(output).toContain("If this is unintended, correct CLAUDE_CONFIG_DIR and rerun this command."); + expect(output.match(/CLAUDE_CONFIG_DIR contains leading or trailing whitespace/g)).toHaveLength(1); + expect(output.indexOf("CLAUDE_CONFIG_DIR contains leading or trailing whitespace")).toBeLessThan(output.indexOf("wired into")); + } + expect(result.stdout).toContain(`wired into ${join(selectedValue, ".claude.json")}`); + expect(JSON.parse(readFileSync(join(selected, ".claude.json"), "utf-8")).mcpServers.agentmemory).toBeDefined(); + expect(JSON.parse(readFileSync(join(selected, "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + for (const profile of [fileProfile, shellProfile]) { + if (profile !== selected) { + expect(existsSync(join(profile, ".claude.json"))).toBe(false); + expect(existsSync(join(profile, "settings.json"))).toBe(false); + } + } + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }, 15000); + + it.each(["env file", "shell"])("keeps legacy paths and warns only for a shell whitespace-only value from the %s", (source) => { + const fileProfile = join(home, "env-file Claude config"); + mkdirSync(fileProfile); + mkdirSync(join(home, ".claude")); + mkdirSync(join(home, ".agentmemory")); + writeFileSync(join(home, ".agentmemory", ".env"), + `CLAUDE_CONFIG_DIR="${source === "env file" ? " \t " : fileProfile}"\n`); + + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: undefined, + CLAUDE_CONFIG_DIR: source === "shell" ? " \t " : undefined, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + expect(output).not.toContain("CLAUDE_CONFIG_DIR was loaded only"); + expect(output).not.toContain("CLAUDE_CONFIG_DIR contains leading or trailing whitespace"); + if (source === "shell") { + expect(output).toContain("CLAUDE_CONFIG_DIR contains only whitespace."); + expect(output).toContain("Unset CLAUDE_CONFIG_DIR before launching Claude Code"); + expect(output.match(/CLAUDE_CONFIG_DIR contains only whitespace/g)).toHaveLength(1); + } else { + expect(output).not.toContain("CLAUDE_CONFIG_DIR contains only whitespace."); + } + expect(result.stdout).toContain(`wired into ${join(home, ".claude.json")}`); + expect(JSON.parse(readFileSync(join(home, ".claude.json"), "utf-8")).mcpServers.agentmemory).toBeDefined(); + expect(JSON.parse(readFileSync(join(home, ".claude", "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + expect(existsSync(join(fileProfile, ".claude.json"))).toBe(false); + expect(existsSync(join(fileProfile, "settings.json"))).toBe(false); + }, 15000); + + it.each(["leading", "trailing"])("skips a missing literal profile with %s whitespace even when the trimmed directory exists", (padding) => { + const trimmedDir = join(home, "existing Claude config"); + const configDir = padding === "leading" ? ` ${trimmedDir}` : `${trimmedDir} `; + mkdirSync(trimmedDir); + + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: undefined, + CLAUDE_CONFIG_DIR: configDir, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + expect(output).toContain(JSON.stringify(configDir)); + expect(output).toContain("is not an existing directory"); + expect(output).toContain("leading or trailing whitespace"); + expect(output).toContain("not detected on this machine (skipping)"); + expect(output).not.toContain("wired into"); + expect(existsSync(resolve(home, configDir))).toBe(false); + expect(existsSync(join(trimmedDir, ".claude.json"))).toBe(false); + expect(existsSync(join(trimmedDir, "settings.json"))).toBe(false); + }, 15000); + + it("warns before installing into a profile relative to the CLI working directory", () => { + const configDir = "relative Claude config"; + const selected = join(home, configDir); + mkdirSync(selected); + + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: undefined, + CLAUDE_CONFIG_DIR: configDir, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + expect(output).toContain(`CLAUDE_CONFIG_DIR is relative and resolves to ${JSON.stringify(realpathSync(selected))}`); + expect(output).toContain("Set the same absolute path for agentmemory and Claude Code"); + expect(output.match(/CLAUDE_CONFIG_DIR is relative/g)).toHaveLength(1); + expect(output.indexOf("CLAUDE_CONFIG_DIR is relative")).toBeLessThan(output.indexOf("wired into")); + expect(JSON.parse(readFileSync(join(selected, ".claude.json"), "utf-8")).mcpServers.agentmemory).toBeDefined(); + expect(JSON.parse(readFileSync(join(selected, "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }, 15000); + + it.each(["existing", "missing"])("uses the %s normalized profile for a symlink followed by ..", (profile) => { + const alias = join(home, "alias"); + const target = join(home, "target"); + const normalizedProfile = join(alias, "profile"); + const targetProfile = join(target, "profile"); + mkdirSync(alias); + mkdirSync(join(target, "child"), { recursive: true }); + symlinkSync(join(target, "child"), join(alias, "link"), "dir"); + const configDir = `${alias}/link/../profile`; + const existingProfile = profile === "existing" ? normalizedProfile : targetProfile; + mkdirSync(existingProfile); + mkdirSync(join(home, ".claude")); + const original = '{"keep":"original configuration"}'; + for (const path of [ + join(existingProfile, ".claude.json"), + join(existingProfile, "settings.json"), + join(home, ".claude.json"), + join(home, ".claude", "settings.json"), + ]) { + writeFileSync(path, original); + } + + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: undefined, + CLAUDE_CONFIG_DIR: configDir, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + if (profile === "existing") { + expect(output).toContain(`wired into ${join(normalizedProfile, ".claude.json")}`); + const config = JSON.parse(readFileSync(join(normalizedProfile, ".claude.json"), "utf-8")); + const settings = JSON.parse(readFileSync(join(normalizedProfile, "settings.json"), "utf-8")); + expect(config.mcpServers.agentmemory).toBeDefined(); + expect(settings.hooks.SessionStart).toBeDefined(); + expect(config.keep).toBe("original configuration"); + expect(settings.keep).toBe("original configuration"); + expect(existsSync(targetProfile)).toBe(false); + } else { + expect(output).toContain("not detected on this machine (skipping)"); + expect(output).not.toContain("wired into"); + expect(existsSync(normalizedProfile)).toBe(false); + expect(readFileSync(join(targetProfile, ".claude.json"), "utf-8")).toBe(original); + expect(readFileSync(join(targetProfile, "settings.json"), "utf-8")).toBe(original); + } + expect(readFileSync(join(home, ".claude.json"), "utf-8")).toBe(original); + expect(readFileSync(join(home, ".claude", "settings.json"), "utf-8")).toBe(original); + }, 15000); + + it.skipIf(process.getuid?.() === 0)("warns and skips an inaccessible profile without changing either profile", () => { + const parent = join(home, "inaccessible"); + const configDir = join(parent, "Claude config"); + const configPath = join(configDir, ".claude.json"); + const settingsPath = join(configDir, "settings.json"); + const defaultConfig = join(home, ".claude.json"); + const defaultSettings = join(home, ".claude", "settings.json"); + mkdirSync(configDir, { recursive: true }); + mkdirSync(join(home, ".claude")); + const original = '{"keep":"original configuration"}'; + for (const path of [configPath, settingsPath, defaultConfig, defaultSettings]) { + writeFileSync(path, original); + } + + chmodSync(parent, 0o000); + try { + const result = spawnSync(process.execPath, [ + resolve(__dirname, "..", "dist", "cli.mjs"), + "connect", "claude-code", "--with-hooks", "--no-guidelines", + ], { + cwd: home, + env: { + ...process.env, + AGENTMEMORY_ENV_FILE: undefined, + CLAUDE_CONFIG_DIR: configDir, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + const output = result.stdout + result.stderr; + expect(output).toContain(`Cannot inspect Claude Code configuration directory ${JSON.stringify(configDir)} (EACCES)`); + expect(output).toContain("Check directory permissions and retry."); + expect(output).toContain("not detected on this machine (skipping)"); + expect(output).not.toContain("wired into"); + } finally { + chmodSync(parent, 0o700); + } + for (const path of [configPath, settingsPath, defaultConfig, defaultSettings]) { + expect(readFileSync(path, "utf-8")).toBe(original); + } + }, 15000); + }); + + it("merges MCP and hooks in CLAUDE_CONFIG_DIR and leaves default files untouched", async () => { + const configDir = join(home, "custom Claude config"); + const configPath = join(configDir, ".claude.json"); + const settingsPath = join(configDir, "settings.json"); + const existingServer = { command: "existing-server", args: [] }; + const userHook = { hooks: [{ type: "command", command: "echo user-hook" }] }; + mkdirSync(configDir); + mkdirSync(join(home, ".claude")); + writeFileSync(configPath, JSON.stringify({ mcpServers: { existing: existingServer }, theme: "dark" })); + writeFileSync(settingsPath, JSON.stringify({ env: { KEEP: "yes" }, hooks: { SessionStart: [userHook] } })); + writeFileSync(join(home, ".claude.json"), '{"keep":"default MCP"}'); + writeFileSync(join(home, ".claude", "settings.json"), '{"keep":"default settings"}'); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + const options = { dryRun: false, force: false, withHooks: true }; + const result = await adapter.install(options); + + expect(result).toMatchObject({ kind: "installed", mutatedPath: configPath }); + const config = JSON.parse(readFileSync(configPath, "utf-8")); + expect(config.theme).toBe("dark"); + expect(config.mcpServers.existing).toEqual(existingServer); + expect(config.mcpServers.agentmemory.args).toContain("@agentmemory/mcp"); + const settings = JSON.parse(readFileSync(settingsPath, "utf-8")); + expect(settings.env).toEqual({ KEEP: "yes" }); + expect(settings.hooks.SessionStart).toEqual([ + userHook, + ...buildMergedHooks(null, PLUGIN_ROOT, "hooks.json").hooks.SessionStart!, + ]); + expect(readFileSync(join(home, ".claude.json"), "utf-8")).toBe('{"keep":"default MCP"}'); + expect(readFileSync(join(home, ".claude", "settings.json"), "utf-8")).toBe('{"keep":"default settings"}'); + + const installedSettings = readFileSync(settingsPath, "utf-8"); + expect((await adapter.install(options)).kind).toBe("already-wired"); + expect(readFileSync(settingsPath, "utf-8")).toBe(installedSettings); + }); + + it("reports the custom MCP path on a dry run without writing files", async () => { + const configDir = join(home, "custom Claude config"); + mkdirSync(configDir); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + const result = await adapter.install({ dryRun: true, force: false, withHooks: true }); + + expect(result).toMatchObject({ kind: "installed", mutatedPath: join(configDir, ".claude.json") }); + expect(existsSync(join(configDir, ".claude.json"))).toBe(false); + expect(existsSync(join(configDir, "settings.json"))).toBe(false); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + }); + + it("puts MCP inside an explicitly configured default .claude directory", async () => { + const configDir = join(home, ".claude"); + mkdirSync(configDir); + vi.stubEnv("CLAUDE_CONFIG_DIR", configDir); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + const result = await adapter.install({ dryRun: false, force: false }); + + expect(result).toMatchObject({ kind: "installed", mutatedPath: join(configDir, ".claude.json") }); + expect(JSON.parse(readFileSync(join(configDir, ".claude.json"), "utf-8")).mcpServers.agentmemory).toBeDefined(); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + }); + + it.each([undefined, "", " \t "])("keeps legacy paths when CLAUDE_CONFIG_DIR is %s", async (override) => { + vi.stubEnv("CLAUDE_CONFIG_DIR", override); + mkdirSync(join(home, ".claude")); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + expect(adapter.detect()).toBe(true); + const result = await adapter.install({ dryRun: false, force: false, withHooks: true }); + + expect(result).toMatchObject({ kind: "installed", mutatedPath: join(home, ".claude.json") }); + expect(JSON.parse(readFileSync(join(home, ".claude.json"), "utf-8")).mcpServers.agentmemory).toBeDefined(); + expect(JSON.parse(readFileSync(join(home, ".claude", "settings.json"), "utf-8")).hooks.SessionStart).toBeDefined(); + }); }); diff --git a/test/cli-connect.test.ts b/test/cli-connect.test.ts index e303fe1ab6..71548625b1 100644 --- a/test/cli-connect.test.ts +++ b/test/cli-connect.test.ts @@ -100,6 +100,7 @@ describe("agentmemory connect — claude-code adapter (mock filesystem)", () => originalUserprofile = process.env["USERPROFILE"]; process.env["HOME"] = tmpHome; process.env["USERPROFILE"] = tmpHome; + vi.stubEnv("CLAUDE_CONFIG_DIR", undefined); vi.resetModules(); }); @@ -109,6 +110,7 @@ describe("agentmemory connect — claude-code adapter (mock filesystem)", () => if (originalUserprofile !== undefined) process.env["USERPROFILE"] = originalUserprofile; else delete process.env["USERPROFILE"]; + vi.unstubAllEnvs(); rmSync(tmpHome, { recursive: true, force: true }); vi.resetModules(); });