From 3274439637a2c383b9d01b16e559ead0d4ea8904 Mon Sep 17 00:00:00 2001 From: mothieras Date: Sat, 7 Nov 2026 18:07:27 +0800 Subject: [PATCH 1/8] fix(connect): honor CLAUDE_CONFIG_DIR for Claude Code Resolve detection, user MCP configuration and hook settings from Claude Code's configured directory. Preserve the legacy locations when the override is unset or empty.\n\nValidated custom-path regressions and native MCP/hook execution with Claude Code 2.1.319. Full suite: 4497 passed, 6 skipped. Signed-off-by: mothieras --- src/cli/connect/claude-code.ts | 7 ++- test/claude-code-with-hooks.test.ts | 88 ++++++++++++++++++++++++++++- 2 files changed, 92 insertions(+), 3 deletions(-) diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index 1882be86cc..e6b5e09dbd 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -18,8 +18,11 @@ import { type HookManifest, } from "./codex-hooks.js"; -const CLAUDE_DIR = join(homedir(), ".claude"); -const CLAUDE_JSON = join(homedir(), ".claude.json"); +const CLAUDE_CONFIG_DIR = process.env["CLAUDE_CONFIG_DIR"]; +const CLAUDE_DIR = CLAUDE_CONFIG_DIR || join(homedir(), ".claude"); +const CLAUDE_JSON = CLAUDE_CONFIG_DIR + ? join(CLAUDE_DIR, ".claude.json") + : join(homedir(), ".claude.json"); const CLAUDE_SETTINGS = join(CLAUDE_DIR, "settings.json"); type ClaudeMcpEntry = typeof AGENTMEMORY_MCP_BLOCK; diff --git a/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index e3d35af552..5cf4a932f9 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,5 +1,5 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; -import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; +import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; import { @@ -109,6 +109,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(); }); @@ -138,4 +139,89 @@ 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("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, ""])("keeps legacy paths when CLAUDE_CONFIG_DIR is %s", async (override) => { + vi.stubEnv("CLAUDE_CONFIG_DIR", override); + + const { adapter } = await import("../src/cli/connect/claude-code.js"); + 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(); + }); }); From a3427028134fbabb4201ee34004db35aea8dbcca Mon Sep 17 00:00:00 2001 From: mothieras Date: Sat, 7 Nov 2026 18:35:34 +0800 Subject: [PATCH 2/8] fix(connect): resolve Claude paths after env hydration Read Claude Code paths when the adapter detects or installs a profile, after the CLI hydrates AgentMemory's env file. Use the same resolver for hook installation. Add regression coverage for late overrides, default and custom env files, and shell-over-file precedence through the built CLI. Include the generated test-count updates required by docs:sync. Validation: build, skills and docs checks pass; 4501 tests pass with 6 skipped. Native Claude Code 2.1.319 connects through MCP and runs the lifecycle hooks with the connector profile supplied only by .env. Signed-off-by: mothieras --- AGENTS.md | 4 +- README.md | 4 +- READMEs/README.ar-SA.md | 4 +- READMEs/README.bn-BD.md | 4 +- READMEs/README.cs-CZ.md | 4 +- READMEs/README.da-DK.md | 4 +- READMEs/README.de-DE.md | 4 +- READMEs/README.el-GR.md | 4 +- READMEs/README.es-ES.md | 4 +- READMEs/README.fi-FI.md | 4 +- READMEs/README.fr-FR.md | 4 +- READMEs/README.he-IL.md | 4 +- READMEs/README.hi-IN.md | 4 +- READMEs/README.hu-HU.md | 4 +- READMEs/README.id-ID.md | 4 +- READMEs/README.it-IT.md | 4 +- READMEs/README.ja-JP.md | 4 +- READMEs/README.ko-KR.md | 4 +- READMEs/README.nb-NO.md | 4 +- READMEs/README.nl-NL.md | 4 +- READMEs/README.pl-PL.md | 4 +- READMEs/README.pt-BR.md | 4 +- READMEs/README.pt-PT.md | 4 +- READMEs/README.ro-RO.md | 4 +- READMEs/README.ru-RU.md | 4 +- READMEs/README.sv-SE.md | 4 +- READMEs/README.th-TH.md | 4 +- READMEs/README.tl-PH.md | 4 +- READMEs/README.tr-TR.md | 4 +- READMEs/README.uk-UA.md | 4 +- READMEs/README.ur-PK.md | 4 +- READMEs/README.vi-VN.md | 4 +- READMEs/README.zh-CN.md | 4 +- READMEs/README.zh-TW.md | 4 +- assets/tags/light/stat-tests.svg | 4 +- assets/tags/stat-tests.svg | 4 +- scripts/docs-sync.state.json | 2 +- src/cli/connect/claude-code.ts | 19 +++++---- test/claude-code-with-hooks.test.ts | 60 +++++++++++++++++++++++++++++ 39 files changed, 145 insertions(+), 80 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8b2287d7c5..626ff4de24 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -101,7 +101,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import). ## Testing -- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,400+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests. +- Before every commit run, in order: `npm run build`, `npm run skills:gen`, `npm run docs:sync`, `npm run skills:check`, `npm test` (4,500+ tests). Commit anything the generators changed. CI runs the same build, skills check and tests. - Before any npm publish: `npm run release:gate` must pass. It installs the packed tarballs into a clean home and runs capture, recovery, restart, export/import, MCP and status checks against the installed CLI (see CONTRIBUTING.md, Release process) - Mock pattern: `vi.mock("iii-sdk")` with mock `sdk.trigger`, `kv.get/set/list` - Test files go in `test/` with `.test.ts` extension @@ -114,4 +114,4 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import). - 6 MCP resources, 3 MCP prompts - 12 hooks, 17 skills - 322+ iii functions -- 4,400+ tests +- 4,500+ tests diff --git a/README.md b/README.md index 3686943fc1..e60c37d257 100644 --- a/README.md +++ b/README.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1307,7 +1307,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md index 17f9286e93..43d2c4d432 100644 --- a/READMEs/README.ar-SA.md +++ b/READMEs/README.ar-SA.md @@ -71,7 +71,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1242,7 +1242,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md index 08c252833a..8310128629 100644 --- a/READMEs/README.bn-BD.md +++ b/READMEs/README.bn-BD.md @@ -69,7 +69,7 @@ 54 MCP টুল 12 অটো হুক 0 এক্সটার্নাল ডিবি - 4,400+ টেস্ট পাস + 4,500+ টেস্ট পাস

@@ -1255,7 +1255,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md index 821c2742b9..5a6c82efe5 100644 --- a/READMEs/README.cs-CZ.md +++ b/READMEs/README.cs-CZ.md @@ -69,7 +69,7 @@ 54 MCP nástrojů 12 automatických hooks 0 externích databází - 4,400+ testů úspěšně proběhlo + 4,500+ testů úspěšně proběhlo

@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md index f11435c2d8..4a2d0e1000 100644 --- a/READMEs/README.da-DK.md +++ b/READMEs/README.da-DK.md @@ -69,7 +69,7 @@ 54 MCP-værktøjer 12 automatiske hooks 0 eksterne databaser - 4,400+ beståede tests + 4,500+ beståede tests

@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md index cbaca6af3e..40064c7371 100644 --- a/READMEs/README.de-DE.md +++ b/READMEs/README.de-DE.md @@ -69,7 +69,7 @@ 54 MCP-Tools 12 Auto-Hooks 0 externe DBs - 4,400+ bestandene Tests + 4,500+ bestandene Tests

@@ -1247,7 +1247,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md index 435ae03670..63d3a6fe5d 100644 --- a/READMEs/README.el-GR.md +++ b/READMEs/README.el-GR.md @@ -69,7 +69,7 @@ 54 εργαλεία MCP 12 αυτόματα hooks 0 εξωτερικές βάσεις δεδομένων - 4,400+ επιτυχημένες δοκιμές + 4,500+ επιτυχημένες δοκιμές

@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md index 25a414bff8..798c26c413 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -69,7 +69,7 @@ 54 tools MCP 12 hooks automáticos 0 bases de datos externas - 4,400+ tests superados + 4,500+ tests superados

@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md index c608d1bc9c..1a7520e672 100644 --- a/READMEs/README.fi-FI.md +++ b/READMEs/README.fi-FI.md @@ -69,7 +69,7 @@ 54 MCP-työkalua 12 automaattista hookia 0 ulkoista tietokantaa - 4,400+ testiä läpäisty + 4,500+ testiä läpäisty

@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md index 7284da37e8..42bba1dc7d 100644 --- a/READMEs/README.fr-FR.md +++ b/READMEs/README.fr-FR.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1250,7 +1250,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md index d8f06e0b17..0b116fa100 100644 --- a/READMEs/README.he-IL.md +++ b/READMEs/README.he-IL.md @@ -71,7 +71,7 @@ 54 כלי MCP 12 hooks אוטומטיים 0 מסדי נתונים חיצוניים - 4,400+ בדיקות עוברות + 4,500+ בדיקות עוברות

@@ -1242,7 +1242,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md index 84f168106a..c628d732be 100644 --- a/READMEs/README.hi-IN.md +++ b/READMEs/README.hi-IN.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1256,7 +1256,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md index fd1d89534f..6afe735b63 100644 --- a/READMEs/README.hu-HU.md +++ b/READMEs/README.hu-HU.md @@ -69,7 +69,7 @@ 54 MCP eszköz 12 automatikus hook 0 külső adatbázis - 4,400+ sikeres teszt + 4,500+ sikeres teszt

@@ -1239,7 +1239,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md index 025497f109..85d729f1ec 100644 --- a/READMEs/README.id-ID.md +++ b/READMEs/README.id-ID.md @@ -69,7 +69,7 @@ 54 tool MCP 12 hook otomatis 0 DB eksternal - 4,400+ pengujian lolos + 4,500+ pengujian lolos

@@ -1256,7 +1256,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md index 2ca4bacd8c..d473421353 100644 --- a/READMEs/README.it-IT.md +++ b/READMEs/README.it-IT.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md index 18d1747608..253ea84286 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -69,7 +69,7 @@ 54 MCP ツール 12 自動 hooks 外部 DB 0 個 - 4,400+ 件のテストが成功 + 4,500+ 件のテストが成功

@@ -1255,7 +1255,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md index 54b35e4b52..25091180c3 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1254,7 +1254,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md index f404abe30a..fe6b9e189f 100644 --- a/READMEs/README.nb-NO.md +++ b/READMEs/README.nb-NO.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1247,7 +1247,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md index 4f2a723fa5..d83f316edf 100644 --- a/READMEs/README.nl-NL.md +++ b/READMEs/README.nl-NL.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md index b6215cbe2c..6c5a94a121 100644 --- a/READMEs/README.pl-PL.md +++ b/READMEs/README.pl-PL.md @@ -69,7 +69,7 @@ 54 narzędzia MCP 12 automatycznych hooków 0 zewnętrznych baz danych - 4,400+ zaliczonych testów + 4,500+ zaliczonych testów

@@ -1239,7 +1239,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md index 2a3020d51c..785e39df45 100644 --- a/READMEs/README.pt-BR.md +++ b/READMEs/README.pt-BR.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1247,7 +1247,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md index 7d5dd04a05..c13dd11522 100644 --- a/READMEs/README.pt-PT.md +++ b/READMEs/README.pt-PT.md @@ -69,7 +69,7 @@ 54 ferramentas MCP 12 hooks automáticos 0 bases de dados externas - 4,400+ testes aprovados + 4,500+ testes aprovados

@@ -1243,7 +1243,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md index c1495e92e9..2333786508 100644 --- a/READMEs/README.ro-RO.md +++ b/READMEs/README.ro-RO.md @@ -69,7 +69,7 @@ 54 de instrumente MCP 12 hook-uri automate 0 baze de date externe - 4,400+ teste trecute + 4,500+ teste trecute

@@ -1235,7 +1235,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md index 18f84998a8..2155e0c98a 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md index 1443692691..4381b16ac6 100644 --- a/READMEs/README.sv-SE.md +++ b/READMEs/README.sv-SE.md @@ -69,7 +69,7 @@ 54 MCP-verktyg 12 automatiska hooks 0 externa databaser - 4,400+ godkända tester + 4,500+ godkända tester

@@ -1249,7 +1249,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md index dd435eac3f..47fe863712 100644 --- a/READMEs/README.th-TH.md +++ b/READMEs/README.th-TH.md @@ -69,7 +69,7 @@ 54 เครื่องมือ MCP 12 hook อัตโนมัติ ไม่ต้องพึ่ง external DB เลย - ผ่านการทดสอบ 4,400+ รายการ + ผ่านการทดสอบ 4,500+ รายการ

@@ -1242,7 +1242,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md index d10ae9448d..4c3c0788be 100644 --- a/READMEs/README.tl-PH.md +++ b/READMEs/README.tl-PH.md @@ -69,7 +69,7 @@ 54 MCP tool 12 awtomatikong hook 0 panlabas na DB - 4,400+ pumapasang test + 4,500+ pumapasang test

@@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md index a722398737..74a7497fe1 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1241,7 +1241,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md index 6f03ca9aaa..a7dcc8236a 100644 --- a/READMEs/README.uk-UA.md +++ b/READMEs/README.uk-UA.md @@ -69,7 +69,7 @@ 54 інструменти MCP 12 автоматичних хуків 0 зовнішніх БД - 4,400+ тестів пройдено + 4,500+ тестів пройдено

@@ -1242,7 +1242,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md index b81fcb3ce4..8527ed85cf 100644 --- a/READMEs/README.ur-PK.md +++ b/READMEs/README.ur-PK.md @@ -71,7 +71,7 @@ 54 MCP ٹولز 12 خودکار ہکس 0 خارجی ڈیٹابیسز - 4,400+ ٹیسٹس پاس ہو رہے ہیں + 4,500+ ٹیسٹس پاس ہو رہے ہیں

@@ -1246,7 +1246,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md index 5e157b445e..f00703fa98 100644 --- a/READMEs/README.vi-VN.md +++ b/READMEs/README.vi-VN.md @@ -69,7 +69,7 @@ 54 MCP tools 12 auto hooks 0 external DBs - 4,400+ tests passing + 4,500+ tests passing

@@ -1251,7 +1251,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md index dca9c73d72..13233660b0 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -69,7 +69,7 @@ 54 个 MCP 工具 12 个自动 hooks 0 个外部数据库 - 4,400+ 项测试通过 + 4,500+ 项测试通过

@@ -1252,7 +1252,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md index eb7a1ddb4a..0041886d6c 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -69,7 +69,7 @@ 54 個 MCP 工具 12 個自動 hooks 0 個外部資料庫 - 4,400+ 測試通過 + 4,500+ 測試通過

@@ -1244,7 +1244,7 @@ curl -X POST http://localhost:3111/agentmemory/graph/compact -H "Authorization: ```bash npm run dev # Hot reload npm run build # Production build -npm test # 4,400+ tests +npm test # 4,500+ tests npm run test:integration # API tests (requires running services) ``` diff --git a/assets/tags/light/stat-tests.svg b/assets/tags/light/stat-tests.svg index 26a2ed1add..3439518513 100644 --- a/assets/tags/light/stat-tests.svg +++ b/assets/tags/light/stat-tests.svg @@ -1,5 +1,5 @@ - + - 4400+ + 4500+ TESTS PASSING diff --git a/assets/tags/stat-tests.svg b/assets/tags/stat-tests.svg index 6b3ab1051e..9352019436 100644 --- a/assets/tags/stat-tests.svg +++ b/assets/tags/stat-tests.svg @@ -1,5 +1,5 @@ - + - 4400+ + 4500+ TESTS PASSING diff --git a/scripts/docs-sync.state.json b/scripts/docs-sync.state.json index 3ed32d2441..c62d278fdf 100644 --- a/scripts/docs-sync.state.json +++ b/scripts/docs-sync.state.json @@ -20,7 +20,7 @@ "12" ], "tests": [ - "4400+" + "4500+" ], "functions": [ "323" diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index e6b5e09dbd..2f30f6a79b 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -18,12 +18,15 @@ import { type HookManifest, } from "./codex-hooks.js"; -const CLAUDE_CONFIG_DIR = process.env["CLAUDE_CONFIG_DIR"]; -const CLAUDE_DIR = CLAUDE_CONFIG_DIR || join(homedir(), ".claude"); -const CLAUDE_JSON = CLAUDE_CONFIG_DIR - ? join(CLAUDE_DIR, ".claude.json") - : join(homedir(), ".claude.json"); -const CLAUDE_SETTINGS = join(CLAUDE_DIR, "settings.json"); +function claudeConfigPaths() { + const configDir = process.env["CLAUDE_CONFIG_DIR"]; + const dir = configDir || join(homedir(), ".claude"); + return { + dir, + mcp: configDir ? join(dir, ".claude.json") : join(homedir(), ".claude.json"), + settings: join(dir, "settings.json"), + }; +} type ClaudeMcpEntry = typeof AGENTMEMORY_MCP_BLOCK; type ClaudeConfig = { @@ -48,10 +51,11 @@ 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); + return existsSync(claudeConfigPaths().dir); }, async install(opts: ConnectOptions): Promise { + const { dir: CLAUDE_DIR, mcp: CLAUDE_JSON } = claudeConfigPaths(); const existing = readJsonSafe(CLAUDE_JSON); const next: ClaudeConfig = existing ? { ...existing } : {}; const servers: Record = { @@ -119,6 +123,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/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index 5cf4a932f9..e32958d95d 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,4 +1,5 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; +import { spawnSync } from "node:child_process"; import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; @@ -150,6 +151,65 @@ describe("connect claude-code --with-hooks", () => { expect(existsSync(join(home, ".claude"))).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 }, + { source: "AGENTMEMORY_ENV_FILE", customEnvFile: true, shellOverride: false }, + { source: "shell overriding the env file", customEnvFile: true, shellOverride: true }, + ])("installs MCP and hooks using $source", ({ customEnvFile, shellOverride }) => { + const fileProfile = join(home, "env-file Claude config"); + const shellProfile = join(home, "shell Claude config"); + const selected = shellOverride ? shellProfile : fileProfile; + mkdirSync(fileProfile); + mkdirSync(shellProfile); + mkdirSync(join(home, ".agentmemory")); + const envFile = customEnvFile + ? join(home, "custom.env") + : join(home, ".agentmemory", ".env"); + writeFileSync(envFile, `CLAUDE_CONFIG_DIR="${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: customEnvFile ? envFile : undefined, + CLAUDE_CONFIG_DIR: shellOverride ? shellProfile : undefined, + CI: "1", + NO_COLOR: "1", + }, + encoding: "utf-8", + timeout: 10000, + }); + + expect(result.status, result.stderr).toBe(0); + expect(result.stdout).toContain(`wired into ${join(selected, ".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(); + expect(existsSync(join(shellOverride ? fileProfile : shellProfile, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude.json"))).toBe(false); + expect(existsSync(join(home, ".claude"))).toBe(false); + }, 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"); From bf55c8199735116b3ce8ff9274db66fc43b5cb2a Mon Sep 17 00:00:00 2001 From: mothieras Date: Sat, 7 Nov 2026 19:00:30 +0800 Subject: [PATCH 3/8] docs(connect): clarify Claude hook paths in all READMEs Document the custom settings path selected by a non-empty CLAUDE_CONFIG_DIR and the default-path fallback in the English README and all 32 translations. Validation: build, skills generation and check, docs sync and check, and the full test suite (4,501 passed, six skipped). Signed-off-by: mothieras --- README.md | 1 + READMEs/README.ar-SA.md | 1 + READMEs/README.bn-BD.md | 1 + READMEs/README.cs-CZ.md | 1 + READMEs/README.da-DK.md | 1 + READMEs/README.de-DE.md | 1 + READMEs/README.el-GR.md | 1 + READMEs/README.es-ES.md | 1 + READMEs/README.fi-FI.md | 1 + READMEs/README.fr-FR.md | 1 + READMEs/README.he-IL.md | 1 + READMEs/README.hi-IN.md | 1 + READMEs/README.hu-HU.md | 1 + READMEs/README.id-ID.md | 1 + READMEs/README.it-IT.md | 1 + READMEs/README.ja-JP.md | 1 + READMEs/README.ko-KR.md | 1 + READMEs/README.nb-NO.md | 1 + READMEs/README.nl-NL.md | 1 + READMEs/README.pl-PL.md | 1 + READMEs/README.pt-BR.md | 1 + READMEs/README.pt-PT.md | 1 + READMEs/README.ro-RO.md | 1 + READMEs/README.ru-RU.md | 1 + READMEs/README.sv-SE.md | 1 + READMEs/README.th-TH.md | 1 + READMEs/README.tl-PH.md | 1 + READMEs/README.tr-TR.md | 1 + READMEs/README.uk-UA.md | 1 + READMEs/README.ur-PK.md | 1 + READMEs/README.vi-VN.md | 1 + READMEs/README.zh-CN.md | 1 + READMEs/README.zh-TW.md | 1 + 33 files changed, 33 insertions(+) diff --git a/README.md b/README.md index e60c37d257..4a128adfa8 100644 --- a/README.md +++ b/README.md @@ -483,6 +483,7 @@ 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. +If `CLAUDE_CONFIG_DIR` is set to a non-empty value, hooks are written to `$CLAUDE_CONFIG_DIR/settings.json`; otherwise the default path is used. 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 43d2c4d432..97530dcc5e 100644 --- a/READMEs/README.ar-SA.md +++ b/READMEs/README.ar-SA.md @@ -457,6 +457,7 @@ agentmemory connect claude-code --with-hooks ``` يُدمج هذا الأمر نفس أوامر الخطافات في `~/.claude/settings.json` بمسارات مطلقة تُحلَّل إلى دليل `plugin/` المُضمَّن في حزمة `@agentmemory/agentmemory` المثبَّتة حاليًا. أعد تشغيل الأمر بعد ترقية agentmemory لتحديث المسارات. تُحفظ إدخالات المستخدم في نفس الملف؛ ويُستبدل إدخالات agentmemory السابقة فقط. يظل استخدام مسار `/plugin install` هو الأسلوب المُوصى به. +إذا كانت قيمة `CLAUDE_CONFIG_DIR` غير فارغة، تُكتب الخطافات في `$CLAUDE_CONFIG_DIR/settings.json`؛ وإذا لم يُضبط المتغير أو كانت قيمته فارغة، يُستخدم المسار الافتراضي. بالنسبة للنشر عن بُعد أو المحمي، شغّل 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 8310128629..ec5b1ad451 100644 --- a/READMEs/README.bn-BD.md +++ b/READMEs/README.bn-BD.md @@ -453,6 +453,7 @@ agentmemory connect claude-code --with-hooks ``` এটি একই হুক কমান্ডগুলো `~/.claude/settings.json`-এ মার্জ করে, বর্তমানে ইনস্টল করা `@agentmemory/agentmemory` প্যাকেজের বান্ডলড `plugin/` ডিরেক্টরির অ্যাবসোলিউট পাথ দিয়ে। পাথ রিফ্রেশ করতে agentmemory আপগ্রেড করার পর কমান্ডটি আবার চালান। একই ফাইলের ইউজার এন্ট্রিগুলো রক্ষিত থাকে; শুধু আগের agentmemory এন্ট্রিগুলো রিপ্লেস হয়। `/plugin install` পাথটি এখনও সুপারিশকৃত পদ্ধতি। +`CLAUDE_CONFIG_DIR`-এ খালি নয় এমন মান সেট করা থাকলে hook-গুলো `$CLAUDE_CONFIG_DIR/settings.json`-এ লেখা হয়; ভেরিয়েবলটি সেট করা না থাকলে বা খালি থাকলে ডিফল্ট পথ ব্যবহার করা হয়। রিমোট বা প্রোটেক্টেড ডিপ্লয়মেন্টের জন্য, `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 5a6c82efe5..edef13ad8e 100644 --- a/READMEs/README.cs-CZ.md +++ b/READMEs/README.cs-CZ.md @@ -455,6 +455,7 @@ 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`. +Pokud má `CLAUDE_CONFIG_DIR` neprázdnou hodnotu, hooky se zapisují do `$CLAUDE_CONFIG_DIR/settings.json`; pokud proměnná není nastavena nebo je prázdná, použije se výchozí cesta. 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 4a2d0e1000..1e805c5df4 100644 --- a/READMEs/README.da-DK.md +++ b/READMEs/README.da-DK.md @@ -450,6 +450,7 @@ 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. +Hvis `CLAUDE_CONFIG_DIR` har en ikke-tom værdi, skrives hooks til `$CLAUDE_CONFIG_DIR/settings.json`; hvis variablen ikke er sat eller er tom, bruges standardstien. 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 40064c7371..6623ce6a6d 100644 --- a/READMEs/README.de-DE.md +++ b/READMEs/README.de-DE.md @@ -448,6 +448,7 @@ 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. +Wenn `CLAUDE_CONFIG_DIR` einen nicht leeren Wert hat, werden Hooks in `$CLAUDE_CONFIG_DIR/settings.json` geschrieben; ist die Variable nicht gesetzt oder leer, wird der Standardpfad verwendet. 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 63d3a6fe5d..f80cd2624b 100644 --- a/READMEs/README.el-GR.md +++ b/READMEs/README.el-GR.md @@ -455,6 +455,7 @@ agentmemory connect claude-code --with-hooks ``` Αυτό συγχωνεύει τις ίδιες εντολές hook στο `~/.claude/settings.json` με απόλυτες διαδρομές που αναλύονται στον ενσωματωμένο κατάλογο `plugin/` του πακέτου `@agentmemory/agentmemory` που είναι τρέχουσα εγκατεστημένο. Εκτελέστε ξανά την εντολή μετά την αναβάθμιση του agentmemory για να ανανεωθούν οι διαδρομές. Οι καταχωρήσεις του χρήστη στο ίδιο αρχείο διατηρούνται· αντικαθίστανται μόνο οι προηγούμενες καταχωρήσεις του agentmemory. Η χρήση της διαδρομής `/plugin install` παραμένει η συνιστώμενη προσέγγιση. +Αν το `CLAUDE_CONFIG_DIR` έχει μη κενή τιμή, τα hooks γράφονται στο `$CLAUDE_CONFIG_DIR/settings.json`, ενώ αν η μεταβλητή δεν έχει οριστεί ή είναι κενή, χρησιμοποιείται η προεπιλεγμένη διαδρομή. Για απομακρυσμένες ή προστατευμένες αναπτύξεις, εκκινήστε το 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 798c26c413..d418906190 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -450,6 +450,7 @@ 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. +Si `CLAUDE_CONFIG_DIR` tiene un valor no vacío, los hooks se escriben en `$CLAUDE_CONFIG_DIR/settings.json`; si la variable no está definida o está vacía, se usa la ruta predeterminada. 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 1a7520e672..c1b43b44cc 100644 --- a/READMEs/README.fi-FI.md +++ b/READMEs/README.fi-FI.md @@ -455,6 +455,7 @@ 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. +Jos `CLAUDE_CONFIG_DIR` on asetettu eikä sen arvo ole tyhjä, hookit kirjoitetaan tiedostoon `$CLAUDE_CONFIG_DIR/settings.json`; jos muuttujaa ei ole asetettu tai sen arvo on tyhjä, käytetään oletuspolkua. 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 42bba1dc7d..d8325561bc 100644 --- a/READMEs/README.fr-FR.md +++ b/READMEs/README.fr-FR.md @@ -450,6 +450,7 @@ 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. +Si `CLAUDE_CONFIG_DIR` a une valeur non vide, les hooks sont écrits dans `$CLAUDE_CONFIG_DIR/settings.json` ; si la variable est absente ou vide, le chemin par défaut est utilisé. 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 0b116fa100..0b9856dd4d 100644 --- a/READMEs/README.he-IL.md +++ b/READMEs/README.he-IL.md @@ -457,6 +457,7 @@ agentmemory connect claude-code --with-hooks ``` זה ממזג את אותן פקודות hook לתוך `~/.claude/settings.json` עם paths מוחלטים שנפתרים לתיקיית `plugin/` המצורפת של חבילת `@agentmemory/agentmemory` המותקנת כעת. יש להריץ את הפקודה מחדש אחרי שדרוג agentmemory כדי לרפרש את ה-paths. רשומות משתמש בקובץ עצמו נשמרות; רק רשומות agentmemory קודמות מוחלפות. השימוש בנתיב `/plugin install` נשאר הגישה המומלצת. +אם הערך של `CLAUDE_CONFIG_DIR` אינו ריק, ה-hooks נכתבים אל `$CLAUDE_CONFIG_DIR/settings.json`; אם המשתנה אינו מוגדר או ריק, נעשה שימוש בנתיב ברירת המחדל. ל-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 c628d732be..2a21d639d9 100644 --- a/READMEs/README.hi-IN.md +++ b/READMEs/README.hi-IN.md @@ -453,6 +453,7 @@ 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 बनी रहती है। +यदि `CLAUDE_CONFIG_DIR` का मान खाली नहीं है, तो hooks `$CLAUDE_CONFIG_DIR/settings.json` में लिखे जाते हैं; यदि यह सेट नहीं है या खाली है, तो डिफ़ॉल्ट पथ का उपयोग होता है। 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 6afe735b63..03557d54de 100644 --- a/READMEs/README.hu-HU.md +++ b/READMEs/README.hu-HU.md @@ -453,6 +453,7 @@ 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. +Ha a `CLAUDE_CONFIG_DIR` értéke nem üres, a hookok a `$CLAUDE_CONFIG_DIR/settings.json` fájlba kerülnek; ha a változó nincs beállítva vagy üres, az alapértelmezett útvonal marad érvényben. 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 85d729f1ec..bfe4fafea3 100644 --- a/READMEs/README.id-ID.md +++ b/READMEs/README.id-ID.md @@ -453,6 +453,7 @@ 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. +Jika `CLAUDE_CONFIG_DIR` diatur ke nilai yang tidak kosong, hook ditulis ke `$CLAUDE_CONFIG_DIR/settings.json`; jika variabel tidak diatur atau kosong, jalur default tetap digunakan. 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 d473421353..608e079efd 100644 --- a/READMEs/README.it-IT.md +++ b/READMEs/README.it-IT.md @@ -450,6 +450,7 @@ 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. +Se `CLAUDE_CONFIG_DIR` ha un valore non vuoto, gli hook vengono scritti in `$CLAUDE_CONFIG_DIR/settings.json`; se la variabile non è impostata o è vuota, viene usato il percorso predefinito. 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 253ea84286..4c23d1004b 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -453,6 +453,7 @@ agentmemory connect claude-code --with-hooks ``` 同じ hook コマンドを `~/.claude/settings.json` にマージし、現在インストールされている `@agentmemory/agentmemory` パッケージの同梱 `plugin/` ディレクトリに解決された絶対パスを書き込みます。agentmemory をアップグレードしたら、このコマンドを再実行してパスを更新してください。同じファイル内のユーザーエントリは保持され、以前の agentmemory エントリだけが置き換えられます。`/plugin install` の経路が推奨アプローチであることに変わりはありません。 +`CLAUDE_CONFIG_DIR` に空でない値が設定されている場合、hook は `$CLAUDE_CONFIG_DIR/settings.json` に書き込まれ、未設定または空の場合は既定のパスが使われます。 リモートや保護されたデプロイでは、`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 25091180c3..c0023f79bf 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -451,6 +451,7 @@ agentmemory connect claude-code --with-hooks ``` 이 명령은 현재 설치된 `@agentmemory/agentmemory` 패키지의 번들된 `plugin/` 디렉터리로 해석된 절대 경로를 사용해, 동일한 hook 명령을 `~/.claude/settings.json`에 병합합니다. agentmemory를 업그레이드한 뒤에는 동일한 명령을 다시 실행해서 경로를 갱신하십시오. 같은 파일의 사용자 항목은 보존되며, 이전 agentmemory 항목만 교체됩니다. `/plugin install` 경로를 사용하는 것이 여전히 권장되는 방식입니다. +`CLAUDE_CONFIG_DIR`에 비어 있지 않은 값이 설정되어 있으면 hook은 `$CLAUDE_CONFIG_DIR/settings.json`에 기록되며, 설정되지 않았거나 비어 있으면 기본 경로를 사용합니다. 원격 또는 보호된 배포의 경우, `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 fe6b9e189f..82bc0b200f 100644 --- a/READMEs/README.nb-NO.md +++ b/READMEs/README.nb-NO.md @@ -448,6 +448,7 @@ 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. +Hvis `CLAUDE_CONFIG_DIR` har en verdi som ikke er tom, skrives hooks til `$CLAUDE_CONFIG_DIR/settings.json`; hvis variabelen ikke er satt eller er tom, brukes standardstien. 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 d83f316edf..2338042aa1 100644 --- a/READMEs/README.nl-NL.md +++ b/READMEs/README.nl-NL.md @@ -448,6 +448,7 @@ 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. +Als `CLAUDE_CONFIG_DIR` een niet-lege waarde heeft, worden hooks naar `$CLAUDE_CONFIG_DIR/settings.json` geschreven; als de variabele niet is ingesteld of leeg is, wordt het standaardpad gebruikt. 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 6c5a94a121..6e536ab2e6 100644 --- a/READMEs/README.pl-PL.md +++ b/READMEs/README.pl-PL.md @@ -453,6 +453,7 @@ 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`. +Jeśli `CLAUDE_CONFIG_DIR` ma niepustą wartość, hooki są zapisywane w `$CLAUDE_CONFIG_DIR/settings.json`; jeśli zmienna nie jest ustawiona lub jest pusta, używana jest domyślna ścieżka. 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 785e39df45..bf8681fc6c 100644 --- a/READMEs/README.pt-BR.md +++ b/READMEs/README.pt-BR.md @@ -448,6 +448,7 @@ 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. +Se `CLAUDE_CONFIG_DIR` tiver um valor não vazio, os hooks serão gravados em `$CLAUDE_CONFIG_DIR/settings.json`; se a variável não estiver definida ou estiver vazia, o caminho padrão será usado. 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 c13dd11522..c8aa507ab6 100644 --- a/READMEs/README.pt-PT.md +++ b/READMEs/README.pt-PT.md @@ -450,6 +450,7 @@ 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. +Se `CLAUDE_CONFIG_DIR` tiver um valor não vazio, os hooks são escritos em `$CLAUDE_CONFIG_DIR/settings.json`; se a variável não estiver definida ou estiver vazia, é usado o caminho predefinido. 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 2333786508..0fa8088b96 100644 --- a/READMEs/README.ro-RO.md +++ b/READMEs/README.ro-RO.md @@ -455,6 +455,7 @@ 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ă. +Dacă `CLAUDE_CONFIG_DIR` are o valoare care nu este goală, hook-urile sunt scrise în `$CLAUDE_CONFIG_DIR/settings.json`; dacă variabila nu este setată sau este goală, se folosește calea implicită. 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 2155e0c98a..68bd5e76cc 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -455,6 +455,7 @@ agentmemory connect claude-code --with-hooks ``` Это вливает те же команды хуков в `~/.claude/settings.json` с абсолютными путями, разрешёнными в каталог `plugin/` текущего установленного пакета `@agentmemory/agentmemory`. После обновления agentmemory запустите команду ещё раз, чтобы освежить пути. Записи пользователя в этом файле сохраняются; заменяются только предыдущие записи agentmemory. Рекомендуемым способом остаётся путь через `/plugin install`. +Если `CLAUDE_CONFIG_DIR` имеет непустое значение, хуки записываются в `$CLAUDE_CONFIG_DIR/settings.json`; если переменная не задана или пуста, используется путь по умолчанию. Для удалённых или защищённых развёртываний запускайте 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 4381b16ac6..a33e322394 100644 --- a/READMEs/README.sv-SE.md +++ b/READMEs/README.sv-SE.md @@ -450,6 +450,7 @@ 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. +Om `CLAUDE_CONFIG_DIR` har ett värde som inte är tomt skrivs hooks till `$CLAUDE_CONFIG_DIR/settings.json`; om variabeln inte är satt eller är tom används standardsökvägen. 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 47fe863712..965d6a9faa 100644 --- a/READMEs/README.th-TH.md +++ b/READMEs/README.th-TH.md @@ -447,6 +447,7 @@ 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` ยังคงเป็นวิธีที่แนะนำ +หากตั้งค่า `CLAUDE_CONFIG_DIR` เป็นค่าที่ไม่ว่าง hook จะถูกเขียนลงใน `$CLAUDE_CONFIG_DIR/settings.json` แต่หากไม่ได้ตั้งค่าหรือเป็นค่าว่าง จะใช้เส้นทางเริ่มต้น สำหรับการ 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 4c3c0788be..4ffe4e6241 100644 --- a/READMEs/README.tl-PH.md +++ b/READMEs/README.tl-PH.md @@ -453,6 +453,7 @@ 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. +Kung may hindi blangkong value ang `CLAUDE_CONFIG_DIR`, isinusulat ang mga hook sa `$CLAUDE_CONFIG_DIR/settings.json`; kung hindi ito naka-set o blangko, ginagamit ang default na path. 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 74a7497fe1..f49cf09039 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -455,6 +455,7 @@ 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. +`CLAUDE_CONFIG_DIR` boş olmayan bir değere ayarlanmışsa hook'lar `$CLAUDE_CONFIG_DIR/settings.json` dosyasına yazılır; değişken ayarlanmamışsa veya boşsa varsayılan yol kullanılır. 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 a7dcc8236a..9de647ce93 100644 --- a/READMEs/README.uk-UA.md +++ b/READMEs/README.uk-UA.md @@ -455,6 +455,7 @@ agentmemory connect claude-code --with-hooks ``` Ця команда об'єднує ті самі команди хуків у `~/.claude/settings.json`, використовуючи абсолютні шляхи, визначені до вбудованого каталогу `plugin/` наразі встановленого пакета `@agentmemory/agentmemory`. Повторно запустіть команду після оновлення agentmemory, щоб оновити шляхи. Записи користувача в тому самому файлі зберігаються; замінюються лише попередні записи agentmemory. Шлях через `/plugin install` залишається рекомендованим підходом. +Якщо `CLAUDE_CONFIG_DIR` має непорожнє значення, хуки записуються до `$CLAUDE_CONFIG_DIR/settings.json`; якщо змінну не задано або вона порожня, використовується типовий шлях. Для віддалених або захищених розгортань запускайте 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 8527ed85cf..e0961bb97e 100644 --- a/READMEs/README.ur-PK.md +++ b/READMEs/README.ur-PK.md @@ -455,6 +455,7 @@ 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` راستہ استعمال کرنا ہی تجویز کردہ طریقہ رہتا ہے۔ +اگر `CLAUDE_CONFIG_DIR` کی قدر خالی نہیں ہے تو hooks کو `$CLAUDE_CONFIG_DIR/settings.json` میں لکھا جاتا ہے؛ اگر متغیر سیٹ نہیں ہے یا خالی ہے تو پہلے سے طے شدہ راستہ استعمال ہوتا ہے۔ ریموٹ یا محفوظ 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 f00703fa98..175b06c8d6 100644 --- a/READMEs/README.vi-VN.md +++ b/READMEs/README.vi-VN.md @@ -453,6 +453,7 @@ 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ị. +Nếu `CLAUDE_CONFIG_DIR` có giá trị không rỗng, các hook được ghi vào `$CLAUDE_CONFIG_DIR/settings.json`; nếu biến chưa được đặt hoặc để trống, đường dẫn mặc định được sử dụng. 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 13233660b0..8b694e877d 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -453,6 +453,7 @@ agentmemory connect claude-code --with-hooks ``` 这会把同样的 hook 命令合并进 `~/.claude/settings.json`,绝对路径会解析到当前安装的 `@agentmemory/agentmemory` 包自带的 `plugin/` 目录。升级 agentmemory 之后重新运行该命令以刷新路径。同一文件中的用户条目会被保留;只会替换之前的 agentmemory 条目。仍然推荐使用 `/plugin install` 路径。 +若 `CLAUDE_CONFIG_DIR` 非空,hook 会写入 `$CLAUDE_CONFIG_DIR/settings.json`;未设置或为空时仍使用默认路径。 对于远程或受保护的部署,启动 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 0041886d6c..bf3dd1825d 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -451,6 +451,7 @@ agentmemory connect claude-code --with-hooks ``` 這會把同樣的 hook 指令合併到 `~/.claude/settings.json` 中,絕對路徑會解析到目前安裝的 `@agentmemory/agentmemory` 套件所捆綁的 `plugin/` 目錄。升級 agentmemory 後重新執行此指令以刷新路徑。同一檔案中既有的使用者條目會被保留;只有先前的 agentmemory 條目會被取代。仍然建議使用 `/plugin install` 路徑。 +若 `CLAUDE_CONFIG_DIR` 非空,hook 會寫入 `$CLAUDE_CONFIG_DIR/settings.json`;未設定或為空時仍使用預設路徑。 若用於遠端或受保護的部署,啟動 Claude Code 時請設定 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。外掛會把這兩個值都傳給它捆綁的 MCP 伺服器;當 `AGENTMEMORY_URL` 為空時,MCP shim 會使用 `http://localhost:3111`。 ### Codex CLI(Codex 外掛平台) From ecb31e136d154ca347c2c4abc0d4cc6d56c0fd85 Mon Sep 17 00:00:00 2001 From: mothieras Date: Sat, 7 Nov 2026 19:23:50 +0800 Subject: [PATCH 4/8] docs(connect): clarify Claude Code profile configuration Document default and custom MCP and hook paths together in the English README and all 32 translations. Explain that Claude Code needs the same CLAUDE_CONFIG_DIR in its launch environment even when the connector reads it from AgentMemory's .env. Validation: build, skills generation and check, docs sync and check, and the full test suite (4,501 passed, six skipped). Signed-off-by: mothieras --- README.md | 7 ++++--- READMEs/README.ar-SA.md | 7 ++++--- READMEs/README.bn-BD.md | 7 ++++--- READMEs/README.cs-CZ.md | 7 ++++--- READMEs/README.da-DK.md | 7 ++++--- READMEs/README.de-DE.md | 7 ++++--- READMEs/README.el-GR.md | 7 ++++--- READMEs/README.es-ES.md | 7 ++++--- READMEs/README.fi-FI.md | 7 ++++--- READMEs/README.fr-FR.md | 7 ++++--- READMEs/README.he-IL.md | 7 ++++--- READMEs/README.hi-IN.md | 7 ++++--- READMEs/README.hu-HU.md | 7 ++++--- READMEs/README.id-ID.md | 7 ++++--- READMEs/README.it-IT.md | 7 ++++--- READMEs/README.ja-JP.md | 7 ++++--- READMEs/README.ko-KR.md | 7 ++++--- READMEs/README.nb-NO.md | 7 ++++--- READMEs/README.nl-NL.md | 7 ++++--- READMEs/README.pl-PL.md | 7 ++++--- READMEs/README.pt-BR.md | 7 ++++--- READMEs/README.pt-PT.md | 7 ++++--- READMEs/README.ro-RO.md | 7 ++++--- READMEs/README.ru-RU.md | 7 ++++--- READMEs/README.sv-SE.md | 7 ++++--- READMEs/README.th-TH.md | 7 ++++--- READMEs/README.tl-PH.md | 7 ++++--- READMEs/README.tr-TR.md | 7 ++++--- READMEs/README.uk-UA.md | 7 ++++--- READMEs/README.ur-PK.md | 7 ++++--- READMEs/README.vi-VN.md | 7 ++++--- READMEs/README.zh-CN.md | 7 ++++--- READMEs/README.zh-TW.md | 7 ++++--- 33 files changed, 132 insertions(+), 99 deletions(-) diff --git a/README.md b/README.md index 4a128adfa8..4e8b00e551 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,8 +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. -If `CLAUDE_CONFIG_DIR` is set to a non-empty value, hooks are written to `$CLAUDE_CONFIG_DIR/settings.json`; otherwise the default path is used. +This command configures the MCP server and merges the bundled hooks into Claude Code’s user configuration. When `CLAUDE_CONFIG_DIR` is unset or empty, it uses `~/.claude.json` for MCP and `~/.claude/settings.json` for hooks. 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`. + +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 97530dcc5e..bfad5abdbe 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,8 +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` هو الأسلوب المُوصى به. -إذا كانت قيمة `CLAUDE_CONFIG_DIR` غير فارغة، تُكتب الخطافات في `$CLAUDE_CONFIG_DIR/settings.json`؛ وإذا لم يُضبط المتغير أو كانت قيمته فارغة، يُستخدم المسار الافتراضي. +يضبط هذا الأمر خادم 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. + +تستخدم أوامر الخطافات مسارات مطلقة إلى دليل `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 ec5b1ad451..7f0cd7e870 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,8 +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` পাথটি এখনও সুপারিশকৃত পদ্ধতি। -`CLAUDE_CONFIG_DIR`-এ খালি নয় এমন মান সেট করা থাকলে hook-গুলো `$CLAUDE_CONFIG_DIR/settings.json`-এ লেখা হয়; ভেরিয়েবলটি সেট করা না থাকলে বা খালি থাকলে ডিফল্ট পথ ব্যবহার করা হয়। +এই কমান্ড 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 চালু করার এনভায়রনমেন্টে এই মান থাকতে হবে। + +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 edef13ad8e..224a7bdf34 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,8 +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`. -Pokud má `CLAUDE_CONFIG_DIR` neprázdnou hodnotu, hooky se zapisují do `$CLAUDE_CONFIG_DIR/settings.json`; pokud proměnná není nastavena nebo je prázdná, použije se výchozí cesta. +Tento příkaz nastaví server MCP a sloučí přibalené hooky do uživatelské konfigurace Claude Code. Pokud `CLAUDE_CONFIG_DIR` není nastavena nebo je prázdná, použije pro MCP soubor `~/.claude.json` a pro hooky `~/.claude/settings.json`. 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. + +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 1e805c5df4..6f495bb5c1 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,8 +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. -Hvis `CLAUDE_CONFIG_DIR` har en ikke-tom værdi, skrives hooks til `$CLAUDE_CONFIG_DIR/settings.json`; hvis variablen ikke er sat eller er tom, bruges standardstien. +Denne kommando konfigurerer MCP-serveren og fletter de medfølgende hooks ind i Claude Codes brugerkonfiguration. Hvis `CLAUDE_CONFIG_DIR` ikke er sat eller er tom, bruges `~/.claude.json` til MCP og `~/.claude/settings.json` til hooks. 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`. + +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 6623ce6a6d..d313ec6f5b 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,8 +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. -Wenn `CLAUDE_CONFIG_DIR` einen nicht leeren Wert hat, werden Hooks in `$CLAUDE_CONFIG_DIR/settings.json` geschrieben; ist die Variable nicht gesetzt oder leer, wird der Standardpfad verwendet. +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, verwendet er `~/.claude.json` für MCP und `~/.claude/settings.json` für Hooks. 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. + +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 f80cd2624b..c31e2b96b0 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,8 +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` παραμένει η συνιστώμενη προσέγγιση. -Αν το `CLAUDE_CONFIG_DIR` έχει μη κενή τιμή, τα hooks γράφονται στο `$CLAUDE_CONFIG_DIR/settings.json`, ενώ αν η μεταβλητή δεν έχει οριστεί ή είναι κενή, χρησιμοποιείται η προεπιλεγμένη διαδρομή. +Αυτή η εντολή ρυθμίζει τον διακομιστή 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. + +Οι εντολές των 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 d418906190..a8332f3d54 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,8 +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. -Si `CLAUDE_CONFIG_DIR` tiene un valor no vacío, los hooks se escriben en `$CLAUDE_CONFIG_DIR/settings.json`; si la variable no está definida o está vacía, se usa la ruta predeterminada. +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 o está vacía, usa `~/.claude.json` para MCP y `~/.claude/settings.json` para los hooks. 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. + +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 c1b43b44cc..6c112bb0e9 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,8 +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. -Jos `CLAUDE_CONFIG_DIR` on asetettu eikä sen arvo ole tyhjä, hookit kirjoitetaan tiedostoon `$CLAUDE_CONFIG_DIR/settings.json`; jos muuttujaa ei ole asetettu tai sen arvo on tyhjä, käytetään oletuspolkua. +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 tai tyhjä, se käyttää MCP:lle tiedostoa `~/.claude.json` ja hookeille tiedostoa `~/.claude/settings.json`. 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. + +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 d8325561bc..845c7098cc 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,8 +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. -Si `CLAUDE_CONFIG_DIR` a une valeur non vide, les hooks sont écrits dans `$CLAUDE_CONFIG_DIR/settings.json` ; si la variable est absente ou vide, le chemin par défaut est utilisé. +Cette commande configure le serveur MCP et fusionne les hooks inclus dans la configuration utilisateur de Claude Code. Si `CLAUDE_CONFIG_DIR` est absente ou vide, elle utilise `~/.claude.json` pour MCP et `~/.claude/settings.json` pour les hooks. 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. + +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 0b9856dd4d..b2076b55ae 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,8 +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` נשאר הגישה המומלצת. -אם הערך של `CLAUDE_CONFIG_DIR` אינו ריק, ה-hooks נכתבים אל `$CLAUDE_CONFIG_DIR/settings.json`; אם המשתנה אינו מוגדר או ריק, נעשה שימוש בנתיב ברירת המחדל. +הפקודה מגדירה את שרת ה-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. + +פקודות ה-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 2a21d639d9..4ef23aee3c 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,8 +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 बनी रहती है। -यदि `CLAUDE_CONFIG_DIR` का मान खाली नहीं है, तो hooks `$CLAUDE_CONFIG_DIR/settings.json` में लिखे जाते हैं; यदि यह सेट नहीं है या खाली है, तो डिफ़ॉल्ट पथ का उपयोग होता है। +यह कमांड 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` से पढ़ता हो। + +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 03557d54de..e650e98899 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,8 +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. -Ha a `CLAUDE_CONFIG_DIR` értéke nem üres, a hookok a `$CLAUDE_CONFIG_DIR/settings.json` fájlba kerülnek; ha a változó nincs beállítva vagy üres, az alapértelmezett útvonal marad érvényben. +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 vagy üres, az MCP-hez a `~/.claude.json`, a hookokhoz pedig a `~/.claude/settings.json` fájlt használja. 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 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 bfe4fafea3..e3f664cf37 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,8 +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. -Jika `CLAUDE_CONFIG_DIR` diatur ke nilai yang tidak kosong, hook ditulis ke `$CLAUDE_CONFIG_DIR/settings.json`; jika variabel tidak diatur atau kosong, jalur default tetap digunakan. +Perintah ini mengonfigurasi server MCP dan menggabungkan hook bawaan ke konfigurasi pengguna Claude Code. Jika `CLAUDE_CONFIG_DIR` tidak diatur atau kosong, perintah ini menggunakan `~/.claude.json` untuk MCP dan `~/.claude/settings.json` untuk hook. 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. + +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 608e079efd..e265db3c43 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,8 +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. -Se `CLAUDE_CONFIG_DIR` ha un valore non vuoto, gli hook vengono scritti in `$CLAUDE_CONFIG_DIR/settings.json`; se la variabile non è impostata o è vuota, viene usato il percorso predefinito. +Questo comando configura il server MCP e unisce gli hook inclusi alla configurazione utente di Claude Code. Se `CLAUDE_CONFIG_DIR` non è impostata o è vuota, usa `~/.claude.json` per MCP e `~/.claude/settings.json` per gli hook. 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. + +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 4c23d1004b..241cc12982 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,8 +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` の経路が推奨アプローチであることに変わりはありません。 -`CLAUDE_CONFIG_DIR` に空でない値が設定されている場合、hook は `$CLAUDE_CONFIG_DIR/settings.json` に書き込まれ、未設定または空の場合は既定のパスが使われます。 +このコマンドは 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 自身の起動環境にこの値を設定する必要があります。 + +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 c0023f79bf..acb5beee09 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,8 +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` 경로를 사용하는 것이 여전히 권장되는 방식입니다. -`CLAUDE_CONFIG_DIR`에 비어 있지 않은 값이 설정되어 있으면 hook은 `$CLAUDE_CONFIG_DIR/settings.json`에 기록되며, 설정되지 않았거나 비어 있으면 기본 경로를 사용합니다. +이 명령은 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 자체의 실행 환경에 이 값이 전달되어야 합니다. + +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 82bc0b200f..af630bf113 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,8 +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. -Hvis `CLAUDE_CONFIG_DIR` har en verdi som ikke er tom, skrives hooks til `$CLAUDE_CONFIG_DIR/settings.json`; hvis variabelen ikke er satt eller er tom, brukes standardstien. +Denne kommandoen konfigurerer MCP-serveren og fletter de medfølgende hookene inn i Claude Codes brukerkonfigurasjon. Hvis `CLAUDE_CONFIG_DIR` ikke er satt eller er tom, brukes `~/.claude.json` for MCP og `~/.claude/settings.json` for hooks. 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`. + +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 2338042aa1..186cb49718 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,8 +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. -Als `CLAUDE_CONFIG_DIR` een niet-lege waarde heeft, worden hooks naar `$CLAUDE_CONFIG_DIR/settings.json` geschreven; als de variabele niet is ingesteld of leeg is, wordt het standaardpad gebruikt. +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 of leeg is, gebruikt het `~/.claude.json` voor MCP en `~/.claude/settings.json` voor hooks. 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. + +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 6e536ab2e6..f2de8c0761 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,8 +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`. -Jeśli `CLAUDE_CONFIG_DIR` ma niepustą wartość, hooki są zapisywane w `$CLAUDE_CONFIG_DIR/settings.json`; jeśli zmienna nie jest ustawiona lub jest pusta, używana jest domyślna ścieżka. +Ta komenda konfiguruje serwer MCP i scala dołączone hooki z konfiguracją użytkownika Claude Code. Jeśli `CLAUDE_CONFIG_DIR` nie jest ustawiona lub jest pusta, używa `~/.claude.json` dla MCP i `~/.claude/settings.json` dla hooków. 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. + +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 bf8681fc6c..953329cc69 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,8 +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. -Se `CLAUDE_CONFIG_DIR` tiver um valor não vazio, os hooks serão gravados em `$CLAUDE_CONFIG_DIR/settings.json`; se a variável não estiver definida ou estiver vazia, o caminho padrão será usado. +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 ou estiver vazia, ele usa `~/.claude.json` para MCP e `~/.claude/settings.json` para hooks. 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. + +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 c8aa507ab6..6c953a6641 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,8 +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. -Se `CLAUDE_CONFIG_DIR` tiver um valor não vazio, os hooks são escritos em `$CLAUDE_CONFIG_DIR/settings.json`; se a variável não estiver definida ou estiver vazia, é usado o caminho predefinido. +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 ou estiver vazia, usa `~/.claude.json` para MCP e `~/.claude/settings.json` para os hooks. 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. + +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 0fa8088b96..e1f659d0f4 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,8 +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ă. -Dacă `CLAUDE_CONFIG_DIR` are o valoare care nu este goală, hook-urile sunt scrise în `$CLAUDE_CONFIG_DIR/settings.json`; dacă variabila nu este setată sau este goală, se folosește calea implicită. +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ă sau este goală, folosește `~/.claude.json` pentru MCP și `~/.claude/settings.json` pentru hook-uri. 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. + +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 68bd5e76cc..ff0928b65e 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,8 +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`. -Если `CLAUDE_CONFIG_DIR` имеет непустое значение, хуки записываются в `$CLAUDE_CONFIG_DIR/settings.json`; если переменная не задана или пуста, используется путь по умолчанию. +Эта команда настраивает 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. + +Команды хуков используют абсолютные пути к каталогу `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 a33e322394..e57a3d75ea 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,8 +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. -Om `CLAUDE_CONFIG_DIR` har ett värde som inte är tomt skrivs hooks till `$CLAUDE_CONFIG_DIR/settings.json`; om variabeln inte är satt eller är tom används standardsökvägen. +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 eller är tom används `~/.claude.json` för MCP och `~/.claude/settings.json` för hooks. 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`. + +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 965d6a9faa..bfac024c3c 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,8 +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` ยังคงเป็นวิธีที่แนะนำ -หากตั้งค่า `CLAUDE_CONFIG_DIR` เป็นค่าที่ไม่ว่าง hook จะถูกเขียนลงใน `$CLAUDE_CONFIG_DIR/settings.json` แต่หากไม่ได้ตั้งค่าหรือเป็นค่าว่าง จะใช้เส้นทางเริ่มต้น +คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ 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 ก็ตาม + +คำสั่ง 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 4ffe4e6241..9c4c975e02 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,8 +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. -Kung may hindi blangkong value ang `CLAUDE_CONFIG_DIR`, isinusulat ang mga hook sa `$CLAUDE_CONFIG_DIR/settings.json`; kung hindi ito naka-set o blangko, ginagamit ang default na path. +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 o blangko ang `CLAUDE_CONFIG_DIR`, ginagamit nito ang `~/.claude.json` para sa MCP at `~/.claude/settings.json` para sa mga hook. 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. + +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 f49cf09039..e091d7cdb4 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,8 +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. -`CLAUDE_CONFIG_DIR` boş olmayan bir değere ayarlanmışsa hook'lar `$CLAUDE_CONFIG_DIR/settings.json` dosyasına yazılır; değişken ayarlanmamışsa veya boşsa varsayılan yol kullanılı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 veya boşsa MCP için `~/.claude.json`, hook’lar için `~/.claude/settings.json` 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. + +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 9de647ce93..dcb0a1a789 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,8 +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` залишається рекомендованим підходом. -Якщо `CLAUDE_CONFIG_DIR` має непорожнє значення, хуки записуються до `$CLAUDE_CONFIG_DIR/settings.json`; якщо змінну не задано або вона порожня, використовується типовий шлях. +Ця команда налаштовує 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. + +Команди хуків використовують абсолютні шляхи до каталогу `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 e0961bb97e..d1120cf05a 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,8 +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` راستہ استعمال کرنا ہی تجویز کردہ طریقہ رہتا ہے۔ -اگر `CLAUDE_CONFIG_DIR` کی قدر خالی نہیں ہے تو hooks کو `$CLAUDE_CONFIG_DIR/settings.json` میں لکھا جاتا ہے؛ اگر متغیر سیٹ نہیں ہے یا خالی ہے تو پہلے سے طے شدہ راستہ استعمال ہوتا ہے۔ +یہ کمانڈ 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` سے پڑھتا ہو۔ + +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 175b06c8d6..2a3d5d9090 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,8 +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ị. -Nếu `CLAUDE_CONFIG_DIR` có giá trị không rỗng, các hook được ghi vào `$CLAUDE_CONFIG_DIR/settings.json`; nếu biến chưa được đặt hoặc để trống, đường dẫn mặc định được sử dụng. +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 hoặc để trống, lệnh dùng `~/.claude.json` cho MCP và `~/.claude/settings.json` cho các hook. Để 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. + +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 8b694e877d..05da4d398b 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,8 +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` 路径。 -若 `CLAUDE_CONFIG_DIR` 非空,hook 会写入 `$CLAUDE_CONFIG_DIR/settings.json`;未设置或为空时仍使用默认路径。 +此命令会配置 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 自身的启动环境中也必须设置该值。 + +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 bf3dd1825d..e1c7d3676a 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,8 +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` 路徑。 -若 `CLAUDE_CONFIG_DIR` 非空,hook 會寫入 `$CLAUDE_CONFIG_DIR/settings.json`;未設定或為空時仍使用預設路徑。 +此指令會設定 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 本身的啟動環境中也必須設定該值。 + +Hook 指令使用絕對路徑,指向已安裝套件內的 `plugin/` 目錄。升級 agentmemory 後,請重新執行此指令以更新這些路徑。設定檔中的使用者條目會保留,僅取代先前的 agentmemory 條目。仍建議使用 `/plugin install`。 若用於遠端或受保護的部署,啟動 Claude Code 時請設定 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。外掛會把這兩個值都傳給它捆綁的 MCP 伺服器;當 `AGENTMEMORY_URL` 為空時,MCP shim 會使用 `http://localhost:3111`。 ### Codex CLI(Codex 外掛平台) From 693092b1f61e727b86a0d32fdfd204b0c825083b Mon Sep 17 00:00:00 2001 From: mothieras Date: Sun, 8 Nov 2026 16:24:19 +0800 Subject: [PATCH 5/8] fix(connect): warn for Claude profiles loaded from env files Warn before connecting when CLAUDE_CONFIG_DIR was hydrated only from AgentMemory's env file, so users launch Claude Code with the same profile. Values already present in the shell, including identical values, do not trigger the warning. Trim surrounding whitespace before resolving detection, MCP and hook paths; whitespace-only values retain the legacy defaults. Document whitespace handling and the existing directory prerequisite in all 33 READMEs. Validation: seven new regression cases; 62 affected tests pass. Build, skills generation and check, docs sync and check, and the full test suite pass (4,508 passed, six skipped). Signed-off-by: mothieras --- README.md | 2 +- READMEs/README.ar-SA.md | 2 +- READMEs/README.bn-BD.md | 2 +- READMEs/README.cs-CZ.md | 2 +- READMEs/README.da-DK.md | 2 +- READMEs/README.de-DE.md | 2 +- READMEs/README.el-GR.md | 2 +- READMEs/README.es-ES.md | 2 +- READMEs/README.fi-FI.md | 2 +- READMEs/README.fr-FR.md | 2 +- READMEs/README.he-IL.md | 2 +- READMEs/README.hi-IN.md | 2 +- READMEs/README.hu-HU.md | 2 +- READMEs/README.id-ID.md | 2 +- READMEs/README.it-IT.md | 2 +- READMEs/README.ja-JP.md | 2 +- READMEs/README.ko-KR.md | 2 +- READMEs/README.nb-NO.md | 2 +- READMEs/README.nl-NL.md | 2 +- READMEs/README.pl-PL.md | 2 +- READMEs/README.pt-BR.md | 2 +- READMEs/README.pt-PT.md | 2 +- READMEs/README.ro-RO.md | 2 +- READMEs/README.ru-RU.md | 2 +- READMEs/README.sv-SE.md | 2 +- READMEs/README.th-TH.md | 2 +- READMEs/README.tl-PH.md | 2 +- READMEs/README.tr-TR.md | 2 +- READMEs/README.uk-UA.md | 2 +- READMEs/README.ur-PK.md | 2 +- READMEs/README.vi-VN.md | 2 +- READMEs/README.zh-CN.md | 2 +- READMEs/README.zh-TW.md | 2 +- src/cli/connect/claude-code.ts | 11 +++- src/config.ts | 11 +++- test/claude-code-with-hooks.test.ts | 96 ++++++++++++++++++++++++++--- 36 files changed, 139 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index 4e8b00e551..a8c81d5365 100644 --- a/README.md +++ b/README.md @@ -482,7 +482,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -This command configures the MCP server and merges the bundled hooks into Claude Code’s user configuration. When `CLAUDE_CONFIG_DIR` is unset or empty, it uses `~/.claude.json` for MCP and `~/.claude/settings.json` for hooks. 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`. +This command configures the MCP server and merges the bundled hooks into Claude Code’s user configuration. When `CLAUDE_CONFIG_DIR` is unset or empty after trimming surrounding whitespace, it uses `~/.claude.json` for MCP and `~/.claude/settings.json` for hooks. 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. 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. diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md index bfad5abdbe..72d9125503 100644 --- a/READMEs/README.ar-SA.md +++ b/READMEs/README.ar-SA.md @@ -456,7 +456,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -يضبط هذا الأمر خادم 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. +يضبط هذا الأمر خادم 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 باعتباره غير مكتشف. تستخدم أوامر الخطافات مسارات مطلقة إلى دليل `plugin/` المضمّن في الحزمة المثبّتة. أعد تشغيل الأمر بعد ترقية agentmemory لتحديث تلك المسارات. تُحفظ إدخالات المستخدم في ملفات الإعدادات؛ ولا تُستبدل إلا إدخالات agentmemory السابقة. يظل استخدام `/plugin install` هو النهج الموصى به. بالنسبة للنشر عن بُعد أو المحمي، شغّل Claude Code مع ضبط `AGENTMEMORY_URL` و`AGENTMEMORY_SECRET`. تُمرّر الإضافة كلتا القيمتين إلى خادم MCP المُضمَّن بها؛ وعندما يكون `AGENTMEMORY_URL` فارغًا، يستخدم وسيط MCP (shim) عنوان `http://localhost:3111`. diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md index 7f0cd7e870..a49f75ba7a 100644 --- a/READMEs/README.bn-BD.md +++ b/READMEs/README.bn-BD.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -এই কমান্ড 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 চালু করার এনভায়রনমেন্টে এই মান থাকতে হবে। +এই কমান্ড 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-কে শনাক্ত করতে না পেরে এড়িয়ে যাবে। Hook কমান্ডগুলো ইনস্টল করা প্যাকেজের সঙ্গে থাকা `plugin/` ডিরেক্টরির অ্যাবসোলিউট পথ ব্যবহার করে। agentmemory আপগ্রেড করার পরে পথগুলো হালনাগাদ করতে কমান্ডটি আবার চালান। কনফিগারেশন ফাইলে ব্যবহারকারীর এন্ট্রিগুলো সংরক্ষিত থাকে; শুধু আগের agentmemory এন্ট্রিগুলো প্রতিস্থাপিত হয়। `/plugin install` ব্যবহার করাই সুপারিশকৃত পদ্ধতি। রিমোট বা প্রোটেক্টেড ডিপ্লয়মেন্টের জন্য, `AGENTMEMORY_URL` এবং `AGENTMEMORY_SECRET` সেট করে Claude Code লঞ্চ করুন। প্লাগইন দুটি ভ্যালুই তার বান্ডলড MCP সার্ভারে পাস করে; `AGENTMEMORY_URL` খালি থাকলে, MCP শিম `http://localhost:3111` ব্যবহার করে। diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md index 224a7bdf34..a6ba7fa05f 100644 --- a/READMEs/README.cs-CZ.md +++ b/READMEs/README.cs-CZ.md @@ -454,7 +454,7 @@ Pokud zapojíte server MCP agentmemory přímo přes `~/.claude.json` (výchozí agentmemory connect claude-code --with-hooks ``` -Tento příkaz nastaví server MCP a sloučí přibalené hooky do uživatelské konfigurace Claude Code. Pokud `CLAUDE_CONFIG_DIR` není nastavena nebo je prázdná, použije pro MCP soubor `~/.claude.json` a pro hooky `~/.claude/settings.json`. 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. +Tento příkaz nastaví server MCP a sloučí přibalené hooky do uživatelské konfigurace Claude Code. Pokud `CLAUDE_CONFIG_DIR` není nastavena nebo je po odstranění okolních bílých znaků prázdná, použije pro MCP soubor `~/.claude.json` a pro hooky `~/.claude/settings.json`. 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. 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`. diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md index 6f495bb5c1..e75a04636f 100644 --- a/READMEs/README.da-DK.md +++ b/READMEs/README.da-DK.md @@ -449,7 +449,7 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Denne kommando konfigurerer MCP-serveren og fletter de medfølgende hooks ind i Claude Codes brugerkonfiguration. Hvis `CLAUDE_CONFIG_DIR` ikke er sat eller er tom, bruges `~/.claude.json` til MCP og `~/.claude/settings.json` til hooks. 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`. +Denne kommando konfigurerer MCP-serveren og fletter de medfølgende hooks ind i Claude Codes brugerkonfiguration. Hvis `CLAUDE_CONFIG_DIR` ikke er sat eller er tom efter fjernelse af indledende og afsluttende blanktegn, bruges `~/.claude.json` til MCP og `~/.claude/settings.json` til hooks. 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. 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`. diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md index d313ec6f5b..3414ecee42 100644 --- a/READMEs/README.de-DE.md +++ b/READMEs/README.de-DE.md @@ -447,7 +447,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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, verwendet er `~/.claude.json` für MCP und `~/.claude/settings.json` für Hooks. 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. +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 nach dem Entfernen von Leerraum am Anfang und Ende leer ist, verwendet er `~/.claude.json` für MCP und `~/.claude/settings.json` für Hooks. 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. 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`. diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md index c31e2b96b0..b3213c773c 100644 --- a/READMEs/README.el-GR.md +++ b/READMEs/README.el-GR.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Αυτή η εντολή ρυθμίζει τον διακομιστή 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. +Αυτή η εντολή ρυθμίζει τον διακομιστή 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 επειδή δεν το εντοπίζει. Οι εντολές των hooks χρησιμοποιούν απόλυτες διαδρομές προς τον ενσωματωμένο κατάλογο `plugin/` του εγκατεστημένου πακέτου. Εκτελέστε ξανά την εντολή μετά την αναβάθμιση του agentmemory για να ενημερώσετε αυτές τις διαδρομές. Οι καταχωρίσεις χρήστη στα αρχεία διαμόρφωσης διατηρούνται και αντικαθίστανται μόνο οι προηγούμενες καταχωρίσεις του agentmemory. Η χρήση του `/plugin install` παραμένει η προτεινόμενη προσέγγιση. Για απομακρυσμένες ή προστατευμένες αναπτύξεις, εκκινήστε το Claude Code με ρυθμισμένα τα `AGENTMEMORY_URL` και `AGENTMEMORY_SECRET`. Το plugin περνάει και τις δύο τιμές στον ενσωματωμένο διακομιστή MCP του· όταν το `AGENTMEMORY_URL` είναι άδειο, το MCP shim χρησιμοποιεί το `http://localhost:3111`. diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md index a8332f3d54..c1213529b7 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -449,7 +449,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 o está vacía, usa `~/.claude.json` para MCP y `~/.claude/settings.json` para los hooks. 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. +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 o queda vacía tras quitar los espacios en blanco de los extremos, usa `~/.claude.json` para MCP y `~/.claude/settings.json` para los hooks. 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. 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`. diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md index 6c112bb0e9..92b6d2a692 100644 --- a/READMEs/README.fi-FI.md +++ b/READMEs/README.fi-FI.md @@ -454,7 +454,7 @@ Kiertotapa: agentmemory connect claude-code --with-hooks ``` -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 tai tyhjä, se käyttää MCP:lle tiedostoa `~/.claude.json` ja hookeille tiedostoa `~/.claude/settings.json`. 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. +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 tai tyhjä ympäröivien tyhjien merkkien poistamisen jälkeen, se käyttää MCP:lle tiedostoa `~/.claude.json` ja hookeille tiedostoa `~/.claude/settings.json`. 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. 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`. diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md index 845c7098cc..80a906e9e1 100644 --- a/READMEs/README.fr-FR.md +++ b/READMEs/README.fr-FR.md @@ -449,7 +449,7 @@ Solution de contournement : agentmemory connect claude-code --with-hooks ``` -Cette commande configure le serveur MCP et fusionne les hooks inclus dans la configuration utilisateur de Claude Code. Si `CLAUDE_CONFIG_DIR` est absente ou vide, elle utilise `~/.claude.json` pour MCP et `~/.claude/settings.json` pour les hooks. 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. +Cette commande configure le serveur MCP et fusionne les hooks inclus dans la configuration utilisateur de Claude Code. Si `CLAUDE_CONFIG_DIR` est absente ou vide après suppression des espaces en début et en fin de valeur, elle utilise `~/.claude.json` pour MCP et `~/.claude/settings.json` pour les hooks. 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. 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`. diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md index b2076b55ae..67adeb4b03 100644 --- a/READMEs/README.he-IL.md +++ b/READMEs/README.he-IL.md @@ -456,7 +456,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -הפקודה מגדירה את שרת ה-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. +הפקודה מגדירה את שרת ה-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 כי הוא לא זוהה. פקודות ה-hook משתמשות בנתיבים מוחלטים לתיקיית `plugin/` המצורפת לחבילה המותקנת. הפעילו שוב את הפקודה לאחר שדרוג agentmemory כדי לרענן את הנתיבים. רשומות המשתמש בקובצי התצורה נשמרות; רק רשומות קודמות של agentmemory מוחלפות. השימוש ב-`/plugin install` נותר הדרך המומלצת. ל-deployments מרוחקים או מוגנים, הפעילו את Claude Code עם `AGENTMEMORY_URL` ו-`AGENTMEMORY_SECRET` מוגדרים. ה-plugin מעביר את שני הערכים לשרת ה-MCP המצורף שלו; כש-`AGENTMEMORY_URL` ריק, ה-shim של MCP משתמש ב-`http://localhost:3111`. diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md index 4ef23aee3c..9cfc9cdf6d 100644 --- a/READMEs/README.hi-IN.md +++ b/READMEs/README.hi-IN.md @@ -452,7 +452,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -यह कमांड 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` से पढ़ता हो। +यह कमांड 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 को नहीं पहचान पाता और उसे छोड़ देता है। 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` का उपयोग करता है। diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md index e650e98899..39f81de16e 100644 --- a/READMEs/README.hu-HU.md +++ b/READMEs/README.hu-HU.md @@ -452,7 +452,7 @@ Megoldás: agentmemory connect claude-code --with-hooks ``` -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 vagy üres, az MCP-hez a `~/.claude.json`, a hookokhoz pedig a `~/.claude/settings.json` fájlt használja. 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. +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, vagy az érték elején és végén lévő üres karakterek eltávolítása után üres, az MCP-hez a `~/.claude.json`, a hookokhoz pedig a `~/.claude/settings.json` fájlt használja. 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. 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. diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md index e3f664cf37..eabfb8bb30 100644 --- a/READMEs/README.id-ID.md +++ b/READMEs/README.id-ID.md @@ -452,7 +452,7 @@ Solusinya: agentmemory connect claude-code --with-hooks ``` -Perintah ini mengonfigurasi server MCP dan menggabungkan hook bawaan ke konfigurasi pengguna Claude Code. Jika `CLAUDE_CONFIG_DIR` tidak diatur atau kosong, perintah ini menggunakan `~/.claude.json` untuk MCP dan `~/.claude/settings.json` untuk hook. 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. +Perintah ini mengonfigurasi server MCP dan menggabungkan hook bawaan ke konfigurasi pengguna Claude Code. Jika `CLAUDE_CONFIG_DIR` tidak diatur atau kosong setelah whitespace di awal dan akhir dihapus, perintah ini menggunakan `~/.claude.json` untuk MCP dan `~/.claude/settings.json` untuk hook. 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. 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`. diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md index e265db3c43..9d9c0c5491 100644 --- a/READMEs/README.it-IT.md +++ b/READMEs/README.it-IT.md @@ -449,7 +449,7 @@ Soluzione alternativa: agentmemory connect claude-code --with-hooks ``` -Questo comando configura il server MCP e unisce gli hook inclusi alla configurazione utente di Claude Code. Se `CLAUDE_CONFIG_DIR` non è impostata o è vuota, usa `~/.claude.json` per MCP e `~/.claude/settings.json` per gli hook. 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. +Questo comando configura il server MCP e unisce gli hook inclusi alla configurazione utente di Claude Code. Se `CLAUDE_CONFIG_DIR` non è impostata o è vuota dopo aver rimosso gli spazi iniziali e finali, usa `~/.claude.json` per MCP e `~/.claude/settings.json` per gli hook. 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. 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`. diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md index 241cc12982..d043d61504 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -このコマンドは 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 自身の起動環境にこの値を設定する必要があります。 +このコマンドは 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 は未検出としてスキップされます。 Hook コマンドは、インストール済みパッケージに同梱された `plugin/` ディレクトリへの絶対パスを使います。agentmemory のアップグレード後にコマンドを再実行して、これらのパスを更新してください。設定ファイル内のユーザーのエントリは保持され、以前の agentmemory のエントリだけが置き換えられます。引き続き `/plugin install` の利用を推奨します。 リモートや保護されたデプロイでは、`AGENTMEMORY_URL` と `AGENTMEMORY_SECRET` を設定して Claude Code を起動してください。プラグインはこの両方の値を同梱の MCP サーバーに渡します。`AGENTMEMORY_URL` が空の場合、MCP shim は `http://localhost:3111` にフォールバックします。 diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md index acb5beee09..6e287df0a5 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -450,7 +450,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -이 명령은 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 자체의 실행 환경에 이 값이 전달되어야 합니다. +이 명령은 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를 감지하지 못한 것으로 처리하고 건너뜁니다. Hook 명령은 설치된 패키지에 포함된 `plugin/` 디렉터리의 절대 경로를 사용합니다. agentmemory를 업그레이드한 후 명령을 다시 실행하여 경로를 갱신하세요. 설정 파일에 있는 사용자 항목은 유지되며, 이전 agentmemory 항목만 교체됩니다. `/plugin install` 사용을 계속 권장합니다. 원격 또는 보호된 배포의 경우, `AGENTMEMORY_URL`과 `AGENTMEMORY_SECRET`을 설정한 채로 Claude Code를 실행하십시오. 플러그인은 두 값을 모두 번들된 MCP 서버로 전달합니다. `AGENTMEMORY_URL`이 비어 있으면 MCP shim은 `http://localhost:3111`을 사용합니다. diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md index af630bf113..952884aab1 100644 --- a/READMEs/README.nb-NO.md +++ b/READMEs/README.nb-NO.md @@ -447,7 +447,7 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Denne kommandoen konfigurerer MCP-serveren og fletter de medfølgende hookene inn i Claude Codes brukerkonfigurasjon. Hvis `CLAUDE_CONFIG_DIR` ikke er satt eller er tom, brukes `~/.claude.json` for MCP og `~/.claude/settings.json` for hooks. 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`. +Denne kommandoen konfigurerer MCP-serveren og fletter de medfølgende hookene inn i Claude Codes brukerkonfigurasjon. Hvis `CLAUDE_CONFIG_DIR` ikke er satt eller er tom etter at innledende og avsluttende blanktegn er fjernet, brukes `~/.claude.json` for MCP og `~/.claude/settings.json` for hooks. 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. 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`. diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md index 186cb49718..da2c04a9bd 100644 --- a/READMEs/README.nl-NL.md +++ b/READMEs/README.nl-NL.md @@ -447,7 +447,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 of leeg is, gebruikt het `~/.claude.json` voor MCP en `~/.claude/settings.json` voor hooks. 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. +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 of leeg is na het verwijderen van witruimte aan het begin en einde, gebruikt het `~/.claude.json` voor MCP en `~/.claude/settings.json` voor hooks. 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. 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`. diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md index f2de8c0761..5361f1188c 100644 --- a/READMEs/README.pl-PL.md +++ b/READMEs/README.pl-PL.md @@ -452,7 +452,7 @@ Rozwiązanie zastępcze: agentmemory connect claude-code --with-hooks ``` -Ta komenda konfiguruje serwer MCP i scala dołączone hooki z konfiguracją użytkownika Claude Code. Jeśli `CLAUDE_CONFIG_DIR` nie jest ustawiona lub jest pusta, używa `~/.claude.json` dla MCP i `~/.claude/settings.json` dla hooków. 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. +Ta komenda konfiguruje serwer MCP i scala dołączone hooki z konfiguracją użytkownika Claude Code. Jeśli `CLAUDE_CONFIG_DIR` nie jest ustawiona lub jest pusta po usunięciu białych znaków z początku i końca wartości, używa `~/.claude.json` dla MCP i `~/.claude/settings.json` dla hooków. 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. 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`. diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md index 953329cc69..9f168f3ceb 100644 --- a/READMEs/README.pt-BR.md +++ b/READMEs/README.pt-BR.md @@ -447,7 +447,7 @@ Contorno: agentmemory connect claude-code --with-hooks ``` -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 ou estiver vazia, ele usa `~/.claude.json` para MCP e `~/.claude/settings.json` para hooks. 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. +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 ou ficar vazia após remover os espaços em branco no início e no fim, ele usa `~/.claude.json` para MCP e `~/.claude/settings.json` para hooks. 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. 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`. diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md index 6c953a6641..c9e70a7e51 100644 --- a/READMEs/README.pt-PT.md +++ b/READMEs/README.pt-PT.md @@ -449,7 +449,7 @@ Solução alternativa: agentmemory connect claude-code --with-hooks ``` -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 ou estiver vazia, usa `~/.claude.json` para MCP e `~/.claude/settings.json` para os hooks. 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. +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 ou ficar vazia após remover os espaços em branco no início e no fim, usa `~/.claude.json` para MCP e `~/.claude/settings.json` para os hooks. 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. 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`. diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md index e1f659d0f4..895a391c45 100644 --- a/READMEs/README.ro-RO.md +++ b/READMEs/README.ro-RO.md @@ -454,7 +454,7 @@ Soluție alternativă: agentmemory connect claude-code --with-hooks ``` -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ă sau este goală, folosește `~/.claude.json` pentru MCP și `~/.claude/settings.json` pentru hook-uri. 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. +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ă sau este goală după eliminarea spațiilor albe de la începutul și sfârșitul valorii, folosește `~/.claude.json` pentru MCP și `~/.claude/settings.json` pentru hook-uri. 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ă. 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`. diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md index ff0928b65e..95b611c16d 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Эта команда настраивает 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. +Эта команда настраивает 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 как не обнаруженный. Команды хуков используют абсолютные пути к каталогу `plugin/` из установленного пакета. После обновления agentmemory запустите команду ещё раз, чтобы обновить эти пути. Пользовательские записи в файлах конфигурации сохраняются; заменяются только предыдущие записи agentmemory. Использование `/plugin install` остаётся рекомендуемым способом. Для удалённых или защищённых развёртываний запускайте Claude Code с заданными `AGENTMEMORY_URL` и `AGENTMEMORY_SECRET`. Плагин пробрасывает оба значения во встроенный MCP-сервер; если `AGENTMEMORY_URL` пуст, MCP-shim использует `http://localhost:3111`. diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md index e57a3d75ea..682685e1b0 100644 --- a/READMEs/README.sv-SE.md +++ b/READMEs/README.sv-SE.md @@ -449,7 +449,7 @@ Lösning: agentmemory connect claude-code --with-hooks ``` -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 eller är tom används `~/.claude.json` för MCP och `~/.claude/settings.json` för hooks. 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`. +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 eller är tom efter att inledande och avslutande blanktecken har tagits bort används `~/.claude.json` för MCP och `~/.claude/settings.json` för hooks. 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. 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`. diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md index bfac024c3c..f2fd27e496 100644 --- a/READMEs/README.th-TH.md +++ b/READMEs/README.th-TH.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ 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 ก็ตาม +คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ 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 เนื่องจากตรวจไม่พบ คำสั่ง 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` diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md index 9c4c975e02..b5c274f080 100644 --- a/READMEs/README.tl-PH.md +++ b/READMEs/README.tl-PH.md @@ -452,7 +452,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 o blangko ang `CLAUDE_CONFIG_DIR`, ginagamit nito ang `~/.claude.json` para sa MCP at `~/.claude/settings.json` para sa mga hook. 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. +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` o blangko ito matapos alisin ang whitespace sa simula at dulo, ginagamit nito ang `~/.claude.json` para sa MCP at `~/.claude/settings.json` para sa mga hook. 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. 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`. diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md index e091d7cdb4..33f681dc39 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -454,7 +454,7 @@ Geçici çözüm: agentmemory connect claude-code --with-hooks ``` -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 veya boşsa MCP için `~/.claude.json`, hook’lar için `~/.claude/settings.json` 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 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 veya başındaki ve sonundaki boşluklar kırpıldıktan sonra boşsa MCP için `~/.claude.json`, hook’lar için `~/.claude/settings.json` 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. 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. diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md index dcb0a1a789..60be79453a 100644 --- a/READMEs/README.uk-UA.md +++ b/READMEs/README.uk-UA.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Ця команда налаштовує 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. +Ця команда налаштовує 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 як невиявлений. Команди хуків використовують абсолютні шляхи до каталогу `plugin/`, включеного до встановленого пакета. Після оновлення agentmemory запустіть команду ще раз, щоб оновити ці шляхи. Записи користувача у файлах конфігурації зберігаються; замінюються лише попередні записи agentmemory. Використання `/plugin install` залишається рекомендованим підходом. Для віддалених або захищених розгортань запускайте Claude Code зі встановленими `AGENTMEMORY_URL` та `AGENTMEMORY_SECRET`. Плагін передає обидва значення своєму вбудованому MCP-серверу; якщо `AGENTMEMORY_URL` порожній, MCP-шим використовує `http://localhost:3111`. diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md index d1120cf05a..18351ec015 100644 --- a/READMEs/README.ur-PK.md +++ b/READMEs/README.ur-PK.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -یہ کمانڈ 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` سے پڑھتا ہو۔ +یہ کمانڈ 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 کو شناخت نہ ہونے کی وجہ سے چھوڑ دے گا۔ 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` استعمال کرتا ہے۔ diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md index 2a3d5d9090..5a04605f3c 100644 --- a/READMEs/README.vi-VN.md +++ b/READMEs/README.vi-VN.md @@ -452,7 +452,7 @@ Cách khắc phục tạm: agentmemory connect claude-code --with-hooks ``` -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 hoặc để trống, lệnh dùng `~/.claude.json` cho MCP và `~/.claude/settings.json` cho các hook. Để 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. +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 hoặc rỗng sau khi loại bỏ khoảng trắng ở đầu và cuối, lệnh dùng `~/.claude.json` cho MCP và `~/.claude/settings.json` cho các hook. Để 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. 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`. diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md index 05da4d398b..c4c742bcc9 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -此命令会配置 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 自身的启动环境中也必须设置该值。 +此命令会配置 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 为由跳过。 Hook 命令使用绝对路径,指向已安装包内的 `plugin/` 目录。升级 agentmemory 后,请重新运行此命令以刷新这些路径。配置文件中的用户条目会保留,仅替换之前的 agentmemory 条目。仍推荐使用 `/plugin install`。 对于远程或受保护的部署,启动 Claude Code 时设置好 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。插件会把这两个值传递给它捆绑的 MCP 服务器;当 `AGENTMEMORY_URL` 为空时,MCP shim 会使用 `http://localhost:3111`。 diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md index e1c7d3676a..ccbc885849 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -450,7 +450,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -此指令會設定 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 本身的啟動環境中也必須設定該值。 +此指令會設定 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 為由略過。 Hook 指令使用絕對路徑,指向已安裝套件內的 `plugin/` 目錄。升級 agentmemory 後,請重新執行此指令以更新這些路徑。設定檔中的使用者條目會保留,僅取代先前的 agentmemory 條目。仍建議使用 `/plugin install`。 若用於遠端或受保護的部署,啟動 Claude Code 時請設定 `AGENTMEMORY_URL` 和 `AGENTMEMORY_SECRET`。外掛會把這兩個值都傳給它捆綁的 MCP 伺服器;當 `AGENTMEMORY_URL` 為空時,MCP shim 會使用 `http://localhost:3111`。 diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index 2f30f6a79b..b855d75882 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -2,6 +2,7 @@ import { existsSync, mkdirSync, writeFileSync } from "node:fs"; import { homedir } from "node:os"; import { join } 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, @@ -19,9 +20,10 @@ import { } from "./codex-hooks.js"; function claudeConfigPaths() { - const configDir = process.env["CLAUDE_CONFIG_DIR"]; + const configDir = process.env["CLAUDE_CONFIG_DIR"]?.trim(); const dir = configDir || join(homedir(), ".claude"); return { + configDir, dir, mcp: configDir ? join(dir, ".claude.json") : join(homedir(), ".claude.json"), settings: join(dir, "settings.json"), @@ -55,7 +57,12 @@ export const adapter: ConnectAdapter = { }, async install(opts: ConnectOptions): Promise { - const { dir: CLAUDE_DIR, mcp: CLAUDE_JSON } = claudeConfigPaths(); + const { configDir, dir: CLAUDE_DIR, mcp: CLAUDE_JSON } = claudeConfigPaths(); + if (configDir && isEnvFileValue("CLAUDE_CONFIG_DIR")) { + p.log.warn( + `CLAUDE_CONFIG_DIR was loaded only from agentmemory's env file. Launch Claude Code with the same CLAUDE_CONFIG_DIR value (${configDir}) so it reads the same MCP and hook configuration.`, + ); + } const existing = readJsonSafe(CLAUDE_JSON); const next: ClaudeConfig = existing ? { ...existing } : {}; const servers: Record = { diff --git a/src/config.ts b/src/config.ts index 53823f19c7..03f3f4a0fb 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; @@ -95,11 +96,19 @@ function hasRealValue(v: string | undefined): v is string { 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 e32958d95d..68ee257516 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -151,6 +151,38 @@ describe("connect claude-code --with-hooks", () => { expect(existsSync(join(home, ".claude"))).toBe(false); }); + it("trims the profile override for detection, MCP and hooks while preserving spaces inside the path", async () => { + const configDir = join(home, "custom Claude config"); + mkdirSync(configDir); + vi.stubEnv("CLAUDE_CONFIG_DIR", ` \t${configDir} \n`); + + 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(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("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"); @@ -169,20 +201,22 @@ describe("connect claude-code --with-hooks", () => { describe.skipIf(process.platform === "win32")("CLI env-file hydration", () => { it.each([ - { source: "default .env", customEnvFile: false, shellOverride: false }, - { source: "AGENTMEMORY_ENV_FILE", customEnvFile: true, shellOverride: false }, - { source: "shell overriding the env file", customEnvFile: true, shellOverride: true }, - ])("installs MCP and hooks using $source", ({ customEnvFile, shellOverride }) => { + { source: "default .env", customEnvFile: false, shellOverride: false, matchingShell: false, paddedFile: false }, + { source: "AGENTMEMORY_ENV_FILE", customEnvFile: true, shellOverride: false, matchingShell: false, paddedFile: false }, + { source: "shell overriding the env file", customEnvFile: true, shellOverride: true, matchingShell: false, paddedFile: false }, + { source: "matching shell and env-file values", customEnvFile: true, shellOverride: true, matchingShell: true, paddedFile: false }, + { source: "a padded env-file value", customEnvFile: true, shellOverride: false, matchingShell: false, paddedFile: true }, + ])("installs MCP and hooks using $source", ({ customEnvFile, shellOverride, matchingShell, paddedFile }) => { const fileProfile = join(home, "env-file Claude config"); const shellProfile = join(home, "shell Claude config"); - const selected = shellOverride ? shellProfile : fileProfile; + const selected = shellOverride && !matchingShell ? shellProfile : fileProfile; mkdirSync(fileProfile); mkdirSync(shellProfile); mkdirSync(join(home, ".agentmemory")); const envFile = customEnvFile ? join(home, "custom.env") : join(home, ".agentmemory", ".env"); - writeFileSync(envFile, `CLAUDE_CONFIG_DIR="${fileProfile}"\n`); + writeFileSync(envFile, `CLAUDE_CONFIG_DIR="${paddedFile ? ` ${fileProfile} ` : fileProfile}"\n`); const result = spawnSync(process.execPath, [ resolve(__dirname, "..", "dist", "cli.mjs"), @@ -192,7 +226,7 @@ describe("connect claude-code --with-hooks", () => { env: { ...process.env, AGENTMEMORY_ENV_FILE: customEnvFile ? envFile : undefined, - CLAUDE_CONFIG_DIR: shellOverride ? shellProfile : undefined, + CLAUDE_CONFIG_DIR: shellOverride ? selected : undefined, CI: "1", NO_COLOR: "1", }, @@ -201,13 +235,55 @@ describe("connect claude-code --with-hooks", () => { }); 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 (${selected})`); + 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")); + } expect(result.stdout).toContain(`wired into ${join(selected, ".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(); - expect(existsSync(join(shellOverride ? fileProfile : shellProfile, ".claude.json"))).toBe(false); + expect(existsSync(join(selected === fileProfile ? shellProfile : fileProfile, ".claude.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 without an override warning for a 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); + expect(result.stdout + result.stderr).not.toContain("CLAUDE_CONFIG_DIR was loaded only"); + 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("merges MCP and hooks in CLAUDE_CONFIG_DIR and leaves default files untouched", async () => { @@ -274,10 +350,12 @@ describe("connect claude-code --with-hooks", () => { expect(existsSync(join(home, ".claude.json"))).toBe(false); }); - it.each([undefined, ""])("keeps legacy paths when CLAUDE_CONFIG_DIR is %s", async (override) => { + 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") }); From 2818a8cce7350c364dc1b9a5d2a56af8677c8463 Mon Sep 17 00:00:00 2001 From: mothieras Date: Sun, 8 Nov 2026 17:55:50 +0800 Subject: [PATCH 6/8] fix(connect): preserve Claude profile path semantics Preserve nonblank CLAUDE_CONFIG_DIR values verbatim so the connector and Claude Code use the same profile. Keep the whitespace-only fallback and warn when the shell override must be unset for Claude. Warn for relative paths, skip non-directory profile paths, and isolate CLAUDE_CONFIG_DIR in adapter tests. Update the README translations. Validation: build, skills generation/check, docs sync/check, and eval typecheck passed; 4,515 tests passed and 6 skipped with Node 26.12.1, npm 11.20.0, and Python 3.14.5. The two affected suites passed all 55 tests with an inherited profile override and left that profile unchanged. Native Claude Code 2.1.319 found the generated MCP entry across eight configuration scenarios. Signed-off-by: mothieras --- README.md | 2 +- READMEs/README.ar-SA.md | 2 +- READMEs/README.bn-BD.md | 2 +- READMEs/README.cs-CZ.md | 2 +- READMEs/README.da-DK.md | 2 +- READMEs/README.de-DE.md | 2 +- READMEs/README.el-GR.md | 2 +- READMEs/README.es-ES.md | 2 +- READMEs/README.fi-FI.md | 2 +- READMEs/README.fr-FR.md | 2 +- READMEs/README.he-IL.md | 2 +- READMEs/README.hi-IN.md | 2 +- READMEs/README.hu-HU.md | 2 +- READMEs/README.id-ID.md | 2 +- READMEs/README.it-IT.md | 2 +- READMEs/README.ja-JP.md | 2 +- READMEs/README.ko-KR.md | 2 +- READMEs/README.nb-NO.md | 2 +- READMEs/README.nl-NL.md | 2 +- READMEs/README.pl-PL.md | 2 +- READMEs/README.pt-BR.md | 2 +- READMEs/README.pt-PT.md | 2 +- READMEs/README.ro-RO.md | 2 +- READMEs/README.ru-RU.md | 2 +- READMEs/README.sv-SE.md | 2 +- READMEs/README.th-TH.md | 2 +- READMEs/README.tl-PH.md | 2 +- READMEs/README.tr-TR.md | 2 +- READMEs/README.uk-UA.md | 2 +- READMEs/README.ur-PK.md | 2 +- READMEs/README.vi-VN.md | 2 +- READMEs/README.zh-CN.md | 2 +- READMEs/README.zh-TW.md | 2 +- src/cli/connect/claude-code.ts | 33 +++++-- test/claude-code-with-hooks.test.ts | 147 ++++++++++++++++++++++++---- test/cli-connect.test.ts | 2 + 36 files changed, 190 insertions(+), 58 deletions(-) diff --git a/README.md b/README.md index a8c81d5365..d90fc7c9e2 100644 --- a/README.md +++ b/README.md @@ -482,7 +482,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -This command configures the MCP server and merges the bundled hooks into Claude Code’s user configuration. When `CLAUDE_CONFIG_DIR` is unset or empty after trimming surrounding whitespace, it uses `~/.claude.json` for MCP and `~/.claude/settings.json` for hooks. 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. +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. diff --git a/READMEs/README.ar-SA.md b/READMEs/README.ar-SA.md index 72d9125503..330732bfd3 100644 --- a/READMEs/README.ar-SA.md +++ b/READMEs/README.ar-SA.md @@ -456,7 +456,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -يضبط هذا الأمر خادم 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 باعتباره غير مكتشف. +يضبط هذا الأمر خادم 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`. diff --git a/READMEs/README.bn-BD.md b/READMEs/README.bn-BD.md index a49f75ba7a..d91216291c 100644 --- a/READMEs/README.bn-BD.md +++ b/READMEs/README.bn-BD.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -এই কমান্ড 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-কে শনাক্ত করতে না পেরে এড়িয়ে যাবে। +এই কমান্ড 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` ব্যবহার করে। diff --git a/READMEs/README.cs-CZ.md b/READMEs/README.cs-CZ.md index a6ba7fa05f..2ea0ac3187 100644 --- a/READMEs/README.cs-CZ.md +++ b/READMEs/README.cs-CZ.md @@ -454,7 +454,7 @@ Pokud zapojíte server MCP agentmemory přímo přes `~/.claude.json` (výchozí agentmemory connect claude-code --with-hooks ``` -Tento příkaz nastaví server MCP a sloučí přibalené hooky do uživatelské konfigurace Claude Code. Pokud `CLAUDE_CONFIG_DIR` není nastavena nebo je po odstranění okolních bílých znaků prázdná, použije pro MCP soubor `~/.claude.json` a pro hooky `~/.claude/settings.json`. 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. +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`. diff --git a/READMEs/README.da-DK.md b/READMEs/README.da-DK.md index e75a04636f..d012cfc154 100644 --- a/READMEs/README.da-DK.md +++ b/READMEs/README.da-DK.md @@ -449,7 +449,7 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Denne kommando konfigurerer MCP-serveren og fletter de medfølgende hooks ind i Claude Codes brugerkonfiguration. Hvis `CLAUDE_CONFIG_DIR` ikke er sat eller er tom efter fjernelse af indledende og afsluttende blanktegn, bruges `~/.claude.json` til MCP og `~/.claude/settings.json` til hooks. 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. +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`. diff --git a/READMEs/README.de-DE.md b/READMEs/README.de-DE.md index 3414ecee42..40a15ea477 100644 --- a/READMEs/README.de-DE.md +++ b/READMEs/README.de-DE.md @@ -447,7 +447,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 nach dem Entfernen von Leerraum am Anfang und Ende leer ist, verwendet er `~/.claude.json` für MCP und `~/.claude/settings.json` für Hooks. 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. +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`. diff --git a/READMEs/README.el-GR.md b/READMEs/README.el-GR.md index b3213c773c..c5cc1c5b38 100644 --- a/READMEs/README.el-GR.md +++ b/READMEs/README.el-GR.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Αυτή η εντολή ρυθμίζει τον διακομιστή 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 επειδή δεν το εντοπίζει. +Αυτή η εντολή ρυθμίζει τον διακομιστή 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`. diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md index c1213529b7..7c8ce7b2f7 100644 --- a/READMEs/README.es-ES.md +++ b/READMEs/README.es-ES.md @@ -449,7 +449,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 o queda vacía tras quitar los espacios en blanco de los extremos, usa `~/.claude.json` para MCP y `~/.claude/settings.json` para los hooks. 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. +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`. diff --git a/READMEs/README.fi-FI.md b/READMEs/README.fi-FI.md index 92b6d2a692..fe4989dd4e 100644 --- a/READMEs/README.fi-FI.md +++ b/READMEs/README.fi-FI.md @@ -454,7 +454,7 @@ Kiertotapa: agentmemory connect claude-code --with-hooks ``` -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 tai tyhjä ympäröivien tyhjien merkkien poistamisen jälkeen, se käyttää MCP:lle tiedostoa `~/.claude.json` ja hookeille tiedostoa `~/.claude/settings.json`. 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. +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`. diff --git a/READMEs/README.fr-FR.md b/READMEs/README.fr-FR.md index 80a906e9e1..cb96b7f06a 100644 --- a/READMEs/README.fr-FR.md +++ b/READMEs/README.fr-FR.md @@ -449,7 +449,7 @@ Solution de contournement : agentmemory connect claude-code --with-hooks ``` -Cette commande configure le serveur MCP et fusionne les hooks inclus dans la configuration utilisateur de Claude Code. Si `CLAUDE_CONFIG_DIR` est absente ou vide après suppression des espaces en début et en fin de valeur, elle utilise `~/.claude.json` pour MCP et `~/.claude/settings.json` pour les hooks. 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. +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`. diff --git a/READMEs/README.he-IL.md b/READMEs/README.he-IL.md index 67adeb4b03..58e815590b 100644 --- a/READMEs/README.he-IL.md +++ b/READMEs/README.he-IL.md @@ -456,7 +456,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -הפקודה מגדירה את שרת ה-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 כי הוא לא זוהה. +הפקודה מגדירה את שרת ה-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`. diff --git a/READMEs/README.hi-IN.md b/READMEs/README.hi-IN.md index 9cfc9cdf6d..d78e1a9bb7 100644 --- a/READMEs/README.hi-IN.md +++ b/READMEs/README.hi-IN.md @@ -452,7 +452,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -यह कमांड 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 को नहीं पहचान पाता और उसे छोड़ देता है। +यह कमांड 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` का उपयोग करता है। diff --git a/READMEs/README.hu-HU.md b/READMEs/README.hu-HU.md index 39f81de16e..4850ede8b7 100644 --- a/READMEs/README.hu-HU.md +++ b/READMEs/README.hu-HU.md @@ -452,7 +452,7 @@ Megoldás: agentmemory connect claude-code --with-hooks ``` -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, vagy az érték elején és végén lévő üres karakterek eltávolítása után üres, az MCP-hez a `~/.claude.json`, a hookokhoz pedig a `~/.claude/settings.json` fájlt használja. 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. +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. diff --git a/READMEs/README.id-ID.md b/READMEs/README.id-ID.md index eabfb8bb30..0371d3bbfb 100644 --- a/READMEs/README.id-ID.md +++ b/READMEs/README.id-ID.md @@ -452,7 +452,7 @@ Solusinya: agentmemory connect claude-code --with-hooks ``` -Perintah ini mengonfigurasi server MCP dan menggabungkan hook bawaan ke konfigurasi pengguna Claude Code. Jika `CLAUDE_CONFIG_DIR` tidak diatur atau kosong setelah whitespace di awal dan akhir dihapus, perintah ini menggunakan `~/.claude.json` untuk MCP dan `~/.claude/settings.json` untuk hook. 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. +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`. diff --git a/READMEs/README.it-IT.md b/READMEs/README.it-IT.md index 9d9c0c5491..e0ef5fa0b5 100644 --- a/READMEs/README.it-IT.md +++ b/READMEs/README.it-IT.md @@ -449,7 +449,7 @@ Soluzione alternativa: agentmemory connect claude-code --with-hooks ``` -Questo comando configura il server MCP e unisce gli hook inclusi alla configurazione utente di Claude Code. Se `CLAUDE_CONFIG_DIR` non è impostata o è vuota dopo aver rimosso gli spazi iniziali e finali, usa `~/.claude.json` per MCP e `~/.claude/settings.json` per gli hook. 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. +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`. diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md index d043d61504..9a7112384d 100644 --- a/READMEs/README.ja-JP.md +++ b/READMEs/README.ja-JP.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -このコマンドは 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 は未検出としてスキップされます。 +このコマンドは 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` にフォールバックします。 diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md index 6e287df0a5..fadaf0e946 100644 --- a/READMEs/README.ko-KR.md +++ b/READMEs/README.ko-KR.md @@ -450,7 +450,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -이 명령은 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를 감지하지 못한 것으로 처리하고 건너뜁니다. +이 명령은 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`을 사용합니다. diff --git a/READMEs/README.nb-NO.md b/READMEs/README.nb-NO.md index 952884aab1..ee1d5e287a 100644 --- a/READMEs/README.nb-NO.md +++ b/READMEs/README.nb-NO.md @@ -447,7 +447,7 @@ Løsning: agentmemory connect claude-code --with-hooks ``` -Denne kommandoen konfigurerer MCP-serveren og fletter de medfølgende hookene inn i Claude Codes brukerkonfigurasjon. Hvis `CLAUDE_CONFIG_DIR` ikke er satt eller er tom etter at innledende og avsluttende blanktegn er fjernet, brukes `~/.claude.json` for MCP og `~/.claude/settings.json` for hooks. 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. +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`. diff --git a/READMEs/README.nl-NL.md b/READMEs/README.nl-NL.md index da2c04a9bd..4e38a0c656 100644 --- a/READMEs/README.nl-NL.md +++ b/READMEs/README.nl-NL.md @@ -447,7 +447,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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 of leeg is na het verwijderen van witruimte aan het begin en einde, gebruikt het `~/.claude.json` voor MCP en `~/.claude/settings.json` voor hooks. 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. +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`. diff --git a/READMEs/README.pl-PL.md b/READMEs/README.pl-PL.md index 5361f1188c..7a20eacec5 100644 --- a/READMEs/README.pl-PL.md +++ b/READMEs/README.pl-PL.md @@ -452,7 +452,7 @@ Rozwiązanie zastępcze: agentmemory connect claude-code --with-hooks ``` -Ta komenda konfiguruje serwer MCP i scala dołączone hooki z konfiguracją użytkownika Claude Code. Jeśli `CLAUDE_CONFIG_DIR` nie jest ustawiona lub jest pusta po usunięciu białych znaków z początku i końca wartości, używa `~/.claude.json` dla MCP i `~/.claude/settings.json` dla hooków. 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. +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`. diff --git a/READMEs/README.pt-BR.md b/READMEs/README.pt-BR.md index 9f168f3ceb..6ca53b9f7d 100644 --- a/READMEs/README.pt-BR.md +++ b/READMEs/README.pt-BR.md @@ -447,7 +447,7 @@ Contorno: agentmemory connect claude-code --with-hooks ``` -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 ou ficar vazia após remover os espaços em branco no início e no fim, ele usa `~/.claude.json` para MCP e `~/.claude/settings.json` para hooks. 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. +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`. diff --git a/READMEs/README.pt-PT.md b/READMEs/README.pt-PT.md index c9e70a7e51..8ed92f031f 100644 --- a/READMEs/README.pt-PT.md +++ b/READMEs/README.pt-PT.md @@ -449,7 +449,7 @@ Solução alternativa: agentmemory connect claude-code --with-hooks ``` -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 ou ficar vazia após remover os espaços em branco no início e no fim, usa `~/.claude.json` para MCP e `~/.claude/settings.json` para os hooks. 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. +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`. diff --git a/READMEs/README.ro-RO.md b/READMEs/README.ro-RO.md index 895a391c45..3b925057f2 100644 --- a/READMEs/README.ro-RO.md +++ b/READMEs/README.ro-RO.md @@ -454,7 +454,7 @@ Soluție alternativă: agentmemory connect claude-code --with-hooks ``` -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ă sau este goală după eliminarea spațiilor albe de la începutul și sfârșitul valorii, folosește `~/.claude.json` pentru MCP și `~/.claude/settings.json` pentru hook-uri. 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ă. +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`. diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md index 95b611c16d..93caefb4b7 100644 --- a/READMEs/README.ru-RU.md +++ b/READMEs/README.ru-RU.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Эта команда настраивает 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 как не обнаруженный. +Эта команда настраивает 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`. diff --git a/READMEs/README.sv-SE.md b/READMEs/README.sv-SE.md index 682685e1b0..a422e11768 100644 --- a/READMEs/README.sv-SE.md +++ b/READMEs/README.sv-SE.md @@ -449,7 +449,7 @@ Lösning: agentmemory connect claude-code --with-hooks ``` -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 eller är tom efter att inledande och avslutande blanktecken har tagits bort används `~/.claude.json` för MCP och `~/.claude/settings.json` för hooks. 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. +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`. diff --git a/READMEs/README.th-TH.md b/READMEs/README.th-TH.md index f2fd27e496..6dd18c1fd5 100644 --- a/READMEs/README.th-TH.md +++ b/READMEs/README.th-TH.md @@ -446,7 +446,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ 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 เนื่องจากตรวจไม่พบ +คำสั่งนี้กำหนดค่าเซิร์ฟเวอร์ 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` diff --git a/READMEs/README.tl-PH.md b/READMEs/README.tl-PH.md index b5c274f080..358ed9a55d 100644 --- a/READMEs/README.tl-PH.md +++ b/READMEs/README.tl-PH.md @@ -452,7 +452,7 @@ Workaround: agentmemory connect claude-code --with-hooks ``` -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` o blangko ito matapos alisin ang whitespace sa simula at dulo, ginagamit nito ang `~/.claude.json` para sa MCP at `~/.claude/settings.json` para sa mga hook. 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. +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`. diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md index 33f681dc39..a18f872ab4 100644 --- a/READMEs/README.tr-TR.md +++ b/READMEs/README.tr-TR.md @@ -454,7 +454,7 @@ Geçici çözüm: agentmemory connect claude-code --with-hooks ``` -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 veya başındaki ve sonundaki boşluklar kırpıldıktan sonra boşsa MCP için `~/.claude.json`, hook’lar için `~/.claude/settings.json` 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. +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. diff --git a/READMEs/README.uk-UA.md b/READMEs/README.uk-UA.md index 60be79453a..ce04837da2 100644 --- a/READMEs/README.uk-UA.md +++ b/READMEs/README.uk-UA.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -Ця команда налаштовує 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 як невиявлений. +Ця команда налаштовує 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`. diff --git a/READMEs/README.ur-PK.md b/READMEs/README.ur-PK.md index 18351ec015..73e6dc6dfa 100644 --- a/READMEs/README.ur-PK.md +++ b/READMEs/README.ur-PK.md @@ -454,7 +454,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -یہ کمانڈ 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 کو شناخت نہ ہونے کی وجہ سے چھوڑ دے گا۔ +یہ کمانڈ 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` استعمال کرتا ہے۔ diff --git a/READMEs/README.vi-VN.md b/READMEs/README.vi-VN.md index 5a04605f3c..f63ae7c5e3 100644 --- a/READMEs/README.vi-VN.md +++ b/READMEs/README.vi-VN.md @@ -452,7 +452,7 @@ Cách khắc phục tạm: agentmemory connect claude-code --with-hooks ``` -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 hoặc rỗng sau khi loại bỏ khoảng trắng ở đầu và cuối, lệnh dùng `~/.claude.json` cho MCP và `~/.claude/settings.json` cho các hook. Để 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. +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`. diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md index c4c742bcc9..a14d9b6700 100644 --- a/READMEs/README.zh-CN.md +++ b/READMEs/README.zh-CN.md @@ -452,7 +452,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -此命令会配置 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 为由跳过。 +此命令会配置 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`。 diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md index ccbc885849..d1c9301798 100644 --- a/READMEs/README.zh-TW.md +++ b/READMEs/README.zh-TW.md @@ -450,7 +450,7 @@ Install agentmemory: run `npx -y @agentmemory/agentmemory@latest` in a separate agentmemory connect claude-code --with-hooks ``` -此指令會設定 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 為由略過。 +此指令會設定 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`。 diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index b855d75882..1bdebac401 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -1,6 +1,6 @@ -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, resolve } from "node:path"; import * as p from "@clack/prompts"; import { isEnvFileValue } from "../../config.js"; import type { ConnectAdapter, ConnectOptions, ConnectResult } from "./types.js"; @@ -20,9 +20,11 @@ import { } from "./codex-hooks.js"; function claudeConfigPaths() { - const configDir = process.env["CLAUDE_CONFIG_DIR"]?.trim(); + const rawConfigDir = process.env["CLAUDE_CONFIG_DIR"]; + const configDir = rawConfigDir?.trim() ? rawConfigDir : undefined; const dir = configDir || join(homedir(), ".claude"); return { + rawConfigDir, configDir, dir, mcp: configDir ? join(dir, ".claude.json") : join(homedir(), ".claude.json"), @@ -53,14 +55,31 @@ 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(claudeConfigPaths().dir); + const { configDir, dir } = claudeConfigPaths(); + const detected = statSync(dir, { throwIfNoEntry: false })?.isDirectory() ?? 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 { configDir, dir: CLAUDE_DIR, mcp: CLAUDE_JSON } = claudeConfigPaths(); - if (configDir && isEnvFileValue("CLAUDE_CONFIG_DIR")) { + 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 && !isAbsolute(configDir)) { p.log.warn( - `CLAUDE_CONFIG_DIR was loaded only from agentmemory's env file. Launch Claude Code with the same CLAUDE_CONFIG_DIR value (${configDir}) so it reads the same MCP and hook configuration.`, + `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); diff --git a/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index 68ee257516..4fde648d87 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,6 +1,6 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; import { spawnSync } from "node:child_process"; -import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs"; +import { existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; import { @@ -151,10 +151,14 @@ describe("connect claude-code --with-hooks", () => { expect(existsSync(join(home, ".claude"))).toBe(false); }); - it("trims the profile override for detection, MCP and hooks while preserving spaces inside the path", async () => { - const configDir = join(home, "custom Claude config"); + 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); - vi.stubEnv("CLAUDE_CONFIG_DIR", ` \t${configDir} \n`); + 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); @@ -163,6 +167,8 @@ describe("connect claude-code --with-hooks", () => { 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); }); @@ -183,6 +189,22 @@ describe("connect claude-code --with-hooks", () => { 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"); @@ -201,22 +223,29 @@ describe("connect claude-code --with-hooks", () => { describe.skipIf(process.platform === "win32")("CLI env-file hydration", () => { it.each([ - { source: "default .env", customEnvFile: false, shellOverride: false, matchingShell: false, paddedFile: false }, - { source: "AGENTMEMORY_ENV_FILE", customEnvFile: true, shellOverride: false, matchingShell: false, paddedFile: false }, - { source: "shell overriding the env file", customEnvFile: true, shellOverride: true, matchingShell: false, paddedFile: false }, - { source: "matching shell and env-file values", customEnvFile: true, shellOverride: true, matchingShell: true, paddedFile: false }, - { source: "a padded env-file value", customEnvFile: true, shellOverride: false, matchingShell: false, paddedFile: true }, - ])("installs MCP and hooks using $source", ({ customEnvFile, shellOverride, matchingShell, paddedFile }) => { + { 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 selected = shellOverride && !matchingShell ? shellProfile : fileProfile; + 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="${paddedFile ? ` ${fileProfile} ` : fileProfile}"\n`); + writeFileSync(envFile, `CLAUDE_CONFIG_DIR="${fileValue}"\n`); const result = spawnSync(process.execPath, [ resolve(__dirname, "..", "dist", "cli.mjs"), @@ -226,7 +255,7 @@ describe("connect claude-code --with-hooks", () => { env: { ...process.env, AGENTMEMORY_ENV_FILE: customEnvFile ? envFile : undefined, - CLAUDE_CONFIG_DIR: shellOverride ? selected : undefined, + CLAUDE_CONFIG_DIR: shellOverride ? selectedValue : undefined, CI: "1", NO_COLOR: "1", }, @@ -240,19 +269,27 @@ describe("connect claude-code --with-hooks", () => { 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 (${selected})`); + 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")); } - expect(result.stdout).toContain(`wired into ${join(selected, ".claude.json")}`); + if (padding === "none" || padding === "trailing") { + expect(output).not.toContain("CLAUDE_CONFIG_DIR is relative"); + } + 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(); - expect(existsSync(join(selected === fileProfile ? shellProfile : fileProfile, ".claude.json"))).toBe(false); + 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 without an override warning for a whitespace-only value from the %s", (source) => { + 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")); @@ -277,13 +314,87 @@ describe("connect claude-code --with-hooks", () => { }); expect(result.status, result.stderr).toBe(0); - expect(result.stdout + result.stderr).not.toContain("CLAUDE_CONFIG_DIR was loaded only"); + const output = result.stdout + result.stderr; + expect(output).not.toContain("CLAUDE_CONFIG_DIR was loaded only"); + 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("merges MCP and hooks in CLAUDE_CONFIG_DIR and leaves default files untouched", async () => { 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(); }); From 2841b4e6729d79356f72f188f01785b8f70cc757 Mon Sep 17 00:00:00 2001 From: mothieras Date: Sun, 8 Nov 2026 18:10:25 +0800 Subject: [PATCH 7/8] fix(connect): warn on padded paths and skip inaccessible profiles Warn before installing into a Claude profile whose path contains leading or trailing whitespace, while preserving the literal path. Keep the separate whitespace-only fallback warning. Catch EACCES and EPERM during profile detection so inaccessible parents produce an actionable warning and skip the adapter. Other filesystem errors remain visible. Validate the built CLI against a real inaccessible parent and existing padded-profile cases. Four regression cases fail before the fix. Build, skills generation/check, docs sync/check, and eval typecheck pass; 4,516 tests pass and 6 skip with Node 26.12.1, npm 11.20.0, and Python 3.14.5. Signed-off-by: mothieras --- src/cli/connect/claude-code.ts | 17 ++++++++- test/claude-code-with-hooks.test.ts | 57 ++++++++++++++++++++++++++++- 2 files changed, 72 insertions(+), 2 deletions(-) diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index 1bdebac401..07aa04262d 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -56,7 +56,17 @@ export const adapter: ConnectAdapter = { detect(): boolean { const { configDir, dir } = claudeConfigPaths(); - const detected = statSync(dir, { throwIfNoEntry: false })?.isDirectory() ?? false; + 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.`, @@ -77,6 +87,11 @@ export const adapter: ConnectAdapter = { "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.`, diff --git a/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index 4fde648d87..998cdbf63b 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,6 +1,6 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; import { spawnSync } from "node:child_process"; -import { existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs"; +import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs"; import { tmpdir } from "node:os"; import { join, resolve } from "node:path"; import { @@ -276,6 +276,14 @@ describe("connect claude-code --with-hooks", () => { 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(); @@ -316,6 +324,7 @@ describe("connect claude-code --with-hooks", () => { 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"); @@ -395,6 +404,52 @@ describe("connect claude-code --with-hooks", () => { expect(existsSync(join(home, ".claude.json"))).toBe(false); expect(existsSync(join(home, ".claude"))).toBe(false); }, 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 () => { From 38201bf26f5d1780614fa49c2a7c0b33671a3ccf Mon Sep 17 00:00:00 2001 From: mothieras Date: Sun, 8 Nov 2026 18:25:02 +0800 Subject: [PATCH 8/8] fix(connect): align Claude profile detection with config paths Normalize custom profile paths before detection and directory creation, matching MCP and hook file paths and native Claude Code behavior for a symlink followed by .. . Preserve the original value for warnings. Cover both mismatched directory-existence cases with real symlinks and the built CLI. Both regressions fail before the fix. Native Claude Code 2.1.319 also reads the resulting MCP entry in isolated profiles. Build, skills generation/check, docs sync/check, and eval typecheck pass; 4,518 tests pass and 6 skip. Signed-off-by: mothieras --- src/cli/connect/claude-code.ts | 4 +- test/claude-code-with-hooks.test.ts | 62 ++++++++++++++++++++++++++++- 2 files changed, 63 insertions(+), 3 deletions(-) diff --git a/src/cli/connect/claude-code.ts b/src/cli/connect/claude-code.ts index 07aa04262d..271468bf2e 100644 --- a/src/cli/connect/claude-code.ts +++ b/src/cli/connect/claude-code.ts @@ -1,6 +1,6 @@ import { existsSync, mkdirSync, statSync, writeFileSync } from "node:fs"; import { homedir } from "node:os"; -import { isAbsolute, join, resolve } 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"; @@ -22,7 +22,7 @@ import { function claudeConfigPaths() { const rawConfigDir = process.env["CLAUDE_CONFIG_DIR"]; const configDir = rawConfigDir?.trim() ? rawConfigDir : undefined; - const dir = configDir || join(homedir(), ".claude"); + const dir = configDir ? normalize(configDir) : join(homedir(), ".claude"); return { rawConfigDir, configDir, diff --git a/test/claude-code-with-hooks.test.ts b/test/claude-code-with-hooks.test.ts index 998cdbf63b..86fbf4b4f0 100644 --- a/test/claude-code-with-hooks.test.ts +++ b/test/claude-code-with-hooks.test.ts @@ -1,6 +1,6 @@ import { afterEach, beforeEach, describe, it, expect, vi } from "vitest"; import { spawnSync } from "node:child_process"; -import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs"; +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 { @@ -405,6 +405,66 @@ describe("connect claude-code --with-hooks", () => { 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");