From accd986760d8e0fe42d00486b30ff3a260e9a3e3 Mon Sep 17 00:00:00 2001 From: Alex Newman Date: Mon, 6 Jul 2026 12:20:58 -0700 Subject: [PATCH] docs: refresh release docs and translations --- README.md | 25 +- docs/i18n/.translation-cache.json | 242 +++++----- docs/i18n/README.ar.md | 379 ++++++++++----- docs/i18n/README.bn.md | 330 +++++++++---- docs/i18n/README.cs.md | 297 ++++++++---- docs/i18n/README.da.md | 301 ++++++++---- docs/i18n/README.de.md | 305 ++++++++---- docs/i18n/README.el.md | 299 ++++++++---- docs/i18n/README.es.md | 296 ++++++++---- docs/i18n/README.fi.md | 308 +++++++++---- docs/i18n/README.fr.md | 299 ++++++++---- docs/i18n/README.he.md | 298 ++++++++---- docs/i18n/README.hi.md | 294 ++++++++---- docs/i18n/README.hu.md | 305 ++++++++---- docs/i18n/README.id.md | 293 ++++++++---- docs/i18n/README.it.md | 299 ++++++++---- docs/i18n/README.ja.md | 291 ++++++++---- docs/i18n/README.ko.md | 293 ++++++++---- docs/i18n/README.nl.md | 300 ++++++++---- docs/i18n/README.no.md | 301 ++++++++---- docs/i18n/README.pl.md | 306 +++++++++---- docs/i18n/README.pt-br.md | 315 +++++++++---- docs/i18n/README.pt.md | 433 ++++++++++++++++++ docs/i18n/README.ro.md | 331 +++++++++---- docs/i18n/README.ru.md | 295 ++++++++---- docs/i18n/README.sv.md | 309 +++++++++---- docs/i18n/README.th.md | 296 ++++++++---- docs/i18n/README.tl.md | 209 ++++++--- docs/i18n/README.tr.md | 326 +++++++++---- docs/i18n/README.uk.md | 295 ++++++++---- docs/i18n/README.ur.md | 306 +++++++++---- docs/i18n/README.vi.md | 295 ++++++++---- docs/i18n/README.zh-tw.md | 253 +++++++--- docs/i18n/README.zh.md | 292 ++++++++---- docs/i18n/pt.md | 301 ------------ docs/public/antigravity-cli/setup.mdx | 4 +- docs/public/architecture/hooks.mdx | 27 +- docs/public/architecture/overview.mdx | 2 +- .../architecture/search-architecture.mdx | 26 +- docs/public/beta-features.mdx | 151 ------ docs/public/branches.mdx | 88 ++++ docs/public/configuration.mdx | 24 +- docs/public/cursor/gemini-setup.mdx | 2 +- docs/public/cursor/index.mdx | 8 +- docs/public/cursor/openrouter-setup.mdx | 2 +- docs/public/development.mdx | 110 ++--- docs/public/docs.json | 5 +- docs/public/endless-mode.mdx | 111 ----- docs/public/platform-integration.mdx | 2 +- docs/public/troubleshooting.mdx | 24 +- docs/public/usage/claude-desktop.mdx | 9 +- docs/public/usage/export-import.mdx | 3 +- docs/public/usage/gemini-provider.mdx | 2 +- docs/public/usage/knowledge-agents.mdx | 9 +- docs/public/usage/manual-recovery.mdx | 18 +- docs/public/usage/openrouter-provider.mdx | 2 +- docs/public/usage/search-tools.mdx | 7 +- package.json | 4 +- scripts/translate-readme/README.md | 9 +- scripts/translate-readme/cli.ts | 3 +- scripts/translate-readme/index.ts | 6 +- src/services/worker/README.md | 179 ++------ 62 files changed, 7514 insertions(+), 3640 deletions(-) create mode 100644 docs/i18n/README.pt.md delete mode 100644 docs/i18n/pt.md delete mode 100644 docs/public/beta-features.mdx create mode 100644 docs/public/branches.mdx delete mode 100644 docs/public/endless-mode.mdx diff --git a/README.md b/README.md index cd764a7dc..95856e762 100644 --- a/README.md +++ b/README.md @@ -175,13 +175,12 @@ The installer handles dependencies, plugin setup, AI provider configuration, wor - 🧠 **Persistent Memory** - Context survives across sessions - 📊 **Progressive Disclosure** - Layered memory retrieval with token cost visibility - 🔍 **Skill-Based Search** - Query your project history with mem-search skill -- 🖥️ **Web Viewer UI** - Real-time memory stream at http://localhost:37777 +- 🖥️ **Web Viewer UI** - Real-time memory stream at the worker URL printed on startup - 💻 **Claude Desktop Skill** - Search memory from Claude Desktop conversations - 🔒 **Privacy Control** - Use `` tags to exclude sensitive content from storage - ⚙️ **Context Configuration** - Fine-grained control over what context gets injected - 🤖 **Automatic Operation** - No manual intervention required -- 🔗 **Citations** - Reference past observations with IDs (access via http://localhost:37777/api/observation/{id} or view all in the web viewer at http://localhost:37777) -- 🧪 **Beta Channel** - Try experimental features like Endless Mode via version switching +- 🔗 **Citations** - Reference past observations with IDs through the worker API or view all in the web viewer --- @@ -194,7 +193,6 @@ The installer handles dependencies, plugin setup, AI provider configuration, wor - **[Installation Guide](https://docs.claude-mem.ai/installation)** - Quick start & advanced installation - **[Usage Guide](https://docs.claude-mem.ai/usage/getting-started)** - How Claude-Mem works automatically - **[Search Tools](https://docs.claude-mem.ai/usage/search-tools)** - Query your project history with natural language -- **[Beta Features](https://docs.claude-mem.ai/beta-features)** - Try experimental features like Endless Mode ### Best Practices @@ -215,6 +213,7 @@ The installer handles dependencies, plugin setup, AI provider configuration, wor - **[Configuration](https://docs.claude-mem.ai/configuration)** - Environment variables & settings - **[Development](https://docs.claude-mem.ai/development)** - Building, testing, contributing +- **[Release Branches](https://docs.claude-mem.ai/branches)** - Stable, core-dev, and community-edge branch flow - **[Troubleshooting](https://docs.claude-mem.ai/troubleshooting)** - Common issues & solutions --- @@ -225,7 +224,7 @@ The installer handles dependencies, plugin setup, AI provider configuration, wor 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - Cached dependency checker (pre-hook script, not a lifecycle hook) -3. **Worker Service** - HTTP API on port 37777 with web viewer UI and 10 search endpoints, managed by Bun +3. **Worker Service** - Local HTTP API with web viewer UI and search endpoints, managed by Bun 4. **SQLite Database** - Stores sessions, observations, summaries 5. **mem-search Skill** - Natural language queries with progressive disclosure 6. **Chroma Vector Database** - Hybrid semantic + keyword search for intelligent context retrieval @@ -273,11 +272,12 @@ See [Search Tools Guide](https://docs.claude-mem.ai/usage/search-tools) for deta --- -## Beta Features +## Release Branches -Claude-Mem offers a **beta channel** with experimental features like **Endless Mode** (biomimetic memory architecture for extended sessions). Switch between stable and beta versions from the web viewer UI at http://localhost:37777 → Settings. - -See **[Beta Features Documentation](https://docs.claude-mem.ai/beta-features)** for details on Endless Mode and how to try it. +Stable releases ship from `main` and are published to npm. `core-dev` and +`community-edge` are source-run branches for early reliability fixes and +community integrations. See **[Release Branches](https://docs.claude-mem.ai/branches)** +for the branch flow and non-stable run instructions. --- @@ -382,6 +382,11 @@ Contributions are welcome! Please: 4. Update documentation 5. Submit a Pull Request +Claude-Mem ships from three branches: `main` (stable), `core-dev`, and +`community-edge`. Only `main` is published to npm; the others are run from +source. See [Release Branches](https://docs.claude-mem.ai/branches) for the +strategy and local run instructions. + See [Development Guide](https://docs.claude-mem.ai/development) for contribution workflow. --- @@ -417,7 +422,7 @@ open/commercial boundary. --- -### What About CMEM? +### What About CMEM? CMEM is a token created by a 3rd party but officially embraced by the creator of Claude-Mem (Alex Newman, @thedotmack). The token acts as a community catalyst for growth and a vehicle for bringing CMEM to the developers and knowledge workers that need it most. diff --git a/docs/i18n/.translation-cache.json b/docs/i18n/.translation-cache.json index 4344fa14e..ed1c599a2 100644 --- a/docs/i18n/.translation-cache.json +++ b/docs/i18n/.translation-cache.json @@ -1,146 +1,166 @@ { - "sourceHash": "c0eb50d6772b5e61", - "lastUpdated": "2025-12-23T00:48:34.035Z", + "sourceHash": "5ab0767e0980d6d4", + "lastUpdated": "2026-07-06T19:13:44.286Z", "translations": { "zh": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.09515915 - }, - "ja": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.09678544999999998 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.2820174 }, "pt-br": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.08436794999999998 - }, - "ko": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.10244419999999999 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.411693 }, "es": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.0894832 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.2996934 }, - "de": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.08818689999999998 + "pt": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.375255 }, "fr": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:39:44.891Z", - "costUsd": 0.0855869 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.4141020000000001 }, - "nl": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.0943619 + "zh-tw": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.611Z", + "costUsd": 0.2854734 }, - "ru": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.0944719 + "ja": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.612Z", + "costUsd": 0.407814 }, - "pl": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.08966189999999999 + "de": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.612Z", + "costUsd": 0.3109974 }, - "cs": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.08897189999999998 - }, - "uk": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.09968189999999999 - }, - "tr": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.0969419 - }, - "ar": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.10445689999999998 - }, - "he": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:43:09.878Z", - "costUsd": 0.1489769 + "ko": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:05:38.612Z", + "costUsd": 0.42012000000000005 }, "id": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.08454690000000001 - }, - "sv": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.09621189999999999 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.41407499999999997 }, "ro": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.10500190000000001 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.417174 }, "vi": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.1035169 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.43416600000000005 }, "hi": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.1171519 - }, - "th": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.11580689999999999 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.448296 }, "bn": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:45:44.015Z", - "costUsd": 0.1376269 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.47555400000000003 + }, + "th": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.45055500000000004 + }, + "tl": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:06:47.996Z", + "costUsd": 0.549732 + }, + "ru": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.409269 + }, + "nl": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.41447100000000003 + }, + "tr": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.426993 + }, + "pl": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.4277099999999999 + }, + "uk": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.29703840000000004 + }, + "cs": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.3023304 + }, + "he": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.422784 + }, + "ar": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:06.144Z", + "costUsd": 0.674184 + }, + "sv": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:11.780Z", + "costUsd": 0.2918214 }, "it": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.0875869 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:56.973Z", + "costUsd": 0.30166139999999997 }, "da": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.0830469 - }, - "no": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.08986190000000001 - }, - "hu": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.0911269 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:56.973Z", + "costUsd": 0.2977074 }, "fi": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.09436689999999999 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:56.973Z", + "costUsd": 0.3121044 + }, + "hu": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:56.973Z", + "costUsd": 0.30374639999999997 }, "el": { - "hash": "c0eb50d6772b5e61", - "translatedAt": "2025-12-23T00:48:34.035Z", - "costUsd": 0.19731189999999998 + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:08:56.973Z", + "costUsd": 0.5626133999999999 + }, + "no": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:10:37.489Z", + "costUsd": 0.29734740000000004 + }, + "ur": { + "hash": "5ab0767e0980d6d4", + "translatedAt": "2026-07-06T19:13:44.286Z", + "costUsd": 0.3279894 } } } \ No newline at end of file diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md index 2fd048cc7..c53a288ec 100644 --- a/docs/i18n/README.ar.md +++ b/docs/i18n/README.ar.md @@ -1,4 +1,7 @@ +🌐 هذه ترجمة آلية. نرحب بالتصحيحات من المجتمع! +
+


@@ -9,47 +12,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

أداة إضافية لـ Claude Code تعمل على أتمتة تسجيل معلومات الجلسات السابقه، وضغطها, ثم حقن السياق ذي الصلة في الجلسات المستقبلية. -

+

نظام دائم لضغط الذاكرة، مصمم خصيصاً لـ Claude Code.

- License + License Version @@ -74,13 +81,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

بداية سريعة • @@ -89,55 +123,80 @@ التوثيق • الإعدادات • استكشاف الأخطاء وإصلاحها • - الترخيص + الترخيص

-

-Claude-Mem هو نظام متطور مصمم لضغط وحفظ الذاكرة لسياق عمل Claude Code. وظيفته الأساسية هي جعل "كلود" يتذكر ما فعله في جلسات العمل السابقة بسلاسة، عبر تسجيل تحركاته، وإنشاء ملخصات ذكية، واستدعائها في الجلسات المستقبلية. هذا يضمن عدم ضياع سياق المشروع حتى لو أغلقت البرنامج وفتحته لاحقاً. +

+ يحافظ Claude-Mem على السياق بسلاسة عبر الجلسات من خلال تسجيل ملاحظات استخدام الأدوات تلقائياً، وإنشاء ملخصات دلالية، وإتاحتها للجلسات المستقبلية. يتيح هذا لـ Claude الحفاظ على استمرارية المعرفة حول المشاريع حتى بعد انتهاء الجلسات أو إعادة الاتصال.

--- -## بداية سريعة +## بداية سريعة -للبدء، افتح "Claude Code" في مبنى الأوامر (Terminal) واكتب الأوامر التالية: -
+قم بالتثبيت بأمر واحد: -``` -> /plugin marketplace add thedotmack/claude-mem - -> /plugin install claude-mem +```bash +npx claude-mem install ``` -
+أو قم بالتثبيت لـ OpenCode: -بمجرد إعادة تشغيل Claude Code، سيتم استدعاء السياق من الجلسات السابقة تلقائيا عند الحاجة. +```bash +npx claude-mem install --ide opencode +``` + +أو قم بالتثبيت لـ Antigravity CLI ([دليل الإعداد](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +أو قم بالتثبيت من متجر الإضافات (plugin marketplace) داخل Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem +``` + +أعد تشغيل Claude Code. سيظهر السياق من الجلسات السابقة تلقائياً في الجلسات الجديدة. + +> **ملاحظة:** يُنشر Claude-Mem أيضاً على npm، إلا أن الأمر `npm install -g claude-mem` يُثبّت **حزمة الـ SDK/المكتبة فقط** — ولا يقوم بتسجيل خطافات الإضافة (plugin hooks) ولا بإعداد خدمة العامل (worker service). قم دائماً بالتثبيت عبر `npx claude-mem install` أو أوامر `/plugin` المذكورة أعلاه. + +### 🦞 بوابة OpenClaw (OpenClaw Gateway) + +قم بتثبيت claude-mem كإضافة ذاكرة دائمة على بوابات [OpenClaw](https://openclaw.ai) بأمر واحد: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +يتولى برنامج التثبيت التبعيات، وإعداد الإضافة، وتهيئة مزوّد الذكاء الاصطناعي، وتشغيل العامل (worker)، بالإضافة إلى بثّ اختياري للملاحظات في الوقت الفعلي إلى Telegram وDiscord وSlack وغيرها. راجع [دليل تكامل OpenClaw](https://docs.claude-mem.ai/openclaw-integration) للتفاصيل. **الميزات الرئيسية:** -- 🧠 **ذاكرة مستديمه**: سياق عملك لا ينتهي بانتهاء الجلسة، بل ينتقل معك للجلسة التالية. -- 📊 **الكشف التدريجي** (Progressive Disclosure): نظام ذكي يستدعي المعلومات على طبقات، مما يمنحك رؤية واضحة لاستهلاك الـ "Tokens" (التكلفة). -- 🔍 **بحث سريع** - استعلم عن سجل مشروعك باستخدام خاصية `mem-search`. -- 🖥️ **واجهة مستخدم ويب** - رؤية معلومات الذاكرة مع تحديث فوري عبر المتصفح من خلال الرابط: http://localhost:37777 -- 💻 **تكامل مع Claude Desktop** - إمكانية البحث في الذاكرة مباشرة من واجهة Claude المكتبية -- 🔒 **التحكم في الخصوصية** - دعم وسم `` لمنع النظام من تخزين أي معلومات حساسة. -- ⚙️ **إعدادات السياق** - تحكم دقيق في السياق (context) التي سيتم حقنها في سياق المحادثة. -- 🤖 **أتمتة كاملة:** - النظام يعمل في الخلفية دون الحاجة لتدخل يدوي منك. -- 🔗 **الاستشهادات** - رجوع إلى الملاحظات السابقة باستخدام (http://localhost:37777/api/observation/{id} أو عرض جميع المعلومات على http://localhost:37777) -- 🧪 **مزايا التجريبيه** - تجربة مميزات مثل "الوضع اللانهائي" (Endless Mode). +- 🧠 **ذاكرة دائمة** - السياق يستمر عبر الجلسات +- 📊 **الكشف التدريجي (Progressive Disclosure)** - استرجاع الذاكرة على طبقات مع رؤية واضحة لتكلفة الـ tokens +- 🔍 **بحث قائم على المهارات** - استعلم عن سجل مشروعك باستخدام مهارة mem-search +- 🖥️ **واجهة مستخدم عارض الويب** - بثّ مباشر للذاكرة عبر رابط العامل (worker URL) الذي يُطبع عند بدء التشغيل +- 💻 **مهارة Claude Desktop** - ابحث في الذاكرة من محادثات Claude Desktop +- 🔒 **التحكم في الخصوصية** - استخدم وسوم `` لاستبعاد المحتوى الحساس من التخزين +- ⚙️ **إعدادات السياق** - تحكم دقيق فيما يتم حقنه من السياق +- 🤖 **تشغيل تلقائي** - لا حاجة لأي تدخل يدوي +- 🔗 **الاستشهادات** - الرجوع إلى الملاحظات السابقة عبر معرّفاتها (IDs) من خلال واجهة برمجة تطبيقات العامل (worker API) أو عرضها جميعاً في عارض الويب --- -## المستندات +## المستندات 📚 **[عرض التوثيق الكامل](https://docs.claude-mem.ai/)** - تصفح على الموقع الرسمي ### البدء - **[دليل التثبيت](https://docs.claude-mem.ai/installation)** - البدء السريع والتثبيت المتقدم -- **[دليل الاستخدام](https://docs.claude-mem.ai/usage/getting-started)** - كيف يعمل Claude-Mem تلقائيًا -- **[أدوات البحث](https://docs.claude-mem.ai/usage/search-tools)** - استعلم عن سجل مشروعك بلغتك -- **[الميزات التجريبية](https://docs.claude-mem.ai/beta-features)** - جرّب الميزات التجريبية مثل Endless Mode +- **[دليل الاستخدام](https://docs.claude-mem.ai/usage/getting-started)** - كيف يعمل Claude-Mem تلقائياً +- **[أدوات البحث](https://docs.claude-mem.ai/usage/search-tools)** - استعلم عن سجل مشروعك باللغة الطبيعية ### أفضل الممارسات @@ -147,17 +206,18 @@ Claude-Mem هو نظام متطور مصمم لضغط وحفظ الذاكرة ل ### البنية المعمارية - **[نظرة عامة](https://docs.claude-mem.ai/architecture/overview)** - مكونات النظام وتدفق البيانات -- **[تطور البنية المعمارية](https://docs.claude-mem.ai/architecture-evolution)** - تطور المعمارية من v3 إلى v5 +- **[تطور البنية المعمارية](https://docs.claude-mem.ai/architecture-evolution)** - رحلة التطور من v3 إلى v5 - **[بنية برامج الربط (Hooks)](https://docs.claude-mem.ai/hooks-architecture)** - كيف يستخدم Claude-Mem خطافات دورة الحياة - **[مرجع برامج الربط (Hooks)](https://docs.claude-mem.ai/architecture/hooks)** - شرح 7 سكريبتات خطافات -- **[خدمة العامل](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API وإدارة Bun +- **[خدمة العامل](https://docs.claude-mem.ai/architecture/worker-service)** - واجهة HTTP API وإدارة Bun - **[قاعدة البيانات](https://docs.claude-mem.ai/architecture/database)** - مخطط SQLite وبحث FTS5 -- **[بنية البحث](https://docs.claude-mem.ai/architecture/search-architecture)** - البحث المختلط مع قاعدة بيانات المتجهات Chroma +- **[بنية البحث](https://docs.claude-mem.ai/architecture/search-architecture)** - البحث الهجين مع قاعدة بيانات المتجهات Chroma ### الإعدادات والتطوير - **[الإعدادات](https://docs.claude-mem.ai/configuration)** - متغيرات البيئة والإعدادات -- **[التطوير](https://docs.claude-mem.ai/development)** - البناء، الاختبار، سير العمل للمساهمة +- **[التطوير](https://docs.claude-mem.ai/development)** - البناء، الاختبار، والمساهمة +- **[فروع الإصدارات](https://docs.claude-mem.ai/branches)** - تدفق فروع Stable وcore-dev وcommunity-edge - **[استكشاف الأخطاء وإصلاحها](https://docs.claude-mem.ai/troubleshooting)** - المشكلات الشائعة والحلول --- @@ -166,139 +226,204 @@ Claude-Mem هو نظام متطور مصمم لضغط وحفظ الذاكرة ل **المكونات الأساسية:** -1. **5 برامج ربط (Hooks)** - SessionStart، UserPromptSubmit، PostToolUse، Stop، SessionEnd -2. **تثبيت ذكي** - فاحص التبعيات المخزنة مؤقتًا -3. **خدمة العامل** - HTTP API على المنفذ 37777 مع واجهة مستخدم عارض الويب و10 نقاط نهاية للبحث، تديرها Bun -4. **قاعدة بيانات SQLite** - تخزن الجلسات، الملاحظات، الملخصات -5. **مهارة mem-search** - استعلامات اللغة الطبيعية مع الكشف التدريجي -6. **قاعدة بيانات المتجهات Chroma** - البحث الدلالي الهجين + الكلمات المفتاحية لاسترجاع السياق الذكي +1. **5 خطافات لدورة الحياة (Lifecycle Hooks)** - SessionStart، UserPromptSubmit، PostToolUse، Stop، SessionEnd (6 سكريبتات خطافات) +2. **تثبيت ذكي** - فاحص تبعيات مخزّن مؤقتاً (سكريبت سابق للخطاف، وليس خطاف دورة حياة) +3. **خدمة العامل** - واجهة HTTP API محلية مع واجهة مستخدم عارض الويب ونقاط نهاية للبحث، تديرها Bun +4. **قاعدة بيانات SQLite** - تخزّن الجلسات، الملاحظات، والملخصات +5. **مهارة mem-search** - استعلامات باللغة الطبيعية مع الكشف التدريجي +6. **قاعدة بيانات المتجهات Chroma** - بحث هجين دلالي + بالكلمات المفتاحية لاسترجاع سياق ذكي -انظر [نظرة عامة على البنية المعمارية](https://docs.claude-mem.ai/architecture/overview) للتفاصيل. +راجع [نظرة عامة على البنية المعمارية](https://docs.claude-mem.ai/architecture/overview) للتفاصيل. --- ## أدوات البحث (MCP Search Tools) -يوفر Claude-Mem بحثًا ذكيًا من خلال مهارة mem-search التي تُستدعى تلقائيًا عندما تسأل عن العمل السابق: + +يوفر Claude-Mem بحثاً ذكياً في الذاكرة من خلال **4 أدوات MCP** تتبع نمط سير عمل **من 3 طبقات** موفّراً لاستهلاك الـ tokens: + +**سير العمل من 3 طبقات:** + +1. **`search`** - الحصول على فهرس مضغوط مع المعرّفات (IDs) (~50-100 tokens لكل نتيجة) +2. **`timeline`** - الحصول على سياق زمني حول النتائج المثيرة للاهتمام +3. **`get_observations`** - جلب التفاصيل الكاملة فقط للمعرّفات (IDs) المُصفّاة (~500-1,000 tokens لكل نتيجة) **كيف يعمل:** -- فقط اسأل بشكل طبيعي: *"ماذا فعلنا في الجلسة الأخيرة؟"* أو *"هل أصلحنا هذا الخطأ من قبل؟"* -- يستدعي Claude تلقائيًا خاصية mem-search للعثور على السياق ذي الصلة +- يستخدم Claude أدوات MCP للبحث في ذاكرتك +- ابدأ بـ `search` للحصول على فهرس للنتائج +- استخدم `timeline` لمعرفة ما كان يحدث حول ملاحظات محددة +- استخدم `get_observations` لجلب التفاصيل الكاملة للمعرّفات ذات الصلة +- **توفير يصل إلى 10 أضعاف في استهلاك الـ tokens** من خلال التصفية قبل جلب التفاصيل -**عمليات البحث المتاحة:** +**أدوات MCP المتاحة:** -1. **البحث في الملاحظات** - البحث النصي الكامل عبر الملاحظات -2. **البحث في الجلسات** - البحث النصي الكامل عبر ملخصات الجلسات -3. **البحث في المطالبات** - البحث في طلبات المستخدم الخام -4. **حسب المفهوم** - البحث بواسطة وسوم المفهوم (discovery، problem-solution، pattern، إلخ.) -5. **حسب الملف** - البحث عن الملاحظات التي تشير إلى ملفات محددة -6. **حسب النوع** - البحث حسب النوع (decision، bugfix، feature، refactor، discovery، change) -7. **السياق الحديث** - الحصول على سياق الجلسة الأخيرة لمشروع -8. **الجدول الزمني** - الحصول على جدول زمني موحد للسياق حول نقطة زمنية محددة -9. **الجدول الزمني حسب الاستعلام** - البحث عن الملاحظات والحصول على سياق الجدول الزمني حول أفضل تطابق -10. **مساعدة API** - الحصول على توثيق API البحث +1. **`search`** - البحث في فهرس الذاكرة باستعلامات نصية كاملة، مع التصفية حسب النوع/التاريخ/المشروع +2. **`timeline`** - الحصول على سياق زمني حول ملاحظة أو استعلام محدد +3. **`get_observations`** - جلب تفاصيل الملاحظات الكاملة حسب المعرّفات (IDs) (اجمع دائماً عدة معرّفات في طلب واحد) -**أمثلة على الاستعلامات:** +**مثال على الاستخدام:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Step 1: Search for index +search(query="authentication bug", type="bugfix", limit=10) + +// Step 2: Review index, identify relevant IDs (e.g., #123, #456) + +// Step 3: Fetch full details +get_observations(ids=[123, 456]) ``` -انظر [دليل أدوات البحث](https://docs.claude-mem.ai/usage/search-tools) لأمثلة مفصلة. +راجع [دليل أدوات البحث](https://docs.claude-mem.ai/usage/search-tools) لأمثلة مفصلة. --- -## الميزات التجريبية +## فروع الإصدارات -يقدم Claude-Mem **قناة تجريبية** بميزات تجريبية مثل **Endless Mode** (بنية ذاكرة بيوميمتية للجلسات الممتدة). بدّل بين الإصدارات المستقرة والتجريبية من واجهة مستخدم عارض الويب على http://localhost:37777 ← الإعدادات. - -انظر **[توثيق الميزات التجريبية](https://docs.claude-mem.ai/beta-features)** لتفاصيل حول Endless Mode وكيفية تجربته. +يتم إصدار النسخ المستقرة من فرع `main` ونشرها على npm. أما `core-dev` و`community-edge` فهما فرعان يتم تشغيلهما من المصدر لإصلاحات الموثوقية المبكرة وتكاملات المجتمع. راجع **[فروع الإصدارات](https://docs.claude-mem.ai/branches)** لمعرفة تدفق الفروع وتعليمات التشغيل غير المستقر. --- ## متطلبات النظام -- **Node.js**: 20.0.0 أو أعلى -- **Claude Code**: أحدث إصدار مع دعم الإضافات -- **Bun & uv**: (يتم تثبيتهما تلقائياً) لإدارة العمليات والبحث المتجه. -- **SQLite 3**: للتخزين المستمر (مدمج) +- **Node.js**: 20.0.0 أو أحدث +- **Claude Code**: أحدث إصدار يدعم الإضافات +- **Bun**: بيئة تشغيل JavaScript ومدير عمليات (يُثبَّت تلقائياً إذا لم يكن موجوداً) +- **uv**: مدير حزم Python للبحث المتجهي (يُثبَّت تلقائياً إذا لم يكن موجوداً) +- **SQLite 3**: للتخزين الدائم (مضمّن) + +--- +### ملاحظات إعداد Windows + +إذا واجهت خطأ مثل: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +تأكد من تثبيت Node.js وnpm وإضافتهما إلى متغيّر PATH. قم بتنزيل أحدث برنامج تثبيت لـ Node.js من https://nodejs.org وأعد تشغيل الطرفية (terminal) بعد التثبيت. --- ## الإعدادات -تتم إدارة الإعدادات في `~/.claude-mem/settings.json` (يتم إنشاؤه تلقائيًا بالقيم الافتراضية عند التشغيل الأول). قم بتكوين نموذج الذكاء الاصطناعي، منفذ العامل، دليل البيانات، مستوى السجل، وإعدادات حقن السياق. +تتم إدارة الإعدادات في `~/.claude-mem/settings.json` (يُنشأ تلقائياً بالقيم الافتراضية عند التشغيل الأول). قم بتهيئة نموذج الذكاء الاصطناعي، ومنفذ العامل (worker port)، ودليل البيانات، ومستوى السجل (log level)، وإعدادات حقن السياق. -انظر **[دليل الإعدادات](https://docs.claude-mem.ai/configuration)** لجميع الإعدادات المتاحة والأمثلة. +راجع **[دليل الإعدادات](https://docs.claude-mem.ai/configuration)** لجميع الإعدادات المتاحة والأمثلة. + +### إعدادات الوضع واللغة + +يدعم Claude-Mem أوضاع سير عمل ولغات متعددة عبر إعداد `CLAUDE_MEM_MODE`. + +يتحكم هذا الخيار في كلا الأمرين: +- سلوك سير العمل (مثل code وchill وinvestigation) +- اللغة المستخدمة في الملاحظات المُنشأة + +#### كيفية الإعداد + +قم بتحرير ملف الإعدادات الخاص بك في `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +يتم تعريف الأوضاع في `plugin/modes/`. لرؤية جميع الأوضاع المتاحة محلياً: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### الأوضاع المتاحة + +| الوضع | الوصف | +|------------|-------------------------| +| `code` | الوضع الافتراضي (الإنجليزية) | +| `code--zh` | وضع الصينية المبسطة | +| `code--ja` | وضع اليابانية | + +تتبع الأوضاع الخاصة باللغة النمط `code--[lang]` حيث يكون `[lang]` هو رمز اللغة وفق معيار ISO 639-1 (مثل `zh` للصينية، و`ja` لليابانية، و`es` للإسبانية). + +> ملاحظة: الوضع `code--zh` (الصينية المبسطة) مدمج بالفعل — لا حاجة لأي تثبيت إضافي أو تحديث للإضافة. + +#### بعد تغيير الوضع + +أعد تشغيل Claude Code لتطبيق إعداد الوضع الجديد. --- ## التطوير -انظر **[دليل التطوير](https://docs.claude-mem.ai/development)** لتعليمات البناء، الاختبار، وسير عمل المساهمة. +راجع **[دليل التطوير](https://docs.claude-mem.ai/development)** لتعليمات البناء، والاختبار، وسير عمل المساهمة. --- ## استكشاف الأخطاء وإصلاحها -إذا واجهت مشكلة، اشرحها لـ Claude وسيقوم بتشغيل خاصية troubleshoot لإصلاحها ذاتياً. +إذا واجهت مشكلات، اشرح المشكلة لـ Claude وستقوم مهارة troubleshoot تلقائياً بتشخيصها وتقديم الحلول. -انظر **[دليل استكشاف الأخطاء وإصلاحها](https://docs.claude-mem.ai/troubleshooting)** للمشكلات الشائعة والحلول. +راجع **[دليل استكشاف الأخطاء وإصلاحها](https://docs.claude-mem.ai/troubleshooting)** للمشكلات الشائعة والحلول. --- ## تقارير الأخطاء أنشئ تقارير أخطاء شاملة باستخدام المولّد الآلي: -
```bash cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report ``` -
## المساهمة المساهمات مرحب بها! يُرجى: -1. عمل Fork للمشروع (Repository) -2. إنشاء فرع (branch) +1. عمل Fork للمستودع (repository) +2. إنشاء فرع (branch) للميزة 3. إجراء التغييرات مع الاختبارات -4. تحديث المستندات عند الحاجه +4. تحديث المستندات 5. تقديم Pull Request -انظر [دليل التطوير](https://docs.claude-mem.ai/development) لسير عمل المساهمة. +يتم إصدار Claude-Mem من ثلاثة فروع: `main` (المستقر)، و`core-dev`، و`community-edge`. يُنشر `main` فقط على npm؛ أما الفروع الأخرى فيتم تشغيلها من المصدر. راجع [فروع الإصدارات](https://docs.claude-mem.ai/branches) للاطلاع على الاستراتيجية وتعليمات التشغيل المحلي. + +راجع [دليل التطوير](https://docs.claude-mem.ai/development) لسير عمل المساهمة. --- -## License +## الترخيص -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem مرخّص بموجب رخصة Apache 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +اخترنا رخصة Apache-2.0 لأن الذاكرة الوكيلية الدائمة (durable agentic memory) ينبغي أن يكون من السهل تضمينها في أدوات المطورين، والوكلاء المحليين، وخوادم MCP، وأنظمة المؤسسات، ومنظومات الروبوتات، وأطر تشغيل الوكلاء في الإنتاج. -See the [LICENSE](LICENSE) file for full details. +راجع ملف [LICENSE](LICENSE) للتفاصيل الكاملة. راجع [docs/license.md](docs/license.md) +و[docs/ip-boundary.md](docs/ip-boundary.md) لمعرفة نطاق الترخيص والحدود بين المفتوح والتجاري. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**ملاحظة حول Ragtime**: دليل `ragtime/` مرخّص بموجب **رخصة Apache 2.0**. راجع [ragtime/LICENSE](ragtime/LICENSE) للتفاصيل. --- - ## الدعم - **التوثيق**: [docs/](docs/) - **المشكلات**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **المستودع**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **حساب X الرسمي**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord الرسمي**: [انضم إلى Discord](https://discord.com/invite/J4wttp9vDu) - **المؤلف**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**مبني باستخدام Claude Agent SDK** | **مدعوم بواسطة Claude Code** | **صُنع باستخدام TypeScript** +**مبني باستخدام Claude Agent SDK** | **يعمل مع Claude Code** | **صُنع باستخدام TypeScript** + +--- + +### ماذا عن CMEM؟ + +CMEM هو رمز (token) أنشأه طرف ثالث، لكنه معتمد رسمياً من قِبل مبتكر Claude-Mem (Alex Newman، @thedotmack). يعمل الرمز كحافز مجتمعي للنمو ووسيلة لإيصال CMEM إلى المطورين والعاملين في مجال المعرفة الأكثر حاجة إليه. + +عنوان العقد الرسمي على BASE (BASE CA): 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3
+ +--- \ No newline at end of file diff --git a/docs/i18n/README.bn.md b/docs/i18n/README.bn.md index e91a38255..26781e62e 100644 --- a/docs/i18n/README.bn.md +++ b/docs/i18n/README.bn.md @@ -1,6 +1,5 @@ 🌐 এটি একটি স্বয়ংক্রিয় অনুবাদ। সম্প্রদায়ের সংশোধন স্বাগত জানাই! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code-এর জন্য নির্মিত স্থায়ী মেমরি কম্প্রেশন সিস্টেম।

- License + License Version @@ -75,58 +79,114 @@
+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +
+

- - - Claude-Mem Preview - - + দ্রুত শুরু • + এটি কীভাবে কাজ করে • + অনুসন্ধান টুল • + ডকুমেন্টেশন • + কনফিগারেশন • + সমস্যা সমাধান • + লাইসেন্স

- দ্রুত শুরু • - এটি কীভাবে কাজ করে • - অনুসন্ধান টুল • - ডকুমেন্টেশন • - কনফিগারেশন • - সমস্যা সমাধান • - লাইসেন্স -

- -

- Claude-Mem স্বয়ংক্রিয়ভাবে টুল ব্যবহারের পর্যবেক্ষণ ক্যাপচার করে, সিমান্টিক সারসংক্ষেপ তৈরি করে এবং সেগুলি ভবিষ্যতের সেশনে উপলব্ধ করে সেশন জুড়ে প্রসঙ্গ নির্বিঘ্নে সংরক্ষণ করে। এটি Claude কে সেশন শেষ হওয়ার বা পুনঃসংযোগের পরেও প্রকল্প সম্পর্কে জ্ঞানের ধারাবাহিকতা বজায় রাখতে সক্ষম করে। + Claude-Mem স্বয়ংক্রিয়ভাবে টুল ব্যবহারের পর্যবেক্ষণ ক্যাপচার করে, সিমান্টিক সারসংক্ষেপ তৈরি করে এবং সেগুলি ভবিষ্যতের সেশনে উপলব্ধ করে সেশন জুড়ে প্রসঙ্গ নির্বিঘ্নে সংরক্ষণ করে। এটি Claude-কে সেশন শেষ হওয়ার বা পুনঃসংযোগের পরেও প্রকল্প সম্পর্কে জ্ঞানের ধারাবাহিকতা বজায় রাখতে সক্ষম করে।

--- -## দ্রুত শুরু +## Quick Start -টার্মিনালে একটি নতুন Claude Code সেশন শুরু করুন এবং নিম্নলিখিত কমান্ডগুলি প্রবেশ করান: +একটি মাত্র কমান্ড দিয়ে ইনস্টল করুন: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +অথবা OpenCode-এর জন্য ইনস্টল করুন: + +```bash +npx claude-mem install --ide opencode +``` + +অথবা Antigravity CLI-এর জন্য ইনস্টল করুন ([সেটআপ গাইড](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +অথবা Claude Code-এর ভিতরে প্লাগইন মার্কেটপ্লেস থেকে ইনস্টল করুন: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Claude Code পুনরায় চালু করুন। পূর্ববর্তী সেশনের প্রসঙ্গ স্বয়ংক্রিয়ভাবে নতুন সেশনে উপস্থিত হবে। +> **উল্লেখ্য:** Claude-Mem npm-এও প্রকাশিত হয়, তবে `npm install -g claude-mem` কেবল **SDK/লাইব্রেরি** ইনস্টল করে — এটি প্লাগইন হুক নিবন্ধন করে না বা ওয়ার্কার সার্ভিস সেটআপ করে না। সবসময় উপরের `npx claude-mem install` অথবা `/plugin` কমান্ডের মাধ্যমে ইনস্টল করুন। + +### 🦞 OpenClaw Gateway + +একটি মাত্র কমান্ড দিয়ে [OpenClaw](https://openclaw.ai) গেটওয়েতে claude-mem-কে স্থায়ী মেমরি প্লাগইন হিসেবে ইনস্টল করুন: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +ইনস্টলার নির্ভরতা, প্লাগইন সেটআপ, AI প্রোভাইডার কনফিগারেশন, ওয়ার্কার চালু করা এবং Telegram, Discord, Slack ও আরও অনেক জায়গায় ঐচ্ছিক রিয়েল-টাইম পর্যবেক্ষণ ফিড পরিচালনা করে। বিস্তারিত জানতে [OpenClaw ইন্টিগ্রেশন গাইড](https://docs.claude-mem.ai/openclaw-integration) দেখুন। + **মূল বৈশিষ্ট্যসমূহ:** - 🧠 **স্থায়ী মেমরি** - প্রসঙ্গ সেশন জুড়ে টিকে থাকে - 📊 **প্রগতিশীল প্রকাশ** - টোকেন খরচ দৃশ্যমানতা সহ স্তরযুক্ত মেমরি পুনরুদ্ধার - 🔍 **দক্ষতা-ভিত্তিক অনুসন্ধান** - mem-search skill দিয়ে আপনার প্রকল্পের ইতিহাস অনুসন্ধান করুন -- 🖥️ **ওয়েব ভিউয়ার UI** - http://localhost:37777 এ রিয়েল-টাইম মেমরি স্ট্রিম +- 🖥️ **ওয়েব ভিউয়ার UI** - স্টার্টআপে প্রিন্ট করা ওয়ার্কার URL-এ রিয়েল-টাইম মেমরি স্ট্রিম - 💻 **Claude Desktop Skill** - Claude Desktop কথোপকথন থেকে মেমরি অনুসন্ধান করুন - 🔒 **গোপনীয়তা নিয়ন্ত্রণ** - সংবেদনশীল বিষয়বস্তু স্টোরেজ থেকে বাদ দিতে `` ট্যাগ ব্যবহার করুন - ⚙️ **প্রসঙ্গ কনফিগারেশন** - কোন প্রসঙ্গ ইনজেক্ট করা হবে তার উপর সূক্ষ্ম নিয়ন্ত্রণ -- 🤖 **স্বয়ংক্রিয় অপারেশন** - কোন ম্যানুয়াল হস্তক্ষেপ প্রয়োজন নেই -- 🔗 **উদ্ধৃতি** - ID দিয়ে পূর্ববর্তী পর্যবেক্ষণ রেফারেন্স করুন (http://localhost:37777/api/observation/{id} এর মাধ্যমে অ্যাক্সেস করুন অথবা http://localhost:37777 এ ওয়েব ভিউয়ারে সব দেখুন) -- 🧪 **বিটা চ্যানেল** - ভার্সন পরিবর্তনের মাধ্যমে Endless Mode-এর মতো পরীক্ষামূলক বৈশিষ্ট্য চেষ্টা করুন +- 🤖 **স্বয়ংক্রিয় অপারেশন** - কোনো ম্যানুয়াল হস্তক্ষেপ প্রয়োজন নেই +- 🔗 **উদ্ধৃতি** - ওয়ার্কার API-এর মাধ্যমে ID দিয়ে পূর্ববর্তী পর্যবেক্ষণ রেফারেন্স করুন অথবা ওয়েব ভিউয়ারে সব দেখুন --- -## ডকুমেন্টেশন +## Documentation 📚 **[সম্পূর্ণ ডকুমেন্টেশন দেখুন](https://docs.claude-mem.ai/)** - অফিসিয়াল ওয়েবসাইটে ব্রাউজ করুন @@ -135,7 +195,6 @@ Claude Code পুনরায় চালু করুন। পূর্ব - **[ইনস্টলেশন গাইড](https://docs.claude-mem.ai/installation)** - দ্রুত শুরু এবং উন্নত ইনস্টলেশন - **[ব্যবহার গাইড](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem কীভাবে স্বয়ংক্রিয়ভাবে কাজ করে - **[অনুসন্ধান টুল](https://docs.claude-mem.ai/usage/search-tools)** - প্রাকৃতিক ভাষা দিয়ে আপনার প্রকল্পের ইতিহাস অনুসন্ধান করুন -- **[বিটা বৈশিষ্ট্য](https://docs.claude-mem.ai/beta-features)** - Endless Mode-এর মতো পরীক্ষামূলক বৈশিষ্ট্য চেষ্টা করুন ### সর্বোত্তম অনুশীলন @@ -156,6 +215,7 @@ Claude Code পুনরায় চালু করুন। পূর্ব - **[কনফিগারেশন](https://docs.claude-mem.ai/configuration)** - পরিবেশ ভেরিয়েবল এবং সেটিংস - **[ডেভেলপমেন্ট](https://docs.claude-mem.ai/development)** - বিল্ডিং, টেস্টিং, অবদান +- **[রিলিজ ব্র্যাঞ্চ](https://docs.claude-mem.ai/branches)** - স্টেবল, core-dev, এবং community-edge ব্র্যাঞ্চ ফ্লো - **[সমস্যা সমাধান](https://docs.claude-mem.ai/troubleshooting)** - সাধারণ সমস্যা এবং সমাধান --- @@ -166,7 +226,7 @@ Claude Code পুনরায় চালু করুন। পূর্ব 1. **৫টি লাইফসাইকেল হুক** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (৬টি হুক স্ক্রিপ্ট) 2. **স্মার্ট ইনস্টল** - ক্যাশড ডিপেন্ডেন্সি চেকার (প্রি-হুক স্ক্রিপ্ট, লাইফসাইকেল হুক নয়) -3. **ওয়ার্কার সার্ভিস** - ওয়েব ভিউয়ার UI এবং ১০টি অনুসন্ধান এন্ডপয়েন্ট সহ পোর্ট 37777-এ HTTP API, Bun দ্বারা পরিচালিত +3. **ওয়ার্কার সার্ভিস** - ওয়েব ভিউয়ার UI এবং অনুসন্ধান এন্ডপয়েন্ট সহ লোকাল HTTP API, Bun দ্বারা পরিচালিত 4. **SQLite ডাটাবেস** - সেশন, পর্যবেক্ষণ, সারসংক্ষেপ সংরক্ষণ করে 5. **mem-search Skill** - প্রগতিশীল প্রকাশ সহ প্রাকৃতিক ভাষা প্রশ্ন 6. **Chroma ভেক্টর ডাটাবেস** - বুদ্ধিমান প্রসঙ্গ পুনরুদ্ধারের জন্য হাইব্রিড সিমান্টিক + কীওয়ার্ড অনুসন্ধান @@ -175,50 +235,55 @@ Claude Code পুনরায় চালু করুন। পূর্ব --- -## অনুসন্ধান টুল +## MCP Search Tools -Claude-Mem, mem-search skill-এর মাধ্যমে বুদ্ধিমান অনুসন্ধান প্রদান করে যা আপনি পূর্ববর্তী কাজ সম্পর্কে জিজ্ঞাসা করলে স্বয়ংক্রিয়ভাবে চালু হয়: +Claude-Mem একটি টোকেন-দক্ষ **৩-স্তরীয় ওয়ার্কফ্লো প্যাটার্ন** অনুসরণ করে **৪টি MCP টুল**-এর মাধ্যমে বুদ্ধিমান মেমরি অনুসন্ধান প্রদান করে: + +**৩-স্তরীয় ওয়ার্কফ্লো:** + +1. **`search`** - ID সহ কমপ্যাক্ট ইনডেক্স পান (~৫০-১০০ টোকেন/ফলাফল) +2. **`timeline`** - আগ্রহজনক ফলাফলের চারপাশে কালানুক্রমিক প্রসঙ্গ পান +3. **`get_observations`** - শুধুমাত্র ফিল্টার করা ID-এর জন্য সম্পূর্ণ বিবরণ আনুন (~৫০০-১,০০০ টোকেন/ফলাফল) **এটি কীভাবে কাজ করে:** -- শুধু স্বাভাবিকভাবে জিজ্ঞাসা করুন: *"গত সেশনে আমরা কী করেছিলাম?"* অথবা *"আমরা কি আগে এই বাগটি ঠিক করেছিলাম?"* -- Claude স্বয়ংক্রিয়ভাবে প্রাসঙ্গিক প্রসঙ্গ খুঁজে পেতে mem-search skill চালু করে +- Claude আপনার মেমরি অনুসন্ধান করতে MCP টুল ব্যবহার করে +- ফলাফলের একটি ইনডেক্স পেতে `search` দিয়ে শুরু করুন +- নির্দিষ্ট পর্যবেক্ষণের চারপাশে কী ঘটছিল তা দেখতে `timeline` ব্যবহার করুন +- প্রাসঙ্গিক ID-এর জন্য সম্পূর্ণ বিবরণ আনতে `get_observations` ব্যবহার করুন +- বিস্তারিত আনার আগে ফিল্টার করে **~১০ গুণ টোকেন সাশ্রয়** -**উপলব্ধ অনুসন্ধান অপারেশনসমূহ:** +**উপলব্ধ MCP টুল:** -1. **অবজারভেশন অনুসন্ধান করুন** - পর্যবেক্ষণ জুড়ে পূর্ণ-পাঠ্য অনুসন্ধান -2. **সেশন অনুসন্ধান করুন** - সেশন সারসংক্ষেপ জুড়ে পূর্ণ-পাঠ্য অনুসন্ধান -3. **প্রম্পট অনুসন্ধান করুন** - কাঁচা ব্যবহারকারী অনুরোধ অনুসন্ধান করুন -4. **ধারণা অনুযায়ী** - ধারণা ট্যাগ দ্বারা খুঁজুন (discovery, problem-solution, pattern, ইত্যাদি) -5. **ফাইল অনুযায়ী** - নির্দিষ্ট ফাইল উল্লেখ করা পর্যবেক্ষণ খুঁজুন -6. **টাইপ অনুযায়ী** - টাইপ দ্বারা খুঁজুন (decision, bugfix, feature, refactor, discovery, change) -7. **সাম্প্রতিক প্রসঙ্গ** - একটি প্রকল্পের জন্য সাম্প্রতিক সেশন প্রসঙ্গ পান -8. **টাইমলাইন** - সময়ের একটি নির্দিষ্ট বিন্দুর চারপাশে প্রসঙ্গের একীভূত টাইমলাইন পান -9. **প্রশ্ন দ্বারা টাইমলাইন** - পর্যবেক্ষণ অনুসন্ধান করুন এবং সেরা মিলের চারপাশে টাইমলাইন প্রসঙ্গ পান -10. **API সহায়তা** - অনুসন্ধান API ডকুমেন্টেশন পান +1. **`search`** - পূর্ণ-পাঠ্য কোয়েরি দিয়ে মেমরি ইনডেক্স অনুসন্ধান করুন, টাইপ/তারিখ/প্রকল্প দ্বারা ফিল্টার করে +2. **`timeline`** - একটি নির্দিষ্ট পর্যবেক্ষণ বা কোয়েরির চারপাশে কালানুক্রমিক প্রসঙ্গ পান +3. **`get_observations`** - ID দিয়ে সম্পূর্ণ পর্যবেক্ষণ বিবরণ আনুন (সবসময় একাধিক ID ব্যাচে করুন) -**প্রাকৃতিক ভাষা প্রশ্নের উদাহরণ:** +**ব্যবহারের উদাহরণ:** -``` -"গত সেশনে আমরা কোন বাগ ঠিক করেছিলাম?" -"আমরা কীভাবে অথেন্টিকেশন প্রয়োগ করেছি?" -"worker-service.ts-এ কী পরিবর্তন করা হয়েছিল?" -"এই প্রকল্পে সাম্প্রতিক কাজ দেখান" -"ভিউয়ার UI যোগ করার সময় কী হচ্ছিল?" +```typescript +// ধাপ ১: ইনডেক্সের জন্য অনুসন্ধান করুন +search(query="authentication bug", type="bugfix", limit=10) + +// ধাপ ২: ইনডেক্স পর্যালোচনা করুন, প্রাসঙ্গিক ID চিহ্নিত করুন (যেমন, #123, #456) + +// ধাপ ৩: সম্পূর্ণ বিবরণ আনুন +get_observations(ids=[123, 456]) ``` বিস্তারিত উদাহরণের জন্য [অনুসন্ধান টুল গাইড](https://docs.claude-mem.ai/usage/search-tools) দেখুন। --- -## বিটা বৈশিষ্ট্য +## Release Branches -Claude-Mem একটি **বিটা চ্যানেল** অফার করে যাতে **Endless Mode**-এর মতো পরীক্ষামূলক বৈশিষ্ট্য রয়েছে (বর্ধিত সেশনের জন্য বায়োমিমেটিক মেমরি আর্কিটেকচার)। http://localhost:37777 → Settings-এ ওয়েব ভিউয়ার UI থেকে স্থিতিশীল এবং বিটা সংস্করণের মধ্যে স্যুইচ করুন। - -Endless Mode এবং এটি কীভাবে চেষ্টা করবেন সে সম্পর্কে বিস্তারিত জানতে **[বিটা বৈশিষ্ট্য ডকুমেন্টেশন](https://docs.claude-mem.ai/beta-features)** দেখুন। +স্টেবল রিলিজগুলো `main` থেকে চালু হয় এবং npm-এ প্রকাশিত হয়। `core-dev` এবং +`community-edge` হলো প্রাথমিক নির্ভরযোগ্যতা সংশোধন এবং সম্প্রদায় ইন্টিগ্রেশনের জন্য +সোর্স-থেকে-চালানো ব্র্যাঞ্চ। ব্র্যাঞ্চ ফ্লো এবং নন-স্টেবল রান নির্দেশাবলীর জন্য +**[রিলিজ ব্র্যাঞ্চ](https://docs.claude-mem.ai/branches)** দেখুন। --- -## সিস্টেম প্রয়োজনীয়তা +## System Requirements - **Node.js**: 20.0.0 বা উচ্চতর - **Claude Code**: প্লাগইন সাপোর্ট সহ সর্বশেষ সংস্করণ @@ -227,22 +292,72 @@ Endless Mode এবং এটি কীভাবে চেষ্টা করব - **SQLite 3**: স্থায়ী স্টোরেজের জন্য (বান্ডল করা) --- +### Windows Setup Notes -## কনফিগারেশন +যদি আপনি এরকম একটি এরর দেখেন: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +নিশ্চিত করুন যে Node.js এবং npm ইনস্টল করা আছে এবং আপনার PATH-এ যোগ করা আছে। https://nodejs.org থেকে সর্বশেষ Node.js ইনস্টলার ডাউনলোড করুন এবং ইনস্টলেশনের পর আপনার টার্মিনাল পুনরায় চালু করুন। + +--- + +## Configuration সেটিংস `~/.claude-mem/settings.json`-এ পরিচালিত হয় (প্রথম রানে ডিফল্ট সহ স্বয়ংক্রিয়ভাবে তৈরি হয়)। AI মডেল, ওয়ার্কার পোর্ট, ডেটা ডিরেক্টরি, লগ লেভেল এবং প্রসঙ্গ ইনজেকশন সেটিংস কনফিগার করুন। সমস্ত উপলব্ধ সেটিংস এবং উদাহরণের জন্য **[কনফিগারেশন গাইড](https://docs.claude-mem.ai/configuration)** দেখুন। +### মোড ও ভাষা কনফিগারেশন + +Claude-Mem `CLAUDE_MEM_MODE` সেটিং-এর মাধ্যমে একাধিক ওয়ার্কফ্লো মোড এবং ভাষা সমর্থন করে। + +এই অপশনটি নিয়ন্ত্রণ করে: +- ওয়ার্কফ্লো আচরণ (যেমন code, chill, investigation) +- জেনারেট করা পর্যবেক্ষণে ব্যবহৃত ভাষা + +#### কীভাবে কনফিগার করবেন + +`~/.claude-mem/settings.json`-এ আপনার সেটিংস ফাইল সম্পাদনা করুন: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +মোডগুলো `plugin/modes/`-এ সংজ্ঞায়িত করা আছে। লোকালি সমস্ত উপলব্ধ মোড দেখতে: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### উপলব্ধ মোডসমূহ + +| Mode | বিবরণ | +|------------|-------------------------| +| `code` | ডিফল্ট ইংরেজি মোড | +| `code--zh` | সরলীকৃত চাইনিজ মোড | +| `code--ja` | জাপানি মোড | + +ভাষা-নির্দিষ্ট মোডগুলো `code--[lang]` প্যাটার্ন অনুসরণ করে, যেখানে `[lang]` হলো ISO 639-1 ভাষা কোড (যেমন, চাইনিজের জন্য `zh`, জাপানির জন্য `ja`, স্প্যানিশের জন্য `es`)। + +> উল্লেখ্য: `code--zh` (সরলীকৃত চাইনিজ) ইতিমধ্যে বিল্ট-ইন — কোনো অতিরিক্ত ইনস্টলেশন বা প্লাগইন আপডেট প্রয়োজন নেই। + +#### মোড পরিবর্তনের পর + +নতুন মোড কনফিগারেশন প্রয়োগ করতে Claude Code পুনরায় চালু করুন। --- -## ডেভেলপমেন্ট +## Development বিল্ড নির্দেশাবলী, টেস্টিং এবং অবদান ওয়ার্কফ্লোর জন্য **[ডেভেলপমেন্ট গাইড](https://docs.claude-mem.ai/development)** দেখুন। --- -## সমস্যা সমাধান +## Troubleshooting যদি সমস্যার সম্মুখীন হন, Claude-কে সমস্যাটি বর্ণনা করুন এবং troubleshoot skill স্বয়ংক্রিয়ভাবে নির্ণয় করবে এবং সমাধান প্রদান করবে। @@ -250,7 +365,7 @@ Endless Mode এবং এটি কীভাবে চেষ্টা করব --- -## বাগ রিপোর্ট +## Bug Reports স্বয়ংক্রিয় জেনারেটর দিয়ে বিস্তৃত বাগ রিপোর্ট তৈরি করুন: @@ -259,7 +374,7 @@ cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report ``` -## অবদান +## Contributing অবদান স্বাগত জানাই! অনুগ্রহ করে: @@ -269,32 +384,47 @@ npm run bug-report 4. ডকুমেন্টেশন আপডেট করুন 5. একটি Pull Request জমা দিন +Claude-Mem তিনটি ব্র্যাঞ্চ থেকে শিপ হয়: `main` (স্টেবল), `core-dev`, এবং +`community-edge`। শুধুমাত্র `main` npm-এ প্রকাশিত হয়; বাকিগুলো সোর্স থেকে চালানো হয়। +কৌশল এবং লোকাল রান নির্দেশাবলীর জন্য [রিলিজ ব্র্যাঞ্চ](https://docs.claude-mem.ai/branches) দেখুন। + অবদান ওয়ার্কফ্লোর জন্য [ডেভেলপমেন্ট গাইড](https://docs.claude-mem.ai/development) দেখুন। --- ## License -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem-কে Apache License 2.0-এর অধীনে লাইসেন্স দেওয়া হয়েছে। -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +আমরা Apache-2.0 বেছে নিয়েছি কারণ টেকসই এজেন্টিক মেমরি ডেভেলপার টুল, লোকাল এজেন্ট, +MCP সার্ভার, এন্টারপ্রাইজ সিস্টেম, রোবোটিক্স স্ট্যাক এবং প্রোডাকশন এজেন্ট হার্নেসে +সহজে এমবেড করা উচিত। -See the [LICENSE](LICENSE) file for full details. +সম্পূর্ণ বিবরণের জন্য [LICENSE](LICENSE) ফাইল দেখুন। লাইসেন্সিং স্কোপ এবং +ওপেন/কমার্শিয়াল সীমারেখার জন্য [docs/license.md](docs/license.md) +এবং [docs/ip-boundary.md](docs/ip-boundary.md) দেখুন। -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtime সম্পর্কে উল্লেখ্য**: `ragtime/` ডিরেক্টরি **Apache License 2.0**-এর অধীনে লাইসেন্সপ্রাপ্ত। বিস্তারিত জানতে [ragtime/LICENSE](ragtime/LICENSE) দেখুন। --- - -## সাপোর্ট +## Support - **ডকুমেন্টেশন**: [docs/](docs/) - **ইস্যু**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **রিপোজিটরি**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **অফিসিয়াল X অ্যাকাউন্ট**: [@Claude_Memory](https://x.com/Claude_Memory) +- **অফিসিয়াল Discord**: [Discord-এ যোগ দিন](https://discord.com/invite/J4wttp9vDu) - **লেখক**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Claude Agent SDK দিয়ে নির্মিত** | **Claude Code দ্বারা চালিত** | **TypeScript দিয়ে তৈরি** \ No newline at end of file +**Claude Agent SDK দিয়ে নির্মিত** | **Claude Code-এর সাথে কাজ করে** | **TypeScript দিয়ে তৈরি** + +--- + +### CMEM সম্পর্কে কী? + +CMEM হলো একটি তৃতীয় পক্ষ কর্তৃক তৈরি টোকেন, যা Claude-Mem-এর নির্মাতা (Alex Newman, @thedotmack) কর্তৃক আনুষ্ঠানিকভাবে গ্রহণ করা হয়েছে। এই টোকেনটি বৃদ্ধির জন্য একটি সম্প্রদায় অনুঘটক হিসেবে এবং যে ডেভেলপার ও নলেজ ওয়ার্কারদের এটি সবচেয়ে বেশি প্রয়োজন তাদের কাছে CMEM পৌঁছে দেওয়ার একটি মাধ্যম হিসেবে কাজ করে। + +অফিসিয়াল BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.cs.md b/docs/i18n/README.cs.md index 3cd6d6cdd..a1d8c7668 100644 --- a/docs/i18n/README.cs.md +++ b/docs/i18n/README.cs.md @@ -1,6 +1,5 @@ 🌐 Toto je automatický překlad. Komunitní opravy jsou vítány! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Systém trvalé komprese paměti vytvořený pro Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Rychlý start • @@ -94,35 +125,64 @@

- Claude-Mem bezproblémově zachovává kontext napříč sezeními tím, že automaticky zaznamenává pozorování použití nástrojů, generuje sémantické souhrny a zpřístupňuje je budoucím sezením. To umožňuje Claude udržovat kontinuitu znalostí o projektech i po ukončení nebo opětovném připojení sezení. + Claude-Mem bezproblémově zachovává kontext napříč sezeními tím, že automaticky zaznamenává pozorování použití nástrojů, generuje sémantické souhrny a zpřístupňuje je budoucím sezením. To Claude umožňuje udržovat kontinuitu znalostí o projektech i po ukončení sezení nebo jeho opětovném navázání.

--- ## Rychlý start -Spusťte nové sezení Claude Code v terminálu a zadejte následující příkazy: +Nainstalujte jedním příkazem: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Nebo instalace pro OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Nebo instalace pro Antigravity CLI ([návod k nastavení](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Nebo instalace z tržiště pluginů uvnitř Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví v nových sezeních. +> **Poznámka:** Claude-Mem je také publikován na npm, ale `npm install -g claude-mem` nainstaluje **pouze SDK/knihovnu** — neregistruje háčky pluginu ani nenastaví worker službu. Vždy instalujte pomocí `npx claude-mem install` nebo výše uvedených příkazů `/plugin`. + +### 🦞 OpenClaw Gateway + +Nainstalujte claude-mem jako plugin trvalé paměti na gateway [OpenClaw](https://openclaw.ai) jediným příkazem: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Instalátor se stará o závislosti, nastavení pluginu, konfiguraci AI poskytovatele, spuštění workeru a volitelné feedy pozorování v reálném čase do Telegramu, Discordu, Slacku a dalších. Podrobnosti najdete v [Průvodci integrací OpenClaw](https://docs.claude-mem.ai/openclaw-integration). + **Klíčové vlastnosti:** - 🧠 **Trvalá paměť** - Kontext přetrvává napříč sezeními - 📊 **Postupné odhalování** - Vrstvené vyhledávání paměti s viditelností nákladů na tokeny - 🔍 **Vyhledávání založené na dovednostech** - Dotazujte se na historii projektu pomocí dovednosti mem-search -- 🖥️ **Webové uživatelské rozhraní** - Tok paměti v reálném čase na http://localhost:37777 +- 🖥️ **Webové uživatelské rozhraní** - Tok paměti v reálném čase na adrese URL workeru vypsané při spuštění - 💻 **Dovednost pro Claude Desktop** - Vyhledávejte v paměti z konverzací Claude Desktop - 🔒 **Kontrola soukromí** - Použijte značky `` k vyloučení citlivého obsahu z úložiště - ⚙️ **Konfigurace kontextu** - Jemně odstupňovaná kontrola nad tím, jaký kontext se vkládá - 🤖 **Automatický provoz** - Není vyžadován žádný manuální zásah -- 🔗 **Citace** - Odkazujte na minulá pozorování pomocí ID (přístup přes http://localhost:37777/api/observation/{id} nebo zobrazit vše ve webovém prohlížeči na http://localhost:37777) -- 🧪 **Beta kanál** - Vyzkoušejte experimentální funkce jako Endless Mode přepnutím verze +- 🔗 **Citace** - Odkazujte na minulá pozorování pomocí ID přes API workeru nebo zobrazte vše ve webovém prohlížeči --- @@ -135,7 +195,6 @@ Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví - **[Průvodce instalací](https://docs.claude-mem.ai/installation)** - Rychlý start a pokročilá instalace - **[Průvodce použitím](https://docs.claude-mem.ai/usage/getting-started)** - Jak Claude-Mem funguje automaticky - **[Vyhledávací nástroje](https://docs.claude-mem.ai/usage/search-tools)** - Dotazujte se na historii projektu pomocí přirozeného jazyka -- **[Beta funkce](https://docs.claude-mem.ai/beta-features)** - Vyzkoušejte experimentální funkce jako Endless Mode ### Osvědčené postupy @@ -156,6 +215,7 @@ Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví - **[Konfigurace](https://docs.claude-mem.ai/configuration)** - Proměnné prostředí a nastavení - **[Vývoj](https://docs.claude-mem.ai/development)** - Sestavení, testování, přispívání +- **[Vydávací větve](https://docs.claude-mem.ai/branches)** - Tok větví stable, core-dev a community-edge - **[Řešení problémů](https://docs.claude-mem.ai/troubleshooting)** - Běžné problémy a řešení --- @@ -166,7 +226,7 @@ Restartujte Claude Code. Kontext z předchozích sezení se automaticky objeví 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook skriptů) 2. **Chytrá instalace** - Kontrola cachovaných závislostí (pre-hook skript, ne lifecycle hook) -3. **Worker Service** - HTTP API na portu 37777 s webovým prohlížečem a 10 vyhledávacími endpointy, spravováno pomocí Bun +3. **Worker Service** - Lokální HTTP API s webovým prohlížečem a vyhledávacími endpointy, spravováno pomocí Bun 4. **SQLite databáze** - Ukládá sezení, pozorování, souhrny 5. **mem-search dovednost** - Dotazy v přirozeném jazyce s postupným odhalováním 6. **Chroma vektorová databáze** - Hybridní sémantické + klíčové vyhledávání pro inteligentní vyhledávání kontextu @@ -175,46 +235,51 @@ Podrobnosti najdete v [Přehledu architektury](https://docs.claude-mem.ai/archit --- -## Dovednost mem-search +## Vyhledávací nástroje MCP -Claude-Mem poskytuje inteligentní vyhledávání prostřednictvím dovednosti mem-search, která se automaticky vyvolá, když se ptáte na minulou práci: +Claude-Mem poskytuje inteligentní vyhledávání v paměti prostřednictvím **4 nástrojů MCP** podle vzoru **3vrstvého pracovního postupu** šetřícího tokeny: + +**3vrstvý pracovní postup:** + +1. **`search`** - Získání kompaktního indexu s ID (~50-100 tokenů/výsledek) +2. **`timeline`** - Získání chronologického kontextu kolem zajímavých výsledků +3. **`get_observations`** - Získání úplných podrobností POUZE pro vyfiltrovaná ID (~500-1 000 tokenů/výsledek) **Jak to funguje:** -- Stačí se zeptat přirozeně: *"Co jsme dělali minulé sezení?"* nebo *"Opravovali jsme tuto chybu dříve?"* -- Claude automaticky vyvolá dovednost mem-search k nalezení relevantního kontextu +- Claude používá nástroje MCP k vyhledávání ve vaší paměti +- Začněte s `search`, abyste získali index výsledků +- Použijte `timeline` k zobrazení toho, co se dělo kolem konkrétních pozorování +- Použijte `get_observations` k získání úplných podrobností pro relevantní ID +- **Úspora tokenů až ~10x** díky filtrování před získáváním podrobností -**Dostupné vyhledávací operace:** +**Dostupné nástroje MCP:** -1. **Search Observations** - Fulltextové vyhledávání napříč pozorováními -2. **Search Sessions** - Fulltextové vyhledávání napříč souhrny sezení -3. **Search Prompts** - Vyhledávání surových požadavků uživatelů -4. **By Concept** - Hledání podle koncepčních značek (discovery, problem-solution, pattern, atd.) -5. **By File** - Hledání pozorování odkazujících na konkrétní soubory -6. **By Type** - Hledání podle typu (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Získání nedávného kontextu sezení pro projekt -8. **Timeline** - Získání jednotné časové osy kontextu kolem konkrétního bodu v čase -9. **Timeline by Query** - Vyhledávání pozorování a získání kontextu časové osy kolem nejlepší shody -10. **API Help** - Získání dokumentace k vyhledávacímu API +1. **`search`** - Vyhledávání v indexu paměti pomocí fulltextových dotazů, filtrování podle typu/data/projektu +2. **`timeline`** - Získání chronologického kontextu kolem konkrétního pozorování nebo dotazu +3. **`get_observations`** - Získání úplných podrobností pozorování podle ID (vždy dávkově s více ID) -**Příklady dotazů v přirozeném jazyce:** +**Příklad použití:** -``` -"Jaké chyby jsme opravili minulé sezení?" -"Jak jsme implementovali autentizaci?" -"Jaké změny byly provedeny v worker-service.ts?" -"Ukaž mi nedávnou práci na tomto projektu" -"Co se dělo, když jsme přidávali viewer UI?" +```typescript +// Krok 1: Vyhledání indexu +search(query="authentication bug", type="bugfix", limit=10) + +// Krok 2: Prohlédnutí indexu, identifikace relevantních ID (např. #123, #456) + +// Krok 3: Získání úplných podrobností +get_observations(ids=[123, 456]) ``` Podrobné příklady najdete v [Průvodci vyhledávacími nástroji](https://docs.claude-mem.ai/usage/search-tools). --- -## Beta funkce +## Vydávací větve -Claude-Mem nabízí **beta kanál** s experimentálními funkcemi jako **Endless Mode** (biomimetická architektura paměti pro prodloužená sezení). Přepínejte mezi stabilní a beta verzí z webového rozhraní na http://localhost:37777 → Settings. - -Podrobnosti o Endless Mode a jak jej vyzkoušet najdete v **[Dokumentaci beta funkcí](https://docs.claude-mem.ai/beta-features)**. +Stabilní vydání jsou publikována z větve `main` a zveřejněna na npm. `core-dev` a +`community-edge` jsou větve spouštěné ze zdrojového kódu určené pro včasné opravy +spolehlivosti a komunitní integrace. Podrobnosti o toku větví a pokyny ke spuštění +nestabilních verzí najdete v **[Vydávacích větvích](https://docs.claude-mem.ai/branches)**. --- @@ -226,6 +291,17 @@ Podrobnosti o Endless Mode a jak jej vyzkoušet najdete v **[Dokumentaci beta fu - **uv**: Python správce balíčků pro vektorové vyhledávání (automaticky nainstalován, pokud chybí) - **SQLite 3**: Pro trvalé úložiště (součástí balíčku) +--- +### Poznámky k nastavení pro Windows + +Pokud se zobrazí chyba jako: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Ujistěte se, že Node.js a npm jsou nainstalované a přidané do vaší proměnné PATH. Stáhněte nejnovější instalátor Node.js z https://nodejs.org a po instalaci restartujte terminál. + --- ## Konfigurace @@ -234,6 +310,45 @@ Nastavení jsou spravována v `~/.claude-mem/settings.json` (automaticky vytvoř Všechna dostupná nastavení a příklady najdete v **[Průvodci konfigurací](https://docs.claude-mem.ai/configuration)**. +### Konfigurace režimu a jazyka + +Claude-Mem podporuje více pracovních režimů a jazyků prostřednictvím nastavení `CLAUDE_MEM_MODE`. + +Tato volba ovládá jak: +- Chování pracovního postupu (např. code, chill, investigation) +- Jazyk používaný ve vygenerovaných pozorováních + +#### Jak nakonfigurovat + +Upravte svůj soubor nastavení v `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Režimy jsou definovány v `plugin/modes/`. Chcete-li zobrazit všechny dostupné režimy lokálně: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Dostupné režimy + +| Režim | Popis | +|------------|-------------------------| +| `code` | Výchozí anglický režim | +| `code--zh` | Zjednodušená čínština | +| `code--ja` | Japonština | + +Jazykově specifické režimy se řídí vzorem `code--[lang]`, kde `[lang]` je kód jazyka podle ISO 639-1 (např. `zh` pro čínštinu, `ja` pro japonštinu, `es` pro španělštinu). + +> Poznámka: `code--zh` (zjednodušená čínština) je již vestavěn — není potřeba žádná další instalace ani aktualizace pluginu. + +#### Po změně režimu + +Restartujte Claude Code, aby se použila nová konfigurace režimu. --- ## Vývoj @@ -269,34 +384,48 @@ Příspěvky jsou vítány! Prosím: 4. Aktualizujte dokumentaci 5. Odešlete Pull Request +Claude-Mem je vydáván ze tří větví: `main` (stabilní), `core-dev` a +`community-edge`. Na npm je publikována pouze `main`; ostatní se spouštějí ze +zdrojového kódu. Podrobnosti o strategii a pokyny ke spuštění lokálně najdete +ve [Vydávacích větvích](https://docs.claude-mem.ai/branches). + Pracovní postup pro přispívání najdete v [Průvodci vývojem](https://docs.claude-mem.ai/development). --- -## License +## Licence -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem je licencován pod licencí Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Zvolili jsme Apache-2.0, protože trvalá agentní paměť by měla být snadno +vložitelná do vývojářských nástrojů, lokálních agentů, MCP serverů, podnikových +systémů, robotických stacků a produkčních harnessů pro agenty. -See the [LICENSE](LICENSE) file for full details. +Úplné podrobnosti najdete v souboru [LICENSE](LICENSE). Viz [docs/license.md](docs/license.md) +a [docs/ip-boundary.md](docs/ip-boundary.md) pro rozsah licencování a hranici +mezi open source a komerčním využitím. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Poznámka k Ragtime**: Adresář `ragtime/` je licencován pod licencí **Apache License 2.0**. Podrobnosti najdete v [ragtime/LICENSE](ragtime/LICENSE). --- - ## Podpora - **Dokumentace**: [docs/](docs/) - **Problémy**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repositář**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Oficiální účet X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Oficiální Discord**: [Připojit se k Discordu](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Vytvořeno pomocí Claude Agent SDK** | **Poháněno Claude Code** | **Vyrobeno s TypeScript** +**Vytvořeno pomocí Claude Agent SDK** | **Funguje s Claude Code** | **Vyrobeno s TypeScript** ---- \ No newline at end of file +--- + +### Co je to CMEM? + +CMEM je token vytvořený třetí stranou, ale oficiálně přijatý tvůrcem Claude-Mem (Alex Newman, @thedotmack). Token funguje jako komunitní katalyzátor růstu a prostředek, jak přiblížit CMEM vývojářům a znalostním pracovníkům, kteří ho nejvíce potřebují. + +Oficiální BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.da.md b/docs/i18n/README.da.md index 61006de2d..c3617e5bf 100644 --- a/docs/i18n/README.da.md +++ b/docs/i18n/README.da.md @@ -1,6 +1,5 @@ 🌐 Dette er en automatisk oversættelse. Fællesskabsrettelser er velkomne! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

Vedvarende hukommelseskomprimeringsystem bygget til Claude Code.

+

Vedvarende hukommelseskomprimeringssystem bygget til Claude Code.

- License + License Version @@ -75,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Hurtig Start • Sådan Virker Det • - Søgeværktøjer • + Søgeværktøjer • Dokumentation • Konfiguration • Fejlfinding • @@ -101,28 +132,57 @@ ## Hurtig Start -Start en ny Claude Code-session i terminalen og indtast følgende kommandoer: +Installer med en enkelt kommando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Eller installer til OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Eller installer til Antigravity CLI ([opsætningsguide](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Eller installer fra plugin-markedspladsen inde i Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Genstart Claude Code. Kontekst fra tidligere sessioner vil automatisk vises i nye sessioner. +> **Bemærk:** Claude-Mem er også udgivet på npm, men `npm install -g claude-mem` installerer kun **SDK'et/biblioteket** — det registrerer ikke plugin-hooks eller opsætter worker-servicen. Installer altid via `npx claude-mem install` eller `/plugin`-kommandoerne ovenfor. + +### 🦞 OpenClaw Gateway + +Installer claude-mem som et vedvarende hukommelsesplugin på [OpenClaw](https://openclaw.ai)-gateways med en enkelt kommando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Installationsprogrammet håndterer afhængigheder, plugin-opsætning, konfiguration af AI-udbyder, worker-opstart og valgfrie realtidsobservationsfeeds til Telegram, Discord, Slack og mere. Se [OpenClaw-integrationsguiden](https://docs.claude-mem.ai/openclaw-integration) for detaljer. + **Nøglefunktioner:** - 🧠 **Vedvarende Hukommelse** - Kontekst overlever på tværs af sessioner - 📊 **Progressiv Afsløring** - Lagdelt hukommelseshentning med synlighed af token-omkostninger - 🔍 **Færdighedsbaseret Søgning** - Forespørg din projekthistorik med mem-search-færdighed -- 🖥️ **Web Viewer UI** - Realtids hukommelsesstream på http://localhost:37777 +- 🖥️ **Web Viewer UI** - Realtids hukommelsesstream på den worker-URL, der udskrives ved opstart - 💻 **Claude Desktop-færdighed** - Søg i hukommelsen fra Claude Desktop-samtaler - 🔒 **Privatkontrol** - Brug ``-tags til at ekskludere følsomt indhold fra lagring - ⚙️ **Kontekstkonfiguration** - Finjusteret kontrol over hvilken kontekst der indsprøjtes - 🤖 **Automatisk Drift** - Ingen manuel indgriben påkrævet -- 🔗 **Citationer** - Henvisning til tidligere observationer med ID'er (tilgås via http://localhost:37777/api/observation/{id} eller se alle i web viewer på http://localhost:37777) -- 🧪 **Beta-kanal** - Prøv eksperimentelle funktioner som Endless Mode via versionsskift +- 🔗 **Citationer** - Henvis til tidligere observationer med ID'er via worker-API'et eller se dem alle i web viewer --- @@ -135,7 +195,6 @@ Genstart Claude Code. Kontekst fra tidligere sessioner vil automatisk vises i ny - **[Installationsguide](https://docs.claude-mem.ai/installation)** - Hurtig start & avanceret installation - **[Brugervejledning](https://docs.claude-mem.ai/usage/getting-started)** - Sådan fungerer Claude-Mem automatisk - **[Søgeværktøjer](https://docs.claude-mem.ai/usage/search-tools)** - Forespørg din projekthistorik med naturligt sprog -- **[Beta-funktioner](https://docs.claude-mem.ai/beta-features)** - Prøv eksperimentelle funktioner som Endless Mode ### Bedste Praksis @@ -156,6 +215,7 @@ Genstart Claude Code. Kontekst fra tidligere sessioner vil automatisk vises i ny - **[Konfiguration](https://docs.claude-mem.ai/configuration)** - Miljøvariabler & indstillinger - **[Udvikling](https://docs.claude-mem.ai/development)** - Bygning, testning, bidrag +- **[Release-grene](https://docs.claude-mem.ai/branches)** - Flowet for stable, core-dev og community-edge-grene - **[Fejlfinding](https://docs.claude-mem.ai/troubleshooting)** - Almindelige problemer & løsninger --- @@ -165,8 +225,8 @@ Genstart Claude Code. Kontekst fra tidligere sessioner vil automatisk vises i ny **Kernekomponenter:** 1. **5 Livscyklus-hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-scripts) -2. **Smart Installation** - Cached dependency checker (pre-hook script, ikke en livscyklus-hook) -3. **Worker Service** - HTTP API på port 37777 med web viewer UI og 10 søge-endpoints, administreret af Bun +2. **Smart Installation** - Cached dependency checker (pre-hook-script, ikke en livscyklus-hook) +3. **Worker Service** - Lokalt HTTP API med web viewer UI og søge-endpoints, administreret af Bun 4. **SQLite Database** - Gemmer sessioner, observationer, resuméer 5. **mem-search-færdighed** - Naturlige sprogforespørgsler med progressiv afsløring 6. **Chroma Vector Database** - Hybrid semantisk + søgeordssøgning for intelligent konteksthentning @@ -175,46 +235,51 @@ Se [Arkitekturoversigt](https://docs.claude-mem.ai/architecture/overview) for de --- -## mem-search-færdighed +## MCP Søgeværktøjer -Claude-Mem leverer intelligent søgning gennem mem-search-færdigheden, der automatisk aktiveres, når du spørger om tidligere arbejde: +Claude-Mem leverer intelligent hukommelsessøgning gennem **4 MCP-værktøjer**, der følger et token-effektivt **3-lags workflowmønster**: + +**De 3 Workflowlag:** + +1. **`search`** - Få et kompakt indeks med ID'er (~50-100 tokens/resultat) +2. **`timeline`** - Få kronologisk kontekst omkring interessante resultater +3. **`get_observations`** - Hent fulde detaljer KUN for filtrerede ID'er (~500-1.000 tokens/resultat) **Sådan Virker Det:** -- Spørg bare naturligt: *"Hvad lavede vi sidste session?"* eller *"Har vi løst denne fejl før?"* -- Claude aktiverer automatisk mem-search-færdigheden for at finde relevant kontekst +- Claude bruger MCP-værktøjer til at søge i din hukommelse +- Start med `search` for at få et indeks over resultater +- Brug `timeline` til at se, hvad der skete omkring specifikke observationer +- Brug `get_observations` til at hente fulde detaljer for relevante ID'er +- **~10x besparelse i tokens** ved at filtrere før detaljer hentes -**Tilgængelige Søgeoperationer:** +**Tilgængelige MCP-værktøjer:** -1. **Search Observations** - Fuldtekstsøgning på tværs af observationer -2. **Search Sessions** - Fuldtekstsøgning på tværs af sessionsresumeer -3. **Search Prompts** - Søg i rå brugeranmodninger -4. **By Concept** - Find efter koncept-tags (discovery, problem-solution, pattern, osv.) -5. **By File** - Find observationer, der refererer til specifikke filer -6. **By Type** - Find efter type (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Få nylig sessionskontekst for et projekt -8. **Timeline** - Få samlet tidslinje af kontekst omkring et specifikt tidspunkt -9. **Timeline by Query** - Søg efter observationer og få tidslinjekontekst omkring bedste match -10. **API Help** - Få søge-API-dokumentation +1. **`search`** - Søg i hukommelsesindekset med fuldtekstforespørgsler, filtrer efter type/dato/projekt +2. **`timeline`** - Få kronologisk kontekst omkring en specifik observation eller forespørgsel +3. **`get_observations`** - Hent fulde observationsdetaljer efter ID'er (batch altid flere ID'er sammen) -**Eksempler på Naturlige Sprogforespørgsler:** +**Eksempel på Brug:** -``` -"Hvilke fejl løste vi sidste session?" -"Hvordan implementerede vi autentificering?" -"Hvilke ændringer blev lavet i worker-service.ts?" -"Vis mig det seneste arbejde på dette projekt" -"Hvad skete der, da vi tilføjede viewer UI?" +```typescript +// Trin 1: Søg efter indeks +search(query="authentication bug", type="bugfix", limit=10) + +// Trin 2: Gennemgå indekset, identificer relevante ID'er (f.eks. #123, #456) + +// Trin 3: Hent fulde detaljer +get_observations(ids=[123, 456]) ``` Se [Søgeværktøjsguide](https://docs.claude-mem.ai/usage/search-tools) for detaljerede eksempler. --- -## Beta-funktioner +## Release-grene -Claude-Mem tilbyder en **beta-kanal** med eksperimentelle funktioner som **Endless Mode** (biomimetisk hukommelsesarkitektur til udvidede sessioner). Skift mellem stabile og beta-versioner fra web viewer UI på http://localhost:37777 → Settings. - -Se **[Beta-funktionsdokumentation](https://docs.claude-mem.ai/beta-features)** for detaljer om Endless Mode og hvordan du prøver det. +Stable releases udsendes fra `main` og publiceres til npm. `core-dev` og +`community-edge` er kildekørte grene til tidlige pålidelighedsrettelser og +community-integrationer. Se **[Release-grene](https://docs.claude-mem.ai/branches)** +for grenflowet og instruktioner til kørsel af ikke-stabile versioner. --- @@ -226,6 +291,17 @@ Se **[Beta-funktionsdokumentation](https://docs.claude-mem.ai/beta-features)** f - **uv**: Python package manager til vektorsøgning (auto-installeres, hvis manglende) - **SQLite 3**: Til vedvarende lagring (bundtet) +--- +### Windows-opsætningsnoter + +Hvis du ser en fejl som: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Sørg for, at Node.js og npm er installeret og tilføjet til din PATH. Download den nyeste Node.js-installer fra https://nodejs.org og genstart din terminal efter installationen. + --- ## Konfiguration @@ -234,6 +310,45 @@ Indstillinger administreres i `~/.claude-mem/settings.json` (auto-oprettet med s Se **[Konfigurationsguide](https://docs.claude-mem.ai/configuration)** for alle tilgængelige indstillinger og eksempler. +### Tilstands- & Sprogkonfiguration + +Claude-Mem understøtter flere workflow-tilstande og sprog via indstillingen `CLAUDE_MEM_MODE`. + +Denne indstilling styrer både: +- Workflow-adfærden (f.eks. code, chill, investigation) +- Sproget, der bruges i genererede observationer + +#### Sådan Konfigurerer Du + +Rediger din indstillingsfil på `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Tilstande er defineret i `plugin/modes/`. For at se alle tilgængelige tilstande lokalt: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Tilgængelige Tilstande + +| Tilstand | Beskrivelse | +|------------|-------------------------| +| `code` | Standard engelsk tilstand | +| `code--zh` | Forenklet kinesisk tilstand | +| `code--ja` | Japansk tilstand | + +Sprogspecifikke tilstande følger mønsteret `code--[lang]`, hvor `[lang]` er ISO 639-1-sprogkoden (f.eks. `zh` for kinesisk, `ja` for japansk, `es` for spansk). + +> Bemærk: `code--zh` (forenklet kinesisk) er allerede indbygget — der kræves ingen yderligere installation eller plugin-opdatering. + +#### Efter Ændring af Tilstand + +Genstart Claude Code for at anvende den nye tilstandskonfiguration. --- ## Udvikling @@ -269,32 +384,48 @@ Bidrag er velkomne! Venligst: 4. Opdater dokumentation 5. Indsend en Pull Request +Claude-Mem udsendes fra tre grene: `main` (stable), `core-dev` og +`community-edge`. Kun `main` publiceres til npm; de andre køres fra +kildekode. Se [Release-grene](https://docs.claude-mem.ai/branches) for +strategien og instruktioner til lokal kørsel. + Se [Udviklingsguide](https://docs.claude-mem.ai/development) for bidragsworkflow. --- -## License +## Licens -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem er licenseret under Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Vi valgte Apache-2.0, fordi holdbar agentisk hukommelse bør være nem at indlejre i +udviklerværktøjer, lokale agenter, MCP-servere, virksomhedssystemer, robotik-stacks +og produktionsagent-harnesser. -See the [LICENSE](LICENSE) file for full details. +Se filen [LICENSE](LICENSE) for fulde detaljer. Se [docs/license.md](docs/license.md) +og [docs/ip-boundary.md](docs/ip-boundary.md) for licensomfang og +grænsen mellem open source og kommercielt. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Bemærkning om Ragtime**: Mappen `ragtime/` er licenseret under **Apache License 2.0**. Se [ragtime/LICENSE](ragtime/LICENSE) for detaljer. --- - ## Support - **Dokumentation**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Officiel X-konto**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Officiel Discord**: [Deltag i Discord](https://discord.com/invite/J4wttp9vDu) - **Forfatter**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Bygget med Claude Agent SDK** | **Drevet af Claude Code** | **Lavet med TypeScript** \ No newline at end of file +**Bygget med Claude Agent SDK** | **Fungerer med Claude Code** | **Lavet med TypeScript** + +--- + +### Hvad Med CMEM? + +CMEM er en token skabt af en tredjepart, men officielt anerkendt af skaberen af Claude-Mem (Alex Newman, @thedotmack). Tokenet fungerer som en katalysator for fællesskabsvækst og et redskab til at bringe CMEM til de udviklere og videnarbejdere, der har mest brug for det. + +Officiel BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md index 6d4b9fc2a..73e70be54 100644 --- a/docs/i18n/README.de.md +++ b/docs/i18n/README.de.md @@ -1,6 +1,5 @@ 🌐 Dies ist eine automatisierte Übersetzung. Korrekturen aus der Community sind willkommen! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

Persistentes Speicherkomprimierungssystem entwickelt für Claude Code.

+

Persistentes Speicherkomprimierungssystem, entwickelt für Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Schnellstart • @@ -101,28 +132,57 @@ ## Schnellstart -Starten Sie eine neue Claude Code-Sitzung im Terminal und geben Sie die folgenden Befehle ein: +Installation mit einem einzigen Befehl: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Oder Installation für OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Oder Installation für Antigravity CLI ([Einrichtungsanleitung](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Oder Installation über den Plugin-Marketplace innerhalb von Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch in neuen Sitzungen angezeigt. +> **Hinweis:** Claude-Mem ist auch auf npm veröffentlicht, aber `npm install -g claude-mem` installiert **nur das SDK/die Bibliothek** — es registriert weder die Plugin-Hooks noch richtet es den Worker-Dienst ein. Installieren Sie immer über `npx claude-mem install` oder die oben genannten `/plugin`-Befehle. + +### 🦞 OpenClaw Gateway + +Installieren Sie claude-mem als persistentes Speicher-Plugin auf [OpenClaw](https://openclaw.ai)-Gateways mit einem einzigen Befehl: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Der Installer übernimmt Abhängigkeiten, Plugin-Einrichtung, KI-Anbieter-Konfiguration, Worker-Start und optionale Echtzeit-Beobachtungs-Feeds zu Telegram, Discord, Slack und mehr. Details finden Sie im [OpenClaw-Integrationsleitfaden](https://docs.claude-mem.ai/openclaw-integration). + **Hauptmerkmale:** - 🧠 **Persistenter Speicher** - Kontext bleibt über Sitzungen hinweg erhalten -- 📊 **Progressive Offenlegung** - Schichtweise Speicherabruf mit Sichtbarkeit der Token-Kosten +- 📊 **Progressive Offenlegung** - Schichtweiser Speicherabruf mit Sichtbarkeit der Token-Kosten - 🔍 **Skill-basierte Suche** - Durchsuchen Sie Ihre Projekthistorie mit dem mem-search Skill -- 🖥️ **Web-Viewer-UI** - Echtzeit-Speicherstream unter http://localhost:37777 +- 🖥️ **Web-Viewer-UI** - Echtzeit-Speicherstream unter der beim Start ausgegebenen Worker-URL - 💻 **Claude Desktop Skill** - Durchsuchen Sie den Speicher aus Claude Desktop-Konversationen - 🔒 **Datenschutzkontrolle** - Verwenden Sie ``-Tags, um sensible Inhalte von der Speicherung auszuschließen - ⚙️ **Kontextkonfiguration** - Feinkörnige Kontrolle darüber, welcher Kontext eingefügt wird - 🤖 **Automatischer Betrieb** - Keine manuelle Intervention erforderlich -- 🔗 **Zitate** - Referenzieren Sie vergangene Beobachtungen mit IDs (Zugriff über http://localhost:37777/api/observation/{id} oder alle im Web-Viewer unter http://localhost:37777 anzeigen) -- 🧪 **Beta-Kanal** - Probieren Sie experimentelle Funktionen wie den Endless Mode durch Versionswechsel aus +- 🔗 **Zitate** - Referenzieren Sie vergangene Beobachtungen mit IDs über die Worker-API oder sehen Sie alle im Web-Viewer --- @@ -135,7 +195,6 @@ Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch i - **[Installationsanleitung](https://docs.claude-mem.ai/installation)** - Schnellstart & erweiterte Installation - **[Nutzungsanleitung](https://docs.claude-mem.ai/usage/getting-started)** - Wie Claude-Mem automatisch funktioniert - **[Suchwerkzeuge](https://docs.claude-mem.ai/usage/search-tools)** - Durchsuchen Sie Ihre Projekthistorie mit natürlicher Sprache -- **[Beta-Funktionen](https://docs.claude-mem.ai/beta-features)** - Probieren Sie experimentelle Funktionen wie den Endless Mode ### Best Practices @@ -156,6 +215,7 @@ Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch i - **[Konfiguration](https://docs.claude-mem.ai/configuration)** - Umgebungsvariablen & Einstellungen - **[Entwicklung](https://docs.claude-mem.ai/development)** - Erstellen, Testen, Beitragen +- **[Release-Branches](https://docs.claude-mem.ai/branches)** - Ablauf der Branches Stable, core-dev und community-edge - **[Fehlerbehebung](https://docs.claude-mem.ai/troubleshooting)** - Häufige Probleme & Lösungen --- @@ -166,7 +226,7 @@ Starten Sie Claude Code neu. Kontext aus vorherigen Sitzungen wird automatisch i 1. **5 Lifecycle-Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 Hook-Skripte) 2. **Smart Install** - Gecachter Abhängigkeitsprüfer (Pre-Hook-Skript, kein Lifecycle-Hook) -3. **Worker Service** - HTTP API auf Port 37777 mit Web-Viewer-UI und 10 Such-Endpunkten, verwaltet von Bun +3. **Worker Service** - Lokale HTTP-API mit Web-Viewer-UI und Such-Endpunkten, verwaltet von Bun 4. **SQLite-Datenbank** - Speichert Sitzungen, Beobachtungen, Zusammenfassungen 5. **mem-search Skill** - Natürlichsprachliche Abfragen mit progressiver Offenlegung 6. **Chroma-Vektordatenbank** - Hybride semantische + Stichwortsuche für intelligenten Kontextabruf @@ -175,46 +235,51 @@ Siehe [Architekturübersicht](https://docs.claude-mem.ai/architecture/overview) --- -## mem-search Skill +## MCP-Suchwerkzeuge -Claude-Mem bietet intelligente Suche durch den mem-search Skill, der sich automatisch aktiviert, wenn Sie nach früheren Arbeiten fragen: +Claude-Mem bietet intelligente Speichersuche durch **4 MCP-Tools** nach einem token-effizienten **3-Schichten-Workflow-Muster**: -**Wie es funktioniert:** -- Fragen Sie einfach natürlich: *"Was haben wir in der letzten Sitzung gemacht?"* oder *"Haben wir diesen Fehler schon einmal behoben?"* -- Claude aktiviert automatisch den mem-search Skill, um relevanten Kontext zu finden +**Der 3-Schichten-Workflow:** -**Verfügbare Suchoperationen:** +1. **`search`** - Kompakten Index mit IDs abrufen (~50-100 Token/Ergebnis) +2. **`timeline`** - Chronologischen Kontext um interessante Ergebnisse herum abrufen +3. **`get_observations`** - Vollständige Details NUR für gefilterte IDs abrufen (~500-1.000 Token/Ergebnis) -1. **Search Observations** - Volltextsuche über Beobachtungen -2. **Search Sessions** - Volltextsuche über Sitzungszusammenfassungen -3. **Search Prompts** - Durchsuchen von rohen Benutzeranfragen -4. **By Concept** - Suche nach Konzept-Tags (discovery, problem-solution, pattern, etc.) -5. **By File** - Beobachtungen finden, die bestimmte Dateien referenzieren -6. **By Type** - Suche nach Typ (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Aktuellen Sitzungskontext für ein Projekt abrufen -8. **Timeline** - Einheitliche Zeitachse des Kontexts um einen bestimmten Zeitpunkt herum abrufen -9. **Timeline by Query** - Nach Beobachtungen suchen und Zeitachsenkontext um die beste Übereinstimmung herum abrufen -10. **API Help** - Such-API-Dokumentation abrufen +**Funktionsweise:** +- Claude nutzt MCP-Tools, um Ihren Speicher zu durchsuchen +- Beginnen Sie mit `search`, um einen Index der Ergebnisse zu erhalten +- Verwenden Sie `timeline`, um zu sehen, was um bestimmte Beobachtungen herum geschah +- Verwenden Sie `get_observations`, um vollständige Details für relevante IDs abzurufen +- **~10-fache Token-Ersparnis** durch Filtern vor dem Abrufen der Details -**Beispiele für natürlichsprachliche Abfragen:** +**Verfügbare MCP-Tools:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +1. **`search`** - Speicherindex mit Volltextabfragen durchsuchen, gefiltert nach Typ/Datum/Projekt +2. **`timeline`** - Chronologischen Kontext um eine bestimmte Beobachtung oder Abfrage herum abrufen +3. **`get_observations`** - Vollständige Beobachtungsdetails anhand von IDs abrufen (immer mehrere IDs gebündelt abrufen) + +**Beispielverwendung:** + +```typescript +// Schritt 1: Nach Index suchen +search(query="authentication bug", type="bugfix", limit=10) + +// Schritt 2: Index überprüfen, relevante IDs identifizieren (z. B. #123, #456) + +// Schritt 3: Vollständige Details abrufen +get_observations(ids=[123, 456]) ``` Siehe [Suchwerkzeuge-Anleitung](https://docs.claude-mem.ai/usage/search-tools) für detaillierte Beispiele. --- -## Beta-Funktionen +## Release-Branches -Claude-Mem bietet einen **Beta-Kanal** mit experimentellen Funktionen wie **Endless Mode** (biomimetische Speicherarchitektur für erweiterte Sitzungen). Wechseln Sie zwischen stabilen und Beta-Versionen über die Web-Viewer-UI unter http://localhost:37777 → Settings. - -Siehe **[Beta-Funktionen-Dokumentation](https://docs.claude-mem.ai/beta-features)** für Details zum Endless Mode und wie Sie ihn ausprobieren können. +Stabile Releases werden von `main` ausgeliefert und auf npm veröffentlicht. `core-dev` und +`community-edge` sind aus dem Quellcode betriebene Branches für frühe Zuverlässigkeitskorrekturen und +Community-Integrationen. Siehe **[Release-Branches](https://docs.claude-mem.ai/branches)** +für den Branch-Ablauf und Anweisungen zum Ausführen der nicht-stabilen Versionen. --- @@ -226,6 +291,17 @@ Siehe **[Beta-Funktionen-Dokumentation](https://docs.claude-mem.ai/beta-features - **uv**: Python-Paketmanager für Vektorsuche (wird automatisch installiert, falls fehlend) - **SQLite 3**: Für persistente Speicherung (enthalten) +--- +### Hinweise zur Einrichtung unter Windows + +Wenn folgender Fehler angezeigt wird: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Stellen Sie sicher, dass Node.js und npm installiert und zu Ihrem PATH hinzugefügt wurden. Laden Sie den neuesten Node.js-Installer von https://nodejs.org herunter und starten Sie Ihr Terminal nach der Installation neu. + --- ## Konfiguration @@ -234,6 +310,45 @@ Einstellungen werden in `~/.claude-mem/settings.json` verwaltet (wird beim erste Siehe die **[Konfigurationsanleitung](https://docs.claude-mem.ai/configuration)** für alle verfügbaren Einstellungen und Beispiele. +### Modus- & Sprachkonfiguration + +Claude-Mem unterstützt mehrere Workflow-Modi und Sprachen über die Einstellung `CLAUDE_MEM_MODE`. + +Diese Option steuert sowohl: +- Das Workflow-Verhalten (z. B. code, chill, investigation) +- Die Sprache, die in generierten Beobachtungen verwendet wird + +#### Konfiguration + +Bearbeiten Sie Ihre Einstellungsdatei unter `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Modi sind in `plugin/modes/` definiert. Um alle lokal verfügbaren Modi anzuzeigen: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Verfügbare Modi + +| Modus | Beschreibung | +|------------|-------------------------| +| `code` | Standardmodus (Englisch) | +| `code--zh` | Modus für vereinfachtes Chinesisch | +| `code--ja` | Modus für Japanisch | + +Sprachspezifische Modi folgen dem Muster `code--[lang]`, wobei `[lang]` der ISO-639-1-Sprachcode ist (z. B. `zh` für Chinesisch, `ja` für Japanisch, `es` für Spanisch). + +> Hinweis: `code--zh` (vereinfachtes Chinesisch) ist bereits integriert — es ist keine zusätzliche Installation oder Plugin-Aktualisierung erforderlich. + +#### Nach der Änderung des Modus + +Starten Sie Claude Code neu, um die neue Moduskonfiguration anzuwenden. --- ## Entwicklung @@ -244,7 +359,7 @@ Siehe die **[Entwicklungsanleitung](https://docs.claude-mem.ai/development)** f ## Fehlerbehebung -Wenn Sie Probleme haben, beschreiben Sie das Problem Claude und der troubleshoot Skill wird automatisch diagnostizieren und Lösungen bereitstellen. +Wenn Sie Probleme haben, beschreiben Sie das Problem Claude, und der troubleshoot Skill wird automatisch diagnostizieren und Lösungen bereitstellen. Siehe die **[Fehlerbehebungsanleitung](https://docs.claude-mem.ai/troubleshooting)** für häufige Probleme und Lösungen. @@ -259,7 +374,7 @@ cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report ``` -## Beiträge +## Mitwirken Beiträge sind willkommen! Bitte: @@ -269,32 +384,48 @@ Beiträge sind willkommen! Bitte: 4. Aktualisieren Sie die Dokumentation 5. Reichen Sie einen Pull Request ein +Claude-Mem wird aus drei Branches ausgeliefert: `main` (stabil), `core-dev` und +`community-edge`. Nur `main` wird auf npm veröffentlicht; die anderen werden aus dem +Quellcode ausgeführt. Siehe [Release-Branches](https://docs.claude-mem.ai/branches) für die +Strategie und Anweisungen zur lokalen Ausführung. + Siehe [Entwicklungsanleitung](https://docs.claude-mem.ai/development) für den Beitrags-Workflow. --- -## License +## Lizenz -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem ist unter der Apache License 2.0 lizenziert. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Wir haben uns für Apache-2.0 entschieden, weil dauerhafter agentenbasierter Speicher leicht +in Entwicklertools, lokale Agenten, MCP-Server, Unternehmenssysteme, Robotik-Stacks +und produktive Agenten-Harnesses eingebettet werden können sollte. -See the [LICENSE](LICENSE) file for full details. +Siehe die Datei [LICENSE](LICENSE) für vollständige Details. Siehe [docs/license.md](docs/license.md) +und [docs/ip-boundary.md](docs/ip-boundary.md) für den Lizenzumfang und die +Grenze zwischen offen und kommerziell. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Hinweis zu Ragtime**: Das Verzeichnis `ragtime/` ist unter der **Apache License 2.0** lizenziert. Siehe [ragtime/LICENSE](ragtime/LICENSE) für Details. --- - ## Support - **Dokumentation**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Offizieller X-Account**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Offizieller Discord**: [Discord beitreten](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Erstellt mit Claude Agent SDK** | **Works with Claude Code** | **Made with TypeScript** \ No newline at end of file +**Erstellt mit Claude Agent SDK** | **Funktioniert mit Claude Code** | **Gemacht mit TypeScript** + +--- + +### Was ist mit CMEM? + +CMEM ist ein Token, der von einem Drittanbieter erstellt, aber offiziell vom Schöpfer von Claude-Mem (Alex Newman, @thedotmack) unterstützt wird. Der Token dient als Community-Katalysator für Wachstum und als Vehikel, um CMEM zu den Entwicklern und Wissensarbeitern zu bringen, die ihn am dringendsten benötigen. + +Offizielle BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.el.md b/docs/i18n/README.el.md index 07e267b3b..0ac2a616e 100644 --- a/docs/i18n/README.el.md +++ b/docs/i18n/README.el.md @@ -1,6 +1,5 @@ 🌐 Αυτή είναι μια αυτοματοποιημένη μετάφραση. Καλώς ορίζονται οι διορθώσεις από την κοινότητα! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Σύστημα συμπίεσης μόνιμης μνήμης κατασκευασμένο για το Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Γρήγορη Εκκίνηση • @@ -101,28 +132,57 @@ ## Γρήγορη Εκκίνηση -Ξεκινήστε μια νέα συνεδρία Claude Code στο τερματικό και εισάγετε τις ακόλουθες εντολές: +Εγκαταστήστε με μία μόνο εντολή: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Ή εγκαταστήστε για το OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Ή εγκαταστήστε για το Antigravity CLI ([οδηγός εγκατάστασης](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Ή εγκαταστήστε από το plugin marketplace μέσα στο Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Επανεκκινήστε το Claude Code. Το πλαίσιο από προηγούμενες συνεδρίες θα εμφανιστεί αυτόματα σε νέες συνεδρίες. +> **Σημείωση:** Το Claude-Mem δημοσιεύεται επίσης στο npm, αλλά το `npm install -g claude-mem` εγκαθιστά **μόνο το SDK/library** — δεν καταχωρεί τα plugin hooks ούτε ρυθμίζει την υπηρεσία worker. Πάντα να εγκαθιστάτε μέσω του `npx claude-mem install` ή των παραπάνω εντολών `/plugin`. + +### 🦞 OpenClaw Gateway + +Εγκαταστήστε το claude-mem ως plugin μόνιμης μνήμης σε gateways [OpenClaw](https://openclaw.ai) με μία μόνο εντολή: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Ο εγκαταστάτης διαχειρίζεται τις εξαρτήσεις, τη ρύθμιση του plugin, τη διαμόρφωση του πάροχου AI, την εκκίνηση του worker, καθώς και προαιρετικές ροές παρατηρήσεων σε πραγματικό χρόνο προς Telegram, Discord, Slack, και άλλα. Δείτε τον [Οδηγό Ενσωμάτωσης OpenClaw](https://docs.claude-mem.ai/openclaw-integration) για λεπτομέρειες. + **Βασικά Χαρακτηριστικά:** - 🧠 **Μόνιμη Μνήμη** - Το πλαίσιο διατηρείται μεταξύ συνεδριών - 📊 **Προοδευτική Αποκάλυψη** - Ανάκτηση μνήμης σε επίπεδα με ορατότητα κόστους tokens - 🔍 **Αναζήτηση Βασισμένη σε Δεξιότητες** - Ερωτήματα στο ιστορικό του έργου σας με τη δεξιότητα mem-search -- 🖥️ **Διεπαφή Web Viewer** - Ροή μνήμης σε πραγματικό χρόνο στο http://localhost:37777 +- 🖥️ **Διεπαφή Web Viewer** - Ροή μνήμης σε πραγματικό χρόνο στη διεύθυνση URL του worker που εμφανίζεται κατά την εκκίνηση - 💻 **Δεξιότητα Claude Desktop** - Αναζήτηση μνήμης από συνομιλίες Claude Desktop - 🔒 **Έλεγχος Απορρήτου** - Χρησιμοποιήστε ετικέτες `` για να εξαιρέσετε ευαίσθητο περιεχόμενο από την αποθήκευση - ⚙️ **Διαμόρφωση Πλαισίου** - Λεπτομερής έλεγχος για το ποιο πλαίσιο εισάγεται - 🤖 **Αυτόματη Λειτουργία** - Δεν απαιτείται χειροκίνητη παρέμβαση -- 🔗 **Αναφορές** - Αναφορά σε παλαιότερες παρατηρήσεις με IDs (πρόσβαση μέσω http://localhost:37777/api/observation/{id} ή προβολή όλων στο web viewer στο http://localhost:37777) -- 🧪 **Κανάλι Beta** - Δοκιμάστε πειραματικά χαρακτηριστικά όπως το Endless Mode μέσω εναλλαγής έκδοσης +- 🔗 **Αναφορές** - Αναφορά σε παλαιότερες παρατηρήσεις με IDs μέσω του worker API ή προβολή όλων στο web viewer --- @@ -135,7 +195,6 @@ - **[Οδηγός Εγκατάστασης](https://docs.claude-mem.ai/installation)** - Γρήγορη εκκίνηση & προηγμένη εγκατάσταση - **[Οδηγός Χρήσης](https://docs.claude-mem.ai/usage/getting-started)** - Πώς λειτουργεί αυτόματα το Claude-Mem - **[Εργαλεία Αναζήτησης](https://docs.claude-mem.ai/usage/search-tools)** - Ερωτήματα στο ιστορικό του έργου σας με φυσική γλώσσα -- **[Χαρακτηριστικά Beta](https://docs.claude-mem.ai/beta-features)** - Δοκιμάστε πειραματικά χαρακτηριστικά όπως το Endless Mode ### Βέλτιστες Πρακτικές @@ -156,6 +215,7 @@ - **[Διαμόρφωση](https://docs.claude-mem.ai/configuration)** - Μεταβλητές περιβάλλοντος & ρυθμίσεις - **[Ανάπτυξη](https://docs.claude-mem.ai/development)** - Κατασκευή, δοκιμή, συνεισφορά +- **[Κλάδοι Έκδοσης](https://docs.claude-mem.ai/branches)** - Ροή κλάδων stable, core-dev, και community-edge - **[Αντιμετώπιση Προβλημάτων](https://docs.claude-mem.ai/troubleshooting)** - Συνήθη προβλήματα & λύσεις --- @@ -166,55 +226,60 @@ 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Έξυπνη Εγκατάσταση** - Έλεγχος εξαρτήσεων με cache (pre-hook script, όχι lifecycle hook) -3. **Υπηρεσία Worker** - HTTP API στη θύρα 37777 με διεπαφή web viewer και 10 endpoints αναζήτησης, διαχειριζόμενη από το Bun +3. **Υπηρεσία Worker** - Τοπικό HTTP API με διεπαφή web viewer και endpoints αναζήτησης, διαχειριζόμενο από το Bun 4. **Βάση Δεδομένων SQLite** - Αποθηκεύει συνεδρίες, παρατηρήσεις, περιλήψεις 5. **Δεξιότητα mem-search** - Ερωτήματα φυσικής γλώσσας με προοδευτική αποκάλυψη 6. **Βάση Δεδομένων Διανυσμάτων Chroma** - Υβριδική σημασιολογική + αναζήτηση λέξεων-κλειδιών για έξυπνη ανάκτηση πλαισίου -Δείτε [Επισκόπηση Αρχιτεκτονικής](https://docs.claude-mem.ai/architecture/overview) για λεπτομέρειες. +Δείτε την [Επισκόπηση Αρχιτεκτονικής](https://docs.claude-mem.ai/architecture/overview) για λεπτομέρειες. --- -## Δεξιότητα mem-search +## Εργαλεία Αναζήτησης MCP -Το Claude-Mem παρέχει έξυπνη αναζήτηση μέσω της δεξιότητας mem-search που ενεργοποιείται αυτόματα όταν ρωτάτε για παλαιότερη εργασία: +Το Claude-Mem παρέχει έξυπνη αναζήτηση μνήμης μέσω **4 εργαλείων MCP** ακολουθώντας ένα αποδοτικό ως προς τα tokens **μοτίβο ροής εργασίας 3 επιπέδων**: + +**Η Ροή Εργασίας 3 Επιπέδων:** + +1. **`search`** - Λήψη συμπαγούς ευρετηρίου με IDs (~50-100 tokens/αποτέλεσμα) +2. **`timeline`** - Λήψη χρονολογικού πλαισίου γύρω από ενδιαφέροντα αποτελέσματα +3. **`get_observations`** - Λήψη πλήρων λεπτομερειών ΜΟΝΟ για φιλτραρισμένα IDs (~500-1.000 tokens/αποτέλεσμα) **Πώς Λειτουργεί:** -- Απλά ρωτήστε φυσικά: *"Τι κάναμε την προηγούμενη συνεδρία;"* ή *"Διορθώσαμε αυτό το σφάλμα νωρίτερα;"* -- Το Claude ενεργοποιεί αυτόματα τη δεξιότητα mem-search για να βρει σχετικό πλαίσιο +- Το Claude χρησιμοποιεί εργαλεία MCP για να αναζητήσει στη μνήμη σας +- Ξεκινήστε με το `search` για να λάβετε ένα ευρετήριο αποτελεσμάτων +- Χρησιμοποιήστε το `timeline` για να δείτε τι συνέβαινε γύρω από συγκεκριμένες παρατηρήσεις +- Χρησιμοποιήστε το `get_observations` για να λάβετε πλήρεις λεπτομέρειες για σχετικά IDs +- **~10x εξοικονόμηση tokens** μέσω φιλτραρίσματος πριν τη λήψη λεπτομερειών -**Διαθέσιμες Λειτουργίες Αναζήτησης:** +**Διαθέσιμα Εργαλεία MCP:** -1. **Search Observations** - Αναζήτηση πλήρους κειμένου σε παρατηρήσεις -2. **Search Sessions** - Αναζήτηση πλήρους κειμένου σε περιλήψεις συνεδριών -3. **Search Prompts** - Αναζήτηση ακατέργαστων αιτημάτων χρήστη -4. **By Concept** - Εύρεση βάσει ετικετών εννοιών (discovery, problem-solution, pattern, κ.λπ.) -5. **By File** - Εύρεση παρατηρήσεων που αναφέρονται σε συγκεκριμένα αρχεία -6. **By Type** - Εύρεση βάσει τύπου (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Λήψη πρόσφατου πλαισίου συνεδρίας για ένα έργο -8. **Timeline** - Λήψη ενοποιημένης χρονολογικής γραμμής πλαισίου γύρω από συγκεκριμένο χρονικό σημείο -9. **Timeline by Query** - Αναζήτηση παρατηρήσεων και λήψη πλαισίου χρονολογικής γραμμής γύρω από την καλύτερη αντιστοιχία -10. **API Help** - Λήψη τεκμηρίωσης API αναζήτησης +1. **`search`** - Αναζήτηση στο ευρετήριο μνήμης με ερωτήματα πλήρους κειμένου, φίλτρα κατά τύπο/ημερομηνία/έργο +2. **`timeline`** - Λήψη χρονολογικού πλαισίου γύρω από συγκεκριμένη παρατήρηση ή ερώτημα +3. **`get_observations`** - Λήψη πλήρων λεπτομερειών παρατήρησης βάσει IDs (πάντα ομαδοποιήστε πολλαπλά IDs) -**Παραδείγματα Ερωτημάτων Φυσικής Γλώσσας:** +**Παράδειγμα Χρήσης:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Step 1: Search for index +search(query="authentication bug", type="bugfix", limit=10) + +// Step 2: Review index, identify relevant IDs (e.g., #123, #456) + +// Step 3: Fetch full details +get_observations(ids=[123, 456]) ``` -Δείτε [Οδηγό Εργαλείων Αναζήτησης](https://docs.claude-mem.ai/usage/search-tools) για λεπτομερή παραδείγματα. +Δείτε τον [Οδηγό Εργαλείων Αναζήτησης](https://docs.claude-mem.ai/usage/search-tools) για λεπτομερή παραδείγματα. --- -## Χαρακτηριστικά Beta +## Κλάδοι Έκδοσης -Το Claude-Mem προσφέρει ένα **κανάλι beta** με πειραματικά χαρακτηριστικά όπως το **Endless Mode** (βιομιμητική αρχιτεκτονική μνήμης για εκτεταμένες συνεδρίες). Εναλλαγή μεταξύ σταθερών και beta εκδόσεων από τη διεπαφή web viewer στο http://localhost:37777 → Settings. - -Δείτε **[Τεκμηρίωση Χαρακτηριστικών Beta](https://docs.claude-mem.ai/beta-features)** για λεπτομέρειες σχετικά με το Endless Mode και πώς να το δοκιμάσετε. +Οι σταθερές εκδόσεις κυκλοφορούν από τον κλάδο `main` και δημοσιεύονται στο npm. Οι κλάδοι `core-dev` και +`community-edge` εκτελούνται από τον πηγαίο κώδικα για πρώιμες διορθώσεις αξιοπιστίας και +ενσωματώσεις της κοινότητας. Δείτε τους **[Κλάδους Έκδοσης](https://docs.claude-mem.ai/branches)** +για τη ροή κλάδων και τις οδηγίες εκτέλεσης μη σταθερών εκδόσεων. --- @@ -226,6 +291,17 @@ - **uv**: Διαχειριστής πακέτων Python για αναζήτηση διανυσμάτων (εγκαθίσταται αυτόματα αν λείπει) - **SQLite 3**: Για μόνιμη αποθήκευση (συμπεριλαμβάνεται) +--- +### Σημειώσεις Ρύθμισης για Windows + +Αν δείτε ένα σφάλμα όπως: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Βεβαιωθείτε ότι το Node.js και το npm είναι εγκατεστημένα και έχουν προστεθεί στο PATH σας. Κατεβάστε τον τελευταίο εγκαταστάτη Node.js από το https://nodejs.org και επανεκκινήστε το τερματικό σας μετά την εγκατάσταση. + --- ## Διαμόρφωση @@ -234,6 +310,45 @@ Δείτε τον **[Οδηγό Διαμόρφωσης](https://docs.claude-mem.ai/configuration)** για όλες τις διαθέσιμες ρυθμίσεις και παραδείγματα. +### Διαμόρφωση Λειτουργίας & Γλώσσας + +Το Claude-Mem υποστηρίζει πολλαπλές λειτουργίες ροής εργασίας και γλώσσες μέσω της ρύθμισης `CLAUDE_MEM_MODE`. + +Αυτή η επιλογή ελέγχει: +- Τη συμπεριφορά της ροής εργασίας (π.χ. code, chill, investigation) +- Τη γλώσσα που χρησιμοποιείται στις παραγόμενες παρατηρήσεις + +#### Πώς να Διαμορφώσετε + +Επεξεργαστείτε το αρχείο ρυθμίσεών σας στο `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Οι λειτουργίες ορίζονται στο `plugin/modes/`. Για να δείτε όλες τις διαθέσιμες λειτουργίες τοπικά: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Διαθέσιμες Λειτουργίες + +| Λειτουργία | Περιγραφή | +|------------|-------------------------| +| `code` | Προεπιλεγμένη λειτουργία στα Αγγλικά | +| `code--zh` | Λειτουργία Απλοποιημένων Κινεζικών | +| `code--ja` | Λειτουργία Ιαπωνικών | + +Οι λειτουργίες ειδικές για κάθε γλώσσα ακολουθούν το μοτίβο `code--[lang]` όπου το `[lang]` είναι ο κωδικός γλώσσας ISO 639-1 (π.χ., `zh` για τα Κινεζικά, `ja` για τα Ιαπωνικά, `es` για τα Ισπανικά). + +> Σημείωση: Το `code--zh` (Απλοποιημένα Κινεζικά) είναι ήδη ενσωματωμένο — δεν απαιτείται επιπλέον εγκατάσταση ή ενημέρωση plugin. + +#### Μετά την Αλλαγή Λειτουργίας + +Επανεκκινήστε το Claude Code για να εφαρμοστεί η νέα διαμόρφωση λειτουργίας. --- ## Ανάπτυξη @@ -269,32 +384,48 @@ npm run bug-report 4. Ενημερώστε την τεκμηρίωση 5. Υποβάλετε ένα Pull Request +Το Claude-Mem κυκλοφορεί από τρεις κλάδους: `main` (σταθερός), `core-dev`, και +`community-edge`. Μόνο ο `main` δημοσιεύεται στο npm· οι υπόλοιποι εκτελούνται από +τον πηγαίο κώδικα. Δείτε τους [Κλάδους Έκδοσης](https://docs.claude-mem.ai/branches) για τη +στρατηγική και τις οδηγίες τοπικής εκτέλεσης. + Δείτε τον [Οδηγό Ανάπτυξης](https://docs.claude-mem.ai/development) για τη ροή εργασίας συνεισφοράς. --- -## License +## Άδεια Χρήσης -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Το Claude-Mem διανέμεται με άδεια Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Επιλέξαμε την Apache-2.0 επειδή η διαρκής agentic μνήμη θα πρέπει να είναι εύκολο να +ενσωματωθεί σε εργαλεία προγραμματιστών, τοπικούς agents, διακομιστές MCP, επιχειρησιακά +συστήματα, στοίβες ρομποτικής και harnesses παραγωγικών agents. -See the [LICENSE](LICENSE) file for full details. +Δείτε το αρχείο [LICENSE](LICENSE) για πλήρεις λεπτομέρειες. Δείτε τα [docs/license.md](docs/license.md) +και [docs/ip-boundary.md](docs/ip-boundary.md) για το πεδίο εφαρμογής της άδειας και το +όριο ανοιχτού/εμπορικού χαρακτήρα. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Σημείωση για το Ragtime**: Ο κατάλογος `ragtime/` διανέμεται με άδεια **Apache License 2.0**. Δείτε το [ragtime/LICENSE](ragtime/LICENSE) για λεπτομέρειες. --- - ## Υποστήριξη - **Τεκμηρίωση**: [docs/](docs/) - **Ζητήματα**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Επίσημος Λογαριασμός X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Επίσημο Discord**: [Συμμετοχή στο Discord](https://discord.com/invite/J4wttp9vDu) - **Συγγραφέας**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Κατασκευασμένο με Claude Agent SDK** | **Τροφοδοτείται από Claude Code** | **Φτιαγμένο με TypeScript** \ No newline at end of file +**Κατασκευασμένο με Claude Agent SDK** | **Λειτουργεί με Claude Code** | **Φτιαγμένο με TypeScript** + +--- + +### Τι Γίνεται με το CMEM; + +Το CMEM είναι ένα token που δημιουργήθηκε από τρίτο μέρος, αλλά υιοθετήθηκε επίσημα από τον δημιουργό του Claude-Mem (Alex Newman, @thedotmack). Το token λειτουργεί ως καταλύτης ανάπτυξης για την κοινότητα και ως όχημα για να φέρει το CMEM στους προγραμματιστές και τους εργαζόμενους γνώσης που το χρειάζονται περισσότερο. + +Επίσημη διεύθυνση BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md index 2642ddfbd..4adeed05e 100644 --- a/docs/i18n/README.es.md +++ b/docs/i18n/README.es.md @@ -1,7 +1,5 @@ 🌐 Esta es una traducción automática. ¡Las correcciones de la comunidad son bienvenidas! ---- -


@@ -12,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Sistema de compresión de memoria persistente construido para Claude Code.

- License + License Version @@ -76,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Inicio Rápido • @@ -102,28 +132,57 @@ ## Inicio Rápido -Inicia una nueva sesión de Claude Code en la terminal e ingresa los siguientes comandos: +Instala con un solo comando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +O instala para OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +O instala para Antigravity CLI ([guía de configuración](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +O instala desde el marketplace de plugins dentro de Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticamente en nuevas sesiones. +> **Nota:** Claude-Mem también está publicado en npm, pero `npm install -g claude-mem` instala **únicamente el SDK/librería** — no registra los hooks del plugin ni configura el servicio worker. Instala siempre mediante `npx claude-mem install` o los comandos `/plugin` mencionados arriba. + +### 🦞 OpenClaw Gateway + +Instala claude-mem como plugin de memoria persistente en gateways de [OpenClaw](https://openclaw.ai) con un solo comando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +El instalador se encarga de las dependencias, la configuración del plugin, la configuración del proveedor de IA, el inicio del worker y, opcionalmente, de los feeds de observación en tiempo real hacia Telegram, Discord, Slack y más. Consulta la [Guía de Integración con OpenClaw](https://docs.claude-mem.ai/openclaw-integration) para más detalles. + **Características Principales:** - 🧠 **Memoria Persistente** - El contexto sobrevive entre sesiones - 📊 **Divulgación Progresiva** - Recuperación de memoria en capas con visibilidad del costo de tokens - 🔍 **Búsqueda Basada en Habilidades** - Consulta el historial de tu proyecto con la habilidad mem-search -- 🖥️ **Interfaz de Visor Web** - Transmisión de memoria en tiempo real en http://localhost:37777 +- 🖥️ **Interfaz de Visor Web** - Transmisión de memoria en tiempo real en la URL del worker impresa al iniciar - 💻 **Habilidad para Claude Desktop** - Busca en la memoria desde conversaciones de Claude Desktop - 🔒 **Control de Privacidad** - Usa etiquetas `` para excluir contenido sensible del almacenamiento - ⚙️ **Configuración de Contexto** - Control detallado sobre qué contexto se inyecta - 🤖 **Operación Automática** - No se requiere intervención manual -- 🔗 **Citas** - Referencias a observaciones pasadas con IDs (accede vía http://localhost:37777/api/observation/{id} o visualiza todas en el visor web en http://localhost:37777) -- 🧪 **Canal Beta** - Prueba características experimentales como Endless Mode mediante cambio de versión +- 🔗 **Citas** - Referencia observaciones pasadas con IDs a través de la API del worker o visualiza todas en el visor web --- @@ -136,7 +195,6 @@ Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticam - **[Guía de Instalación](https://docs.claude-mem.ai/installation)** - Inicio rápido e instalación avanzada - **[Guía de Uso](https://docs.claude-mem.ai/usage/getting-started)** - Cómo funciona Claude-Mem automáticamente - **[Herramientas de Búsqueda](https://docs.claude-mem.ai/usage/search-tools)** - Consulta el historial de tu proyecto con lenguaje natural -- **[Características Beta](https://docs.claude-mem.ai/beta-features)** - Prueba características experimentales como Endless Mode ### Mejores Prácticas @@ -157,6 +215,7 @@ Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticam - **[Configuración](https://docs.claude-mem.ai/configuration)** - Variables de entorno y ajustes - **[Desarrollo](https://docs.claude-mem.ai/development)** - Compilación, pruebas y contribución +- **[Ramas de Publicación](https://docs.claude-mem.ai/branches)** - Flujo de las ramas stable, core-dev y community-edge - **[Solución de Problemas](https://docs.claude-mem.ai/troubleshooting)** - Problemas comunes y soluciones --- @@ -167,7 +226,7 @@ Reinicia Claude Code. El contexto de sesiones anteriores aparecerá automáticam 1. **5 Hooks de Ciclo de Vida** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hooks) 2. **Instalación Inteligente** - Verificador de dependencias en caché (script pre-hook, no un hook de ciclo de vida) -3. **Servicio Worker** - API HTTP en el puerto 37777 con interfaz de visor web y 10 endpoints de búsqueda, gestionado por Bun +3. **Servicio Worker** - API HTTP local con interfaz de visor web y endpoints de búsqueda, gestionado por Bun 4. **Base de Datos SQLite** - Almacena sesiones, observaciones, resúmenes 5. **Habilidad mem-search** - Consultas en lenguaje natural con divulgación progresiva 6. **Base de Datos Vectorial Chroma** - Búsqueda híbrida semántica + palabras clave para recuperación inteligente de contexto @@ -176,46 +235,51 @@ Ver [Descripción General de la Arquitectura](https://docs.claude-mem.ai/archite --- -## Habilidad mem-search +## Herramientas de Búsqueda MCP -Claude-Mem proporciona búsqueda inteligente a través de la habilidad mem-search que se invoca automáticamente cuando preguntas sobre trabajo previo: +Claude-Mem proporciona búsqueda inteligente de memoria a través de **4 herramientas MCP** siguiendo un patrón de flujo de trabajo de **3 capas** eficiente en tokens: + +**El Flujo de Trabajo de 3 Capas:** + +1. **`search`** - Obtén un índice compacto con IDs (~50-100 tokens/resultado) +2. **`timeline`** - Obtén contexto cronológico alrededor de resultados interesantes +3. **`get_observations`** - Obtén detalles completos SOLO para los IDs filtrados (~500-1,000 tokens/resultado) **Cómo Funciona:** -- Simplemente pregunta naturalmente: *"¿Qué hicimos en la última sesión?"* o *"¿Arreglamos este error antes?"* -- Claude invoca automáticamente la habilidad mem-search para encontrar contexto relevante +- Claude usa herramientas MCP para buscar en tu memoria +- Comienza con `search` para obtener un índice de resultados +- Usa `timeline` para ver qué estaba ocurriendo alrededor de observaciones específicas +- Usa `get_observations` para obtener detalles completos de los IDs relevantes +- **Ahorro de tokens de ~10x** al filtrar antes de obtener los detalles -**Operaciones de Búsqueda Disponibles:** +**Herramientas MCP Disponibles:** -1. **Search Observations** - Búsqueda de texto completo en observaciones -2. **Search Sessions** - Búsqueda de texto completo en resúmenes de sesiones -3. **Search Prompts** - Búsqueda de solicitudes de usuario sin procesar -4. **By Concept** - Buscar por etiquetas de concepto (discovery, problem-solution, pattern, etc.) -5. **By File** - Buscar observaciones que referencian archivos específicos -6. **By Type** - Buscar por tipo (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Obtener contexto de sesión reciente para un proyecto -8. **Timeline** - Obtener línea de tiempo unificada de contexto alrededor de un punto específico en el tiempo -9. **Timeline by Query** - Buscar observaciones y obtener contexto de línea de tiempo alrededor de la mejor coincidencia -10. **API Help** - Obtener documentación de la API de búsqueda +1. **`search`** - Busca en el índice de memoria con consultas de texto completo, filtra por tipo/fecha/proyecto +2. **`timeline`** - Obtén contexto cronológico alrededor de una observación o consulta específica +3. **`get_observations`** - Obtén detalles completos de observaciones por IDs (siempre agrupa varios IDs) -**Ejemplos de Consultas en Lenguaje Natural:** +**Ejemplo de Uso:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Paso 1: Buscar el índice +search(query="authentication bug", type="bugfix", limit=10) + +// Paso 2: Revisar el índice, identificar IDs relevantes (ej. #123, #456) + +// Paso 3: Obtener detalles completos +get_observations(ids=[123, 456]) ``` Ver [Guía de Herramientas de Búsqueda](https://docs.claude-mem.ai/usage/search-tools) para ejemplos detallados. --- -## Características Beta +## Ramas de Publicación -Claude-Mem ofrece un **canal beta** con características experimentales como **Endless Mode** (arquitectura de memoria biomimética para sesiones extendidas). Cambia entre versiones estables y beta desde la interfaz del visor web en http://localhost:37777 → Settings. - -Ver **[Documentación de Características Beta](https://docs.claude-mem.ai/beta-features)** para detalles sobre Endless Mode y cómo probarlo. +Las versiones estables se publican desde `main` y se distribuyen en npm. `core-dev` y +`community-edge` son ramas que se ejecutan desde el código fuente para correcciones tempranas +de fiabilidad e integraciones de la comunidad. Consulta **[Ramas de Publicación](https://docs.claude-mem.ai/branches)** +para conocer el flujo de ramas y las instrucciones de ejecución no estable. --- @@ -227,6 +291,17 @@ Ver **[Documentación de Características Beta](https://docs.claude-mem.ai/beta- - **uv**: Gestor de paquetes de Python para búsqueda vectorial (se instala automáticamente si falta) - **SQLite 3**: Para almacenamiento persistente (incluido) +--- +### Notas de Configuración para Windows + +Si ves un error como: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Asegúrate de que Node.js y npm estén instalados y agregados a tu PATH. Descarga el instalador más reciente de Node.js desde https://nodejs.org y reinicia tu terminal después de la instalación. + --- ## Configuración @@ -235,6 +310,45 @@ Los ajustes se gestionan en `~/.claude-mem/settings.json` (se crea automáticame Ver la **[Guía de Configuración](https://docs.claude-mem.ai/configuration)** para todos los ajustes disponibles y ejemplos. +### Configuración de Modo e Idioma + +Claude-Mem admite múltiples modos de flujo de trabajo e idiomas a través del ajuste `CLAUDE_MEM_MODE`. + +Esta opción controla tanto: +- El comportamiento del flujo de trabajo (ej. code, chill, investigation) +- El idioma usado en las observaciones generadas + +#### Cómo Configurarlo + +Edita tu archivo de ajustes en `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Los modos están definidos en `plugin/modes/`. Para ver todos los modos disponibles localmente: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Modos Disponibles + +| Modo | Descripción | +|------------|-------------------------| +| `code` | Modo predeterminado en inglés | +| `code--zh` | Modo en chino simplificado | +| `code--ja` | Modo en japonés | + +Los modos específicos de idioma siguen el patrón `code--[lang]` donde `[lang]` es el código de idioma ISO 639-1 (ej., `zh` para chino, `ja` para japonés, `es` para español). + +> Nota: `code--zh` (chino simplificado) ya viene incorporado — no se requiere instalación adicional ni actualización del plugin. + +#### Después de Cambiar el Modo + +Reinicia Claude Code para aplicar la nueva configuración de modo. --- ## Desarrollo @@ -270,32 +384,48 @@ npm run bug-report 4. Actualiza la documentación 5. Envía un Pull Request +Claude-Mem se distribuye desde tres ramas: `main` (estable), `core-dev` y +`community-edge`. Solo `main` se publica en npm; las demás se ejecutan desde +el código fuente. Consulta [Ramas de Publicación](https://docs.claude-mem.ai/branches) para conocer la +estrategia y las instrucciones de ejecución local. + Ver [Guía de Desarrollo](https://docs.claude-mem.ai/development) para el flujo de contribución. --- -## License +## Licencia -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem está licenciado bajo la Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Elegimos Apache-2.0 porque la memoria agéntica duradera debe ser fácil de integrar en +herramientas para desarrolladores, agentes locales, servidores MCP, sistemas empresariales, pilas de robótica +y entornos de agentes en producción. -See the [LICENSE](LICENSE) file for full details. +Consulta el archivo [LICENSE](LICENSE) para todos los detalles. Consulta [docs/license.md](docs/license.md) +y [docs/ip-boundary.md](docs/ip-boundary.md) para el alcance de la licencia y el límite +entre lo abierto y lo comercial. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Nota sobre Ragtime**: El directorio `ragtime/` está licenciado bajo la **Apache License 2.0**. Consulta [ragtime/LICENSE](ragtime/LICENSE) para más detalles. --- - ## Soporte - **Documentación**: [docs/](docs/) - **Problemas**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repositorio**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Cuenta Oficial de X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Oficial**: [Únete a Discord](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Construido con Claude Agent SDK** | **Impulsado por Claude Code** | **Hecho con TypeScript** \ No newline at end of file +**Construido con Claude Agent SDK** | **Funciona con Claude Code** | **Hecho con TypeScript** + +--- + +### ¿Qué Hay de CMEM? + +CMEM es un token creado por un tercero, pero adoptado oficialmente por el creador de Claude-Mem (Alex Newman, @thedotmack). El token actúa como catalizador comunitario para el crecimiento y como vehículo para llevar CMEM a los desarrolladores y trabajadores del conocimiento que más lo necesitan. + +CA Oficial en BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.fi.md b/docs/i18n/README.fi.md index 77463380e..60a8fcec8 100644 --- a/docs/i18n/README.fi.md +++ b/docs/i18n/README.fi.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

Pysyvä muistinpakkaamisjärjestelmä, joka on rakennettu Claude Code -ympäristöön.

+

Pysyvä muistinpakkaamisjärjestelmä, joka on rakennettu Claude Code -ympäristöön varten.

- License + License Version @@ -74,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Pikaopas • Miten se toimii • - Hakutyökalut • + Hakutyökalut • Dokumentaatio • Asetukset • Vianmääritys • @@ -93,35 +125,64 @@

- Claude-Mem säilyttää kontekstin saumattomasti istuntojen välillä tallentamalla automaattisesti työkalujen käyttöhavaintoja, luomalla semanttisia yhteenvetoja ja asettamalla ne tulevien istuntojen saataville. Tämä mahdollistaa Clauden säilyttää tiedon jatkuvuuden projekteista senkin jälkeen, kun istunnot päättyvät tai yhteys palautuu. + Claude-Mem säilyttää kontekstin saumattomasti istuntojen välillä tallentamalla automaattisesti työkalujen käyttöhavaintoja, luomalla semanttisia yhteenvetoja ja asettamalla ne tulevien istuntojen saataville. Tämä mahdollistaa sen, että Claude säilyttää tiedon jatkuvuuden projekteista senkin jälkeen, kun istunnot päättyvät tai yhteys muodostetaan uudelleen.

--- ## Pikaopas -Aloita uusi Claude Code -istunto terminaalissa ja syötä seuraavat komennot: +Asenna yhdellä komennolla: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Tai asenna OpenCodelle: + +```bash +npx claude-mem install --ide opencode +``` + +Tai asenna Antigravity CLI:lle ([asennusopas](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Tai asenna plugin-markkinapaikalta Claude Coden sisältä: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automaattisesti uusiin istuntoihin. +> **Huomio:** Claude-Mem on julkaistu myös npm:ssä, mutta `npm install -g claude-mem` asentaa **vain SDK:n/kirjaston** — se ei rekisteröi plugin-koukkuja eikä määritä worker-palvelua. Asenna aina komennolla `npx claude-mem install` tai yllä olevilla `/plugin`-komennoilla. + +### 🦞 OpenClaw Gateway + +Asenna claude-mem pysyväksi muistipluginiksi [OpenClaw](https://openclaw.ai)-yhdyskäytäviin yhdellä komennolla: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Asennusohjelma hoitaa riippuvuudet, plugin-asetukset, AI-palveluntarjoajan määrityksen, workerin käynnistyksen ja valinnaiset reaaliaikaiset havaintosyötteet Telegramiin, Discordiin, Slackiin ja muihin. Katso lisätietoja [OpenClaw-integraatio-oppaasta](https://docs.claude-mem.ai/openclaw-integration). + **Keskeiset ominaisuudet:** - 🧠 **Pysyvä muisti** - Konteksti säilyy istuntojen välillä - 📊 **Asteittainen paljastaminen** - Kerrostettu muistin haku tokenikustannusten näkyvyydellä - 🔍 **Taitopohjainen haku** - Kysy projektihistoriaasi mem-search-taidolla -- 🖥️ **Web-katselukäyttöliittymä** - Reaaliaikainen muistivirta osoitteessa http://localhost:37777 +- 🖥️ **Web-katselukäyttöliittymä** - Reaaliaikainen muistivirta käynnistyksen yhteydessä tulostetussa worker-osoitteessa - 💻 **Claude Desktop -taito** - Hae muistista Claude Desktop -keskusteluissa - 🔒 **Yksityisyyden hallinta** - Käytä ``-tageja arkaluonteisen sisällön poissulkemiseen tallennuksesta - ⚙️ **Kontekstin määrittely** - Tarkka hallinta siitä, mikä konteksti injektoidaan - 🤖 **Automaattinen toiminta** - Ei vaadi manuaalista puuttumista -- 🔗 **Viittaukset** - Viittaa aiempiin havaintoihin ID:llä (käytettävissä osoitteessa http://localhost:37777/api/observation/{id} tai näytä kaikki web-katselussa osoitteessa http://localhost:37777) -- 🧪 **Beta-kanava** - Kokeile kokeellisia ominaisuuksia kuten Endless Mode versionvaihdolla +- 🔗 **Viittaukset** - Viittaa aiempiin havaintoihin ID:llä worker-API:n kautta tai näytä kaikki web-katselussa --- @@ -134,7 +195,6 @@ Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automa - **[Asennusopas](https://docs.claude-mem.ai/installation)** - Pikaopas ja edistynyt asennus - **[Käyttöopas](https://docs.claude-mem.ai/usage/getting-started)** - Miten Claude-Mem toimii automaattisesti - **[Hakutyökalut](https://docs.claude-mem.ai/usage/search-tools)** - Kysy projektihistoriaasi luonnollisella kielellä -- **[Beta-ominaisuudet](https://docs.claude-mem.ai/beta-features)** - Kokeile kokeellisia ominaisuuksia kuten Endless Mode ### Parhaat käytännöt @@ -145,8 +205,8 @@ Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automa - **[Yleiskatsaus](https://docs.claude-mem.ai/architecture/overview)** - Järjestelmän komponentit ja datavirta - **[Arkkitehtuurin kehitys](https://docs.claude-mem.ai/architecture-evolution)** - Matka versiosta v3 versioon v5 -- **[Koukku-arkkitehtuuri](https://docs.claude-mem.ai/hooks-architecture)** - Miten Claude-Mem käyttää elinkaarikkoukkuja -- **[Koukku-viittaus](https://docs.claude-mem.ai/architecture/hooks)** - 7 koukku-skriptiä selitettynä +- **[Koukku-arkkitehtuuri](https://docs.claude-mem.ai/hooks-architecture)** - Miten Claude-Mem käyttää elinkaarikoukkuja +- **[Koukkuviittaus](https://docs.claude-mem.ai/architecture/hooks)** - 7 koukku-skriptiä selitettynä - **[Worker-palvelu](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API ja Bun-hallinta - **[Tietokanta](https://docs.claude-mem.ai/architecture/database)** - SQLite-skeema ja FTS5-haku - **[Hakuarkkitehtuuri](https://docs.claude-mem.ai/architecture/search-architecture)** - Hybridihaku Chroma-vektoritietokannalla @@ -155,6 +215,7 @@ Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automa - **[Asetukset](https://docs.claude-mem.ai/configuration)** - Ympäristömuuttujat ja asetukset - **[Kehitys](https://docs.claude-mem.ai/development)** - Rakentaminen, testaus, osallistuminen +- **[Julkaisuhaarat](https://docs.claude-mem.ai/branches)** - Stable-, core-dev- ja community-edge-haarojen kulku - **[Vianmääritys](https://docs.claude-mem.ai/troubleshooting)** - Yleiset ongelmat ja ratkaisut --- @@ -164,8 +225,8 @@ Käynnistä Claude Code uudelleen. Aiempien istuntojen konteksti ilmestyy automa **Keskeiset komponentit:** 1. **5 elinkaarikoukua** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 koukku-skriptiä) -2. **Älykäs asennus** - Välimuistettu riippuvuuksien tarkistaja (esikoukku-skripti, ei elinkaarikkoukku) -3. **Worker-palvelu** - HTTP API portissa 37777 web-katselukäyttöliittymällä ja 10 hakupäätepisteellä, Bun-hallinnoimana +2. **Älykäs asennus** - Välimuistettu riippuvuuksien tarkistaja (esikoukku-skripti, ei elinkaarikoukku) +3. **Worker-palvelu** - Paikallinen HTTP API web-katselukäyttöliittymällä ja hakupäätepisteillä, Bun-hallinnoimana 4. **SQLite-tietokanta** - Tallentaa istunnot, havainnot, yhteenvedot 5. **mem-search-taito** - Luonnollisen kielen kyselyt asteittaisella paljastamisella 6. **Chroma-vektoritietokanta** - Hybridi semanttinen + avainsanahaku älykkääseen kontekstin hakuun @@ -174,46 +235,51 @@ Katso [Arkkitehtuurin yleiskatsaus](https://docs.claude-mem.ai/architecture/over --- -## mem-search-taito +## MCP-hakutyökalut -Claude-Mem tarjoaa älykkään haun mem-search-taidon kautta, joka käynnistyy automaattisesti kun kysyt aiemmasta työstä: +Claude-Mem tarjoaa älykkään muistihaun **4 MCP-työkalun** kautta noudattaen tokentehokasta **3-kerroksista työnkulkumallia**: + +**3-kerroksinen työnkulku:** + +1. **`search`** - Hae tiivis hakemisto ID:illä (~50-100 tokenia/tulos) +2. **`timeline`** - Hae kronologinen konteksti kiinnostavien tulosten ympäriltä +3. **`get_observations`** - Hae täydet tiedot VAIN suodatetuille ID:ille (~500-1 000 tokenia/tulos) **Miten se toimii:** -- Kysy vain luonnollisesti: *"Mitä teimme viime istunnossa?"* tai *"Korjasimmeko tämän bugin aiemmin?"* -- Claude käynnistää automaattisesti mem-search-taidon löytääkseen relevantin kontekstin +- Claude käyttää MCP-työkaluja muistisi hakemiseen +- Aloita `search`-työkalulla saadaksesi hakemiston tuloksista +- Käytä `timeline`-työkalua nähdäksesi, mitä tapahtui tiettyjen havaintojen ympärillä +- Käytä `get_observations`-työkalua hakeaksesi täydet tiedot relevanteille ID:ille +- **~10-kertainen tokenisäästö** suodattamalla ennen tietojen hakemista -**Saatavilla olevat hakutoiminnot:** +**Saatavilla olevat MCP-työkalut:** -1. **Hae havaintoja** - Koko tekstin haku havainnoissa -2. **Hae istuntoja** - Koko tekstin haku istuntojen yhteenvedoissa -3. **Hae prompteja** - Hae raakoista käyttäjäpyynnöistä -4. **Konseptin mukaan** - Hae konseptitageilla (discovery, problem-solution, pattern, jne.) -5. **Tiedoston mukaan** - Hae tiettyihin tiedostoihin viittaavia havaintoja -6. **Tyypin mukaan** - Hae tyypillä (decision, bugfix, feature, refactor, discovery, change) -7. **Viimeaikainen konteksti** - Hae projektin viimeaikainen istuntokonteksti -8. **Aikajana** - Hae yhtenäinen aikajana kontekstista tietyn ajankohdan ympärillä -9. **Aikajana kyselyn mukaan** - Hae havaintoja ja saa aikalinjakonteksti parhaan osuman ympärillä -10. **API-ohje** - Hae haku-API:n dokumentaatio +1. **`search`** - Hae muistihakemistosta koko tekstin kyselyillä, suodata tyypin/päivämäärän/projektin mukaan +2. **`timeline`** - Hae kronologinen konteksti tietyn havainnon tai kyselyn ympäriltä +3. **`get_observations`** - Hae täydet havaintotiedot ID:iden perusteella (yhdistä aina useita ID:itä) -**Esimerkkejä luonnollisen kielen kyselyistä:** +**Esimerkkikäyttö:** -``` -"Mitkä bugit korjasimme viime istunnossa?" -"Miten toteutimme autentikoinnin?" -"Mitä muutoksia tehtiin worker-service.ts:ään?" -"Näytä viimeaikainen työ tässä projektissa" -"Mitä tapahtui kun lisäsimme katselukäyttöliittymän?" +```typescript +// Vaihe 1: Hae hakemisto +search(query="authentication bug", type="bugfix", limit=10) + +// Vaihe 2: Tarkista hakemisto, tunnista relevantit ID:t (esim. #123, #456) + +// Vaihe 3: Hae täydet tiedot +get_observations(ids=[123, 456]) ``` Katso [Hakutyökalujen opas](https://docs.claude-mem.ai/usage/search-tools) yksityiskohtaisia esimerkkejä varten. --- -## Beta-ominaisuudet +## Julkaisuhaarat -Claude-Mem tarjoaa **beta-kanavan** kokeellisilla ominaisuuksilla kuten **Endless Mode** (biomimeettinen muistiarkkitehtuuri pidennetyille istunnoille). Vaihda vakaan ja beta-version välillä web-katselukäyttöliittymästä osoitteessa http://localhost:37777 → Settings. - -Katso **[Beta-ominaisuuksien dokumentaatio](https://docs.claude-mem.ai/beta-features)** yksityiskohdista Endless Moden ja sen kokeilemisen osalta. +Vakaat julkaisut toimitetaan `main`-haarasta ja julkaistaan npm:ssä. `core-dev`- ja +`community-edge`-haarat ovat lähdekoodista ajettavia haaroja varhaisia luotettavuuskorjauksia ja +yhteisöintegraatioita varten. Katso **[Julkaisuhaarat](https://docs.claude-mem.ai/branches)** +haarojen kulusta ja ei-vakaiden versioiden ajo-ohjeista. --- @@ -225,6 +291,17 @@ Katso **[Beta-ominaisuuksien dokumentaatio](https://docs.claude-mem.ai/beta-feat - **uv**: Python-paketinhallinta vektorihakuun (asennetaan automaattisesti jos puuttuu) - **SQLite 3**: Pysyvälle tallennukselle (sisältyy) +--- +### Windows-asennusohjeita + +Jos näet virheen kuten: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Varmista, että Node.js ja npm on asennettu ja lisätty PATH-muuttujaan. Lataa uusin Node.js-asennusohjelma osoitteesta https://nodejs.org ja käynnistä pääte uudelleen asennuksen jälkeen. + --- ## Asetukset @@ -233,6 +310,45 @@ Asetuksia hallitaan tiedostossa `~/.claude-mem/settings.json` (luodaan automaatt Katso **[Asetusopas](https://docs.claude-mem.ai/configuration)** kaikista saatavilla olevista asetuksista ja esimerkeistä. +### Tilan ja kielen määritys + +Claude-Mem tukee useita työnkulkutiloja ja kieliä `CLAUDE_MEM_MODE`-asetuksen kautta. + +Tämä asetus hallitsee sekä: +- Työnkulun käyttäytymistä (esim. code, chill, investigation) +- Luotujen havaintojen kieltä + +#### Miten määrittää + +Muokkaa asetustiedostoasi osoitteessa `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Tilat on määritelty kansiossa `plugin/modes/`. Nähdäksesi kaikki saatavilla olevat tilat paikallisesti: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Saatavilla olevat tilat + +| Tila | Kuvaus | +|------------|-------------------------| +| `code` | Oletusarvoinen englanninkielinen tila | +| `code--zh` | Yksinkertaistettu kiina -tila | +| `code--ja` | Japani-tila | + +Kielikohtaiset tilat noudattavat mallia `code--[lang]`, jossa `[lang]` on ISO 639-1 -kielikoodi (esim. `zh` kiinalle, `ja` japanille, `es` espanjalle). + +> Huomio: `code--zh` (yksinkertaistettu kiina) on jo sisäänrakennettu — lisäasennusta tai plugin-päivitystä ei tarvita. + +#### Tilan vaihtamisen jälkeen + +Käynnistä Claude Code uudelleen soveltaaksesi uuden tila-asetuksen. --- ## Kehitys @@ -260,7 +376,7 @@ npm run bug-report ## Osallistuminen -Osallistuminen on tervetullutta! Ole hyvä: +Osallistuminen on tervetullutta! Ole hyvä ja: 1. Haarukoi repositorio 2. Luo ominaisuushaara @@ -268,32 +384,48 @@ Osallistuminen on tervetullutta! Ole hyvä: 4. Päivitä dokumentaatio 5. Lähetä Pull Request +Claude-Mem toimitetaan kolmesta haarasta: `main` (vakaa), `core-dev` ja +`community-edge`. Vain `main` julkaistaan npm:ssä; muut ajetaan +lähdekoodista. Katso [Julkaisuhaarat](https://docs.claude-mem.ai/branches) strategiasta ja +paikallisista ajo-ohjeista. + Katso [Kehitysopas](https://docs.claude-mem.ai/development) osallistumisen työnkulusta. --- -## License +## Lisenssi -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem on lisensoitu Apache License 2.0 -lisenssillä. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Valitsimme Apache-2.0:n, koska pysyvän agenttimuistin tulisi olla helppo upottaa +kehittäjätyökaluihin, paikallisiin agentteihin, MCP-palvelimiin, yritysjärjestelmiin, robotiikkapinoihin +ja tuotannon agenttiratkaisuihin. -See the [LICENSE](LICENSE) file for full details. +Katso [LICENSE](LICENSE)-tiedosto täysistä yksityiskohdista. Katso [docs/license.md](docs/license.md) +ja [docs/ip-boundary.md](docs/ip-boundary.md) lisenssoinnin laajuudesta ja +avoimen/kaupallisen rajan osalta. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Huomio Ragtimesta**: `ragtime/`-hakemisto on lisensoitu **Apache License 2.0** -lisenssillä. Katso [ragtime/LICENSE](ragtime/LICENSE) lisätietoja varten. --- - ## Tuki - **Dokumentaatio**: [docs/](docs/) - **Ongelmat**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repositorio**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Virallinen X-tili**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Virallinen Discord**: [Liity Discordiin](https://discord.com/invite/J4wttp9vDu) - **Tekijä**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Rakennettu Claude Agent SDK:lla** | **Claude Coden voimalla** | **Tehty TypeScriptillä** \ No newline at end of file +**Rakennettu Claude Agent SDK:lla** | **Toimii Claude Coden kanssa** | **Tehty TypeScriptillä** + +--- + +### Entä CMEM? + +CMEM on kolmannen osapuolen luoma token, jonka Claude-Memin luoja (Alex Newman, @thedotmack) on virallisesti hyväksynyt. Token toimii yhteisön kasvun katalysaattorina ja välineenä, jolla CMEM tuodaan niiden kehittäjien ja tietotyöläisten saataville, jotka sitä eniten tarvitsevat. + +Virallinen BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md index 0991fa30a..8665e2eb2 100644 --- a/docs/i18n/README.fr.md +++ b/docs/i18n/README.fr.md @@ -1,6 +1,5 @@ 🌐 Ceci est une traduction automatisée. Les corrections de la communauté sont les bienvenues ! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Système de compression de mémoire persistante conçu pour Claude Code.

- License + License Version @@ -75,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Démarrage rapide • Comment ça fonctionne • - Outils de recherche • + Outils de recherche • Documentation • Configuration • Dépannage • @@ -101,28 +132,57 @@ ## Démarrage rapide -Démarrez une nouvelle session Claude Code dans le terminal et saisissez les commandes suivantes : +Installez avec une seule commande : +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Ou installez pour OpenCode : + +```bash +npx claude-mem install --ide opencode +``` + +Ou installez pour Antigravity CLI ([guide d'installation](https://docs.claude-mem.ai/antigravity-cli/setup)) : + +```bash +npx claude-mem install --ide antigravity +``` + +Ou installez depuis la marketplace de plugins à l'intérieur de Claude Code : + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Redémarrez Claude Code. Le contexte des sessions précédentes apparaîtra automatiquement dans les nouvelles sessions. +> **Remarque :** Claude-Mem est également publié sur npm, mais `npm install -g claude-mem` installe **uniquement le SDK/la bibliothèque** — cela n'enregistre pas les hooks du plugin et ne configure pas le service worker. Installez toujours via `npx claude-mem install` ou les commandes `/plugin` ci-dessus. + +### 🦞 OpenClaw Gateway + +Installez claude-mem comme plugin de mémoire persistante sur les passerelles [OpenClaw](https://openclaw.ai) avec une seule commande : + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +L'installateur gère les dépendances, la configuration du plugin, la configuration du fournisseur d'IA, le démarrage du worker, ainsi que des flux d'observation optionnels en temps réel vers Telegram, Discord, Slack, et plus encore. Consultez le [Guide d'intégration OpenClaw](https://docs.claude-mem.ai/openclaw-integration) pour plus de détails. + **Fonctionnalités clés :** - 🧠 **Mémoire persistante** - Le contexte survit d'une session à l'autre - 📊 **Divulgation progressive** - Récupération de mémoire en couches avec visibilité du coût en tokens - 🔍 **Recherche basée sur les compétences** - Interrogez l'historique de votre projet avec la compétence mem-search -- 🖥️ **Interface Web de visualisation** - Flux de mémoire en temps réel à http://localhost:37777 +- 🖥️ **Interface Web de visualisation** - Flux de mémoire en temps réel à l'URL du worker affichée au démarrage - 💻 **Compétence Claude Desktop** - Recherchez dans la mémoire depuis les conversations Claude Desktop - 🔒 **Contrôle de la confidentialité** - Utilisez les balises `` pour exclure le contenu sensible du stockage - ⚙️ **Configuration du contexte** - Contrôle précis sur le contexte injecté - 🤖 **Fonctionnement automatique** - Aucune intervention manuelle requise -- 🔗 **Citations** - Référencez les observations passées avec des ID (accès via http://localhost:37777/api/observation/{id} ou visualisez tout dans l'interface web à http://localhost:37777) -- 🧪 **Canal bêta** - Essayez des fonctionnalités expérimentales comme le mode Endless via le changement de version +- 🔗 **Citations** - Référencez les observations passées avec des ID via l'API du worker ou visualisez-les toutes dans l'interface web --- @@ -135,7 +195,6 @@ Redémarrez Claude Code. Le contexte des sessions précédentes apparaîtra auto - **[Guide d'installation](https://docs.claude-mem.ai/installation)** - Démarrage rapide et installation avancée - **[Guide d'utilisation](https://docs.claude-mem.ai/usage/getting-started)** - Comment Claude-Mem fonctionne automatiquement - **[Outils de recherche](https://docs.claude-mem.ai/usage/search-tools)** - Interrogez l'historique de votre projet en langage naturel -- **[Fonctionnalités bêta](https://docs.claude-mem.ai/beta-features)** - Essayez des fonctionnalités expérimentales comme le mode Endless ### Bonnes pratiques @@ -156,6 +215,7 @@ Redémarrez Claude Code. Le contexte des sessions précédentes apparaîtra auto - **[Configuration](https://docs.claude-mem.ai/configuration)** - Variables d'environnement et paramètres - **[Développement](https://docs.claude-mem.ai/development)** - Compilation, tests, contribution +- **[Branches de publication](https://docs.claude-mem.ai/branches)** - Flux des branches stable, core-dev et community-edge - **[Dépannage](https://docs.claude-mem.ai/troubleshooting)** - Problèmes courants et solutions --- @@ -166,55 +226,60 @@ Redémarrez Claude Code. Le contexte des sessions précédentes apparaîtra auto 1. **5 hooks de cycle de vie** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hooks) 2. **Installation intelligente** - Vérificateur de dépendances en cache (script pré-hook, pas un hook de cycle de vie) -3. **Service Worker** - API HTTP sur le port 37777 avec interface web de visualisation et 10 points de terminaison de recherche, géré par Bun +3. **Service Worker** - API HTTP locale avec interface web de visualisation et points de terminaison de recherche, géré par Bun 4. **Base de données SQLite** - Stocke les sessions, observations, résumés 5. **Compétence mem-search** - Requêtes en langage naturel avec divulgation progressive 6. **Base de données vectorielle Chroma** - Recherche hybride sémantique + mots-clés pour une récupération de contexte intelligente -Voir [Vue d'ensemble de l'architecture](https://docs.claude-mem.ai/architecture/overview) pour plus de détails. +Voir la [Vue d'ensemble de l'architecture](https://docs.claude-mem.ai/architecture/overview) pour plus de détails. --- -## Compétence mem-search +## Outils de recherche MCP -Claude-Mem fournit une recherche intelligente via la compétence mem-search qui s'invoque automatiquement lorsque vous posez des questions sur le travail passé : +Claude-Mem fournit une recherche de mémoire intelligente via **4 outils MCP** suivant un modèle de flux de travail à **3 couches**, économe en tokens : + +**Le flux de travail à 3 couches :** + +1. **`search`** - Obtenir un index compact avec des ID (~50-100 tokens/résultat) +2. **`timeline`** - Obtenir le contexte chronologique autour de résultats intéressants +3. **`get_observations`** - Récupérer les détails complets UNIQUEMENT pour les ID filtrés (~500-1 000 tokens/résultat) **Comment ça fonctionne :** -- Posez simplement des questions naturellement : *"Qu'avons-nous fait lors de la dernière session ?"* ou *"Avons-nous déjà corrigé ce bug ?"* -- Claude invoque automatiquement la compétence mem-search pour trouver le contexte pertinent +- Claude utilise les outils MCP pour rechercher dans votre mémoire +- Commencez par `search` pour obtenir un index des résultats +- Utilisez `timeline` pour voir ce qui se passait autour d'observations spécifiques +- Utilisez `get_observations` pour récupérer les détails complets des ID pertinents +- **Économie de tokens d'environ 10x** en filtrant avant de récupérer les détails -**Opérations de recherche disponibles :** +**Outils MCP disponibles :** -1. **Rechercher des observations** - Recherche plein texte dans les observations -2. **Rechercher des sessions** - Recherche plein texte dans les résumés de sessions -3. **Rechercher des invites** - Rechercher dans les demandes brutes des utilisateurs -4. **Par concept** - Trouver par étiquettes de concept (discovery, problem-solution, pattern, etc.) -5. **Par fichier** - Trouver les observations faisant référence à des fichiers spécifiques -6. **Par type** - Trouver par type (decision, bugfix, feature, refactor, discovery, change) -7. **Contexte récent** - Obtenir le contexte récent d'une session pour un projet -8. **Timeline** - Obtenir une chronologie unifiée du contexte autour d'un point spécifique dans le temps -9. **Timeline par requête** - Rechercher des observations et obtenir le contexte de la chronologie autour de la meilleure correspondance -10. **Aide API** - Obtenir la documentation de l'API de recherche +1. **`search`** - Recherche dans l'index de mémoire avec des requêtes en texte intégral, filtres par type/date/projet +2. **`timeline`** - Obtenir le contexte chronologique autour d'une observation ou d'une requête spécifique +3. **`get_observations`** - Récupérer les détails complets d'observations par ID (toujours regrouper plusieurs ID) -**Exemples de requêtes en langage naturel :** +**Exemple d'utilisation :** -``` -"Quels bugs avons-nous corrigés lors de la dernière session ?" -"Comment avons-nous implémenté l'authentification ?" -"Quels changements ont été apportés à worker-service.ts ?" -"Montrez-moi le travail récent sur ce projet" -"Que se passait-il lorsque nous avons ajouté l'interface de visualisation ?" +```typescript +// Étape 1 : Rechercher un index +search(query="authentication bug", type="bugfix", limit=10) + +// Étape 2 : Examiner l'index, identifier les ID pertinents (ex. #123, #456) + +// Étape 3 : Récupérer les détails complets +get_observations(ids=[123, 456]) ``` Voir le [Guide des outils de recherche](https://docs.claude-mem.ai/usage/search-tools) pour des exemples détaillés. --- -## Fonctionnalités bêta +## Branches de publication -Claude-Mem propose un **canal bêta** avec des fonctionnalités expérimentales comme le **mode Endless** (architecture de mémoire biomimétique pour les sessions étendues). Basculez entre les versions stables et bêta depuis l'interface web de visualisation à http://localhost:37777 → Paramètres. - -Voir la **[Documentation des fonctionnalités bêta](https://docs.claude-mem.ai/beta-features)** pour plus de détails sur le mode Endless et comment l'essayer. +Les versions stables sont publiées depuis `main` et diffusées sur npm. `core-dev` et +`community-edge` sont des branches exécutées depuis les sources pour les corrections de fiabilité +précoces et les intégrations communautaires. Voir **[Branches de publication](https://docs.claude-mem.ai/branches)** +pour le flux des branches et les instructions d'exécution non stables. --- @@ -226,6 +291,17 @@ Voir la **[Documentation des fonctionnalités bêta](https://docs.claude-mem.ai/ - **uv** : Gestionnaire de packages Python pour la recherche vectorielle (installé automatiquement si manquant) - **SQLite 3** : Pour le stockage persistant (inclus) +--- +### Remarques sur l'installation Windows + +Si vous voyez une erreur du type : + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Assurez-vous que Node.js et npm sont installés et ajoutés à votre PATH. Téléchargez le dernier programme d'installation de Node.js depuis https://nodejs.org et redémarrez votre terminal après l'installation. + --- ## Configuration @@ -234,6 +310,45 @@ Les paramètres sont gérés dans `~/.claude-mem/settings.json` (créé automati Voir le **[Guide de configuration](https://docs.claude-mem.ai/configuration)** pour tous les paramètres disponibles et des exemples. +### Configuration du mode et de la langue + +Claude-Mem prend en charge plusieurs modes de flux de travail et langues via le paramètre `CLAUDE_MEM_MODE`. + +Cette option contrôle à la fois : +- Le comportement du flux de travail (ex. code, chill, investigation) +- La langue utilisée dans les observations générées + +#### Comment configurer + +Modifiez votre fichier de paramètres à `~/.claude-mem/settings.json` : + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Les modes sont définis dans `plugin/modes/`. Pour voir tous les modes disponibles localement : + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Modes disponibles + +| Mode | Description | +|------------|-------------------------| +| `code` | Mode anglais par défaut | +| `code--zh` | Mode chinois simplifié | +| `code--ja` | Mode japonais | + +Les modes spécifiques à une langue suivent le modèle `code--[lang]` où `[lang]` est le code de langue ISO 639-1 (ex. `zh` pour le chinois, `ja` pour le japonais, `es` pour l'espagnol). + +> Remarque : `code--zh` (chinois simplifié) est déjà intégré — aucune installation supplémentaire ni mise à jour du plugin n'est nécessaire. + +#### Après avoir changé de mode + +Redémarrez Claude Code pour appliquer la nouvelle configuration de mode. --- ## Développement @@ -269,34 +384,48 @@ Les contributions sont les bienvenues ! Veuillez : 4. Mettre à jour la documentation 5. Soumettre une Pull Request +Claude-Mem est diffusé depuis trois branches : `main` (stable), `core-dev`, et +`community-edge`. Seule `main` est publiée sur npm ; les autres sont exécutées depuis +les sources. Voir [Branches de publication](https://docs.claude-mem.ai/branches) pour la +stratégie et les instructions d'exécution locale. + Voir le [Guide de développement](https://docs.claude-mem.ai/development) pour le flux de contribution. --- -## License +## Licence -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem est distribué sous la licence Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Nous avons choisi Apache-2.0 car une mémoire agentique durable doit pouvoir être facilement intégrée +dans les outils de développement, les agents locaux, les serveurs MCP, les systèmes d'entreprise, les +piles robotiques, et les infrastructures d'agents en production. -See the [LICENSE](LICENSE) file for full details. +Voir le fichier [LICENSE](LICENSE) pour tous les détails. Voir [docs/license.md](docs/license.md) +et [docs/ip-boundary.md](docs/ip-boundary.md) pour la portée de la licence et la frontière +entre open source et commercial. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Remarque sur Ragtime** : Le répertoire `ragtime/` est sous licence **Apache License 2.0**. Voir [ragtime/LICENSE](ragtime/LICENSE) pour plus de détails. --- - ## Support - **Documentation** : [docs/](docs/) - **Issues** : [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Dépôt** : [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Compte X officiel** : [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord officiel** : [Rejoindre Discord](https://discord.com/invite/J4wttp9vDu) - **Auteur** : Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Construit avec Claude Agent SDK** | **Propulsé par Claude Code** | **Fait avec TypeScript** +**Construit avec Claude Agent SDK** | **Fonctionne avec Claude Code** | **Fait avec TypeScript** ---- \ No newline at end of file +--- + +### Et le CMEM dans tout ça ? + +CMEM est un token créé par un tiers mais officiellement adopté par le créateur de Claude-Mem (Alex Newman, @thedotmack). Le token agit comme un catalyseur communautaire de croissance et un vecteur pour faire connaître CMEM aux développeurs et travailleurs du savoir qui en ont le plus besoin. + +CA officiel BASE : 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.he.md b/docs/i18n/README.he.md index cca81d313..3eaccaa5b 100644 --- a/docs/i18n/README.he.md +++ b/docs/i18n/README.he.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

מערכת דחיסת זיכרון מתמשך שנבנתה עבור Claude Code.

- License + License Version @@ -74,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

התחלה מהירה • @@ -93,35 +125,64 @@

- Claude-Mem משמר הקשר בצורה חלקה בין הפעלות על ידי לכידה אוטומטית של תצפיות על שימוש בכלים, יצירת סיכומים סמנטיים, והנגשתם להפעלות עתידיות. זה מאפשר ל-Claude לשמור על המשכיות של ידע על פרויקטים גם לאחר שהפעלות מסתיימות או מתחברות מחדש. + Claude-Mem משמר הקשר בצורה חלקה בין הפעלות על ידי לכידה אוטומטית של תצפיות על שימוש בכלים, יצירת סיכומים סמנטיים, והנגשתם להפעלות עתידיות. הדבר מאפשר ל-Claude לשמור על המשכיות של ידע לגבי פרויקטים גם לאחר שהפעלות מסתיימות או מתחברות מחדש.

--- ## התחלה מהירה -התחל הפעלה חדשה של Claude Code בטרמינל והזן את הפקודות הבאות: +התקן בפקודה בודדת: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +או התקן עבור OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +או התקן עבור Antigravity CLI ([מדריך הגדרה](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +או התקן משוק התוספים בתוך Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` הפעל מחדש את Claude Code. הקשר מהפעלות קודמות יופיע אוטומטית בהפעלות חדשות. +> **הערה:** Claude-Mem מפורסם גם ב-npm, אך `npm install -g claude-mem` מתקין רק את **ה-SDK/ספרייה** — הוא אינו רושם את hooks התוסף ואינו מגדיר את שירות ה-worker. תמיד יש להתקין באמצעות `npx claude-mem install` או פקודות `/plugin` שלעיל. + +### 🦞 OpenClaw Gateway + +התקן את claude-mem כתוסף זיכרון מתמשך על שערי [OpenClaw](https://openclaw.ai) בפקודה בודדת: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +תוכנת ההתקנה מטפלת בתלויות, בהגדרת התוסף, בהגדרת ספק ה-AI, בהפעלת ה-worker, ובאפשרות להזין זרימות תצפיות בזמן אמת ל-Telegram, Discord, Slack ועוד. עיין ב[מדריך שילוב OpenClaw](https://docs.claude-mem.ai/openclaw-integration) לפרטים. + **תכונות עיקריות:** - 🧠 **זיכרון מתמשך** - הקשר שורד בין הפעלות - 📊 **גילוי מדורג** - אחזור זיכרון רב-שכבתי עם נראות עלות טוקנים - 🔍 **חיפוש מבוסס-מיומנויות** - שאל את היסטוריית הפרויקט שלך עם מיומנות mem-search -- 🖥️ **ממשק צופה אינטרנט** - זרימת זיכרון בזמן אמת ב-http://localhost:37777 +- 🖥️ **ממשק צופה אינטרנט** - זרימת זיכרון בזמן אמת בכתובת ה-worker שמודפסת בעת ההפעלה - 💻 **מיומנות Claude Desktop** - חפש זיכרון משיחות Claude Desktop - 🔒 **בקרת פרטיות** - השתמש בתגיות `` כדי להוציא תוכן רגיש מהאחסון - ⚙️ **הגדרות הקשר** - בקרה מדויקת על איזה הקשר מוזרק - 🤖 **פעולה אוטומטית** - אין צורך בהתערבות ידנית -- 🔗 **ציטוטים** - הפנה לתצפיות קודמות עם מזהים (גישה דרך http://localhost:37777/api/observation/{id} או צפה בכולם בצופה האינטרנט ב-http://localhost:37777) -- 🧪 **ערוץ בטא** - נסה תכונות ניסיוניות כמו Endless Mode דרך החלפת גרסאות +- 🔗 **ציטוטים** - הפנה לתצפיות קודמות עם מזהים דרך ה-API של ה-worker או צפה בכולם בצופה האינטרנט --- @@ -134,7 +195,6 @@ - **[מדריך התקנה](https://docs.claude-mem.ai/installation)** - התחלה מהירה והתקנה מתקדמת - **[מדריך שימוש](https://docs.claude-mem.ai/usage/getting-started)** - איך Claude-Mem עובד אוטומטית - **[כלי חיפוש](https://docs.claude-mem.ai/usage/search-tools)** - שאל את היסטוריית הפרויקט שלך בשפה טבעית -- **[תכונות בטא](https://docs.claude-mem.ai/beta-features)** - נסה תכונות ניסיוניות כמו Endless Mode ### שיטות מומלצות @@ -144,7 +204,7 @@ ### ארכיטקטורה - **[סקירה כללית](https://docs.claude-mem.ai/architecture/overview)** - רכיבי המערכת וזרימת הנתונים -- **[התפתחות הארכיטקטורה](https://docs.claude-mem.ai/architecture-evolution)** - המסע מגרסה 3 לגרסה 5 +- **[התפתחות הארכיטקטורה](https://docs.claude-mem.ai/architecture-evolution)** - המסע מגרסה v3 לגרסה v5 - **[ארכיטקטורת Hooks](https://docs.claude-mem.ai/hooks-architecture)** - איך Claude-Mem משתמש ב-lifecycle hooks - **[מדריך Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 סקריפטי hook מוסברים - **[שירות Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API וניהול Bun @@ -155,6 +215,7 @@ - **[הגדרות](https://docs.claude-mem.ai/configuration)** - משתני סביבה והגדרות - **[פיתוח](https://docs.claude-mem.ai/development)** - בנייה, בדיקה, תרומה +- **[ענפי שחרור](https://docs.claude-mem.ai/branches)** - זרימת הענפים Stable, core-dev, ו-community-edge - **[פתרון בעיות](https://docs.claude-mem.ai/troubleshooting)** - בעיות נפוצות ופתרונות --- @@ -165,7 +226,7 @@ 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 סקריפטי hook) 2. **התקנה חכמה** - בודק תלויות עם מטמון (סקריפט pre-hook, לא lifecycle hook) -3. **שירות Worker** - HTTP API על פורט 37777 עם ממשק צופה אינטרנט ו-10 נקודות קצה לחיפוש, מנוהל על ידי Bun +3. **שירות Worker** - HTTP API מקומי עם ממשק צופה אינטרנט ונקודות קצה לחיפוש, מנוהל על ידי Bun 4. **מסד נתוני SQLite** - מאחסן הפעלות, תצפיות, סיכומים 5. **מיומנות mem-search** - שאילתות בשפה טבעית עם גילוי מדורג 6. **מסד נתוני וקטורים Chroma** - חיפוש היברידי סמנטי + מילות מפתח לאחזור הקשר חכם @@ -174,46 +235,51 @@ --- -## מיומנות mem-search +## כלי חיפוש MCP -Claude-Mem מספק חיפוש חכם דרך מיומנות mem-search שמופעלת אוטומטית כשאתה שואל על עבודה קודמת: +Claude-Mem מספק חיפוש זיכרון חכם באמצעות **4 כלי MCP** לפי דפוס עבודה **תלת-שכבתי** יעיל מבחינת טוקנים: + +**דפוס העבודה התלת-שכבתי:** + +1. **`search`** - קבל אינדקס קומפקטי עם מזהים (כ-50-100 טוקנים לתוצאה) +2. **`timeline`** - קבל הקשר כרונולוגי סביב תוצאות מעניינות +3. **`get_observations`** - שלוף פרטים מלאים רק עבור מזהים מסוננים (כ-500-1,000 טוקנים לתוצאה) **איך זה עובד:** -- פשוט שאל באופן טבעי: *"מה עשינו בהפעלה האחרונה?"* או *"תיקנו את הבאג הזה קודם?"* -- Claude מפעיל אוטומטית את מיומנות mem-search כדי למצוא הקשר רלוונטי +- Claude משתמש בכלי MCP כדי לחפש בזיכרון שלך +- התחל עם `search` כדי לקבל אינדקס של תוצאות +- השתמש ב-`timeline` כדי לראות מה קרה סביב תצפיות ספציפיות +- השתמש ב-`get_observations` כדי לשלוף פרטים מלאים עבור מזהים רלוונטיים +- **חיסכון של פי 10 בטוקנים** על ידי סינון לפני שליפת הפרטים -**פעולות חיפוש זמינות:** +**כלי MCP זמינים:** -1. **חיפוש תצפיות** - חיפוש טקסט מלא על פני תצפיות -2. **חיפוש הפעלות** - חיפוש טקסט מלא על פני סיכומי הפעלות -3. **חיפוש Prompts** - חיפוש בקשות משתמש גולמיות -4. **לפי מושג** - חיפוש לפי תגיות מושג (discovery, problem-solution, pattern, וכו') -5. **לפי קובץ** - חיפוש תצפיות המתייחסות לקבצים ספציפיים -6. **לפי סוג** - חיפוש לפי סוג (decision, bugfix, feature, refactor, discovery, change) -7. **הקשר אחרון** - קבל הקשר הפעלות אחרון לפרויקט -8. **ציר זמן** - קבל ציר זמן מאוחד של הקשר סביב נקודת זמן ספציפית -9. **ציר זמן לפי שאילתה** - חפש תצפיות וקבל הקשר ציר זמן סביב ההתאמה הטובה ביותר -10. **עזרה ל-API** - קבל תיעוד API חיפוש +1. **`search`** - חפש באינדקס הזיכרון עם שאילתות טקסט מלא, סינון לפי סוג/תאריך/פרויקט +2. **`timeline`** - קבל הקשר כרונולוגי סביב תצפית או שאילתה ספציפית +3. **`get_observations`** - שלוף פרטי תצפית מלאים לפי מזהים (תמיד קבץ מספר מזהים יחד) -**דוגמאות לשאילתות בשפה טבעית:** +**דוגמת שימוש:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// שלב 1: חיפוש לצורך קבלת אינדקס +search(query="authentication bug", type="bugfix", limit=10) + +// שלב 2: סקור את האינדקס, זהה מזהים רלוונטיים (למשל, #123, #456) + +// שלב 3: שלוף פרטים מלאים +get_observations(ids=[123, 456]) ``` ראה [מדריך כלי חיפוש](https://docs.claude-mem.ai/usage/search-tools) לדוגמאות מפורטות. --- -## תכונות בטא +## ענפי שחרור -Claude-Mem מציע **ערוץ בטא** עם תכונות ניסיוניות כמו **Endless Mode** (ארכיטקטורת זיכרון ביומימטית להפעלות מורחבות). החלף בין גרסאות יציבות ובטא מממשק הצופה האינטרנט ב-http://localhost:37777 → Settings. - -ראה **[תיעוד תכונות בטא](https://docs.claude-mem.ai/beta-features)** לפרטים על Endless Mode ואיך לנסות אותו. +שחרורים יציבים משוחררים מהענף `main` ומפורסמים ל-npm. `core-dev` ו- +`community-edge` הם ענפים המורצים ממקור, המיועדים לתיקוני יציבות מוקדמים ולשילובים +קהילתיים. ראה **[ענפי שחרור](https://docs.claude-mem.ai/branches)** +לזרימת הענפים ולהוראות הרצה לא-יציבות. --- @@ -225,6 +291,17 @@ Claude-Mem מציע **ערוץ בטא** עם תכונות ניסיוניות כ - **uv**: מנהל חבילות Python לחיפוש וקטורי (מותקן אוטומטית אם חסר) - **SQLite 3**: לאחסון מתמשך (מצורף) +--- +### הערות התקנה עבור Windows + +אם אתה נתקל בשגיאה כמו: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +ודא ש-Node.js ו-npm מותקנים ומוספים ל-PATH שלך. הורד את תוכנת ההתקנה העדכנית ביותר של Node.js מ-https://nodejs.org והפעל מחדש את הטרמינל שלך לאחר ההתקנה. + --- ## הגדרות @@ -233,6 +310,45 @@ Claude-Mem מציע **ערוץ בטא** עם תכונות ניסיוניות כ ראה **[מדריך הגדרות](https://docs.claude-mem.ai/configuration)** לכל ההגדרות הזמינות ודוגמאות. +### הגדרת מצב ושפה + +Claude-Mem תומך במספר מצבי עבודה ושפות דרך ההגדרה `CLAUDE_MEM_MODE`. + +אפשרות זו שולטת בשני דברים: +- התנהגות זרימת העבודה (למשל code, chill, investigation) +- השפה המשמשת בתצפיות שנוצרות + +#### איך להגדיר + +ערוך את קובץ ההגדרות שלך ב-`~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +מצבים מוגדרים ב-`plugin/modes/`. כדי לראות את כל המצבים הזמינים מקומית: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### מצבים זמינים + +| מצב | תיאור | +|------------|-------------------------| +| `code` | מצב ברירת מחדל באנגלית | +| `code--zh` | מצב סינית פשוטה | +| `code--ja` | מצב יפנית | + +מצבי שפה ספציפיים עוקבים אחר התבנית `code--[lang]` כאשר `[lang]` הוא קוד השפה בתקן ISO 639-1 (למשל, `zh` עבור סינית, `ja` עבור יפנית, `es` עבור ספרדית). + +> הערה: `code--zh` (סינית פשוטה) כבר מובנה — אין צורך בהתקנה נוספת או עדכון תוסף. + +#### לאחר שינוי מצב + +הפעל מחדש את Claude Code כדי להחיל את הגדרת המצב החדשה. --- ## פיתוח @@ -268,32 +384,48 @@ npm run bug-report 4. עדכן תיעוד 5. שלח Pull Request +Claude-Mem משוחרר משלושה ענפים: `main` (יציב), `core-dev`, ו- +`community-edge`. רק `main` מפורסם ל-npm; האחרים מורצים ממקור. +ראה [ענפי שחרור](https://docs.claude-mem.ai/branches) לאסטרטגיה ולהוראות +הרצה מקומיות. + ראה [מדריך פיתוח](https://docs.claude-mem.ai/development) לתהליך תרומה. --- -## License +## רישיון -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem מופץ תחת רישיון Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +בחרנו ב-Apache-2.0 מכיוון שזיכרון סוכני עמיד צריך להיות קל לשילוב בכלי +פיתוח, בסוכנים מקומיים, בשרתי MCP, במערכות ארגוניות, במערכי רובוטיקה, +ובתשתיות סוכנים בייצור. -See the [LICENSE](LICENSE) file for full details. +ראה את קובץ ה-[LICENSE](LICENSE) לפרטים מלאים. ראה [docs/license.md](docs/license.md) +ו-[docs/ip-boundary.md](docs/ip-boundary.md) להיקף הרישוי ולגבול +הקוד הפתוח/מסחרי. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**הערה בנוגע ל-Ragtime**: הספרייה `ragtime/` מופצת תחת **Apache License 2.0**. ראה [ragtime/LICENSE](ragtime/LICENSE) לפרטים. --- - ## תמיכה - **תיעוד**: [docs/](docs/) - **בעיות**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **מאגר**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **חשבון X רשמי**: [@Claude_Memory](https://x.com/Claude_Memory) +- **דיסקורד רשמי**: [הצטרף לדיסקורד](https://discord.com/invite/J4wttp9vDu) - **מחבר**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**נבנה עם Claude Agent SDK** | **מופעל על ידי Claude Code** | **נוצר עם TypeScript** \ No newline at end of file +**נבנה עם Claude Agent SDK** | **פועל עם Claude Code** | **נוצר עם TypeScript** + +--- + +### מה לגבי CMEM? + +CMEM הוא טוקן שנוצר על ידי צד שלישי, אך מקבל תמיכה רשמית מיוצר Claude-Mem (Alex Newman, @thedotmack). הטוקן משמש כזרז קהילתי לצמיחה וככלי להנגשת CMEM למפתחים ולעובדי ידע הזקוקים לו ביותר. + +כתובת חוזה רשמית ברשת BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.hi.md b/docs/i18n/README.hi.md index 401c60580..08f2614b3 100644 --- a/docs/i18n/README.hi.md +++ b/docs/i18n/README.hi.md @@ -1,6 +1,5 @@ 🌐 यह एक स्वचालित अनुवाद है। समुदाय से सुधार का स्वागत है! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code के लिए बनाई गई स्थायी मेमोरी संपीड़न प्रणाली।

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

त्वरित शुरुआत • @@ -101,28 +132,57 @@ ## त्वरित शुरुआत -टर्मिनल में एक नया Claude Code सत्र शुरू करें और निम्नलिखित कमांड दर्ज करें: +एक ही कमांड से इंस्टॉल करें: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +या OpenCode के लिए इंस्टॉल करें: + +```bash +npx claude-mem install --ide opencode +``` + +या Antigravity CLI के लिए इंस्टॉल करें ([सेटअप गाइड](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +या Claude Code के अंदर प्लगइन मार्केटप्लेस से इंस्टॉल करें: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Claude Code को पुनः आरंभ करें। पिछले सत्रों का संदर्भ स्वचालित रूप से नए सत्रों में दिखाई देगा। +> **नोट:** Claude-Mem npm पर भी प्रकाशित है, लेकिन `npm install -g claude-mem` केवल **SDK/लाइब्रेरी** इंस्टॉल करता है — यह प्लगइन hooks को रजिस्टर नहीं करता और न ही worker सेवा सेट अप करता है। हमेशा `npx claude-mem install` या ऊपर दिए गए `/plugin` कमांड्स के माध्यम से ही इंस्टॉल करें। + +### 🦞 OpenClaw Gateway + +एक ही कमांड से [OpenClaw](https://openclaw.ai) gateways पर claude-mem को स्थायी मेमोरी प्लगइन के रूप में इंस्टॉल करें: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +इंस्टॉलर डिपेंडेंसीज़, प्लगइन सेटअप, AI प्रोवाइडर कॉन्फ़िगरेशन, worker स्टार्टअप, और Telegram, Discord, Slack, और अन्य प्लेटफ़ॉर्म्स पर वैकल्पिक रीयल-टाइम अवलोकन फ़ीड को संभालता है। विवरण के लिए [OpenClaw एकीकरण गाइड](https://docs.claude-mem.ai/openclaw-integration) देखें। + **मुख्य विशेषताएं:** - 🧠 **स्थायी मेमोरी** - संदर्भ सत्रों में बना रहता है - 📊 **प्रगतिशील प्रकटीकरण** - टोकन लागत दृश्यता के साथ स्तरित मेमोरी पुनर्प्राप्ति - 🔍 **स्किल-आधारित खोज** - mem-search स्किल के साथ अपने प्रोजेक्ट इतिहास को क्वेरी करें -- 🖥️ **वेब व्यूअर UI** - http://localhost:37777 पर रीयल-टाइम मेमोरी स्ट्रीम +- 🖥️ **वेब व्यूअर UI** - स्टार्टअप पर प्रिंट किए गए worker URL पर रीयल-टाइम मेमोरी स्ट्रीम - 💻 **Claude Desktop स्किल** - Claude Desktop वार्तालापों से मेमोरी खोजें - 🔒 **गोपनीयता नियंत्रण** - संवेदनशील सामग्री को स्टोरेज से बाहर रखने के लिए `` टैग का उपयोग करें - ⚙️ **संदर्भ कॉन्फ़िगरेशन** - किस संदर्भ को इंजेक्ट किया जाता है, इस पर सूक्ष्म नियंत्रण - 🤖 **स्वचालित संचालन** - मैन्युअल हस्तक्षेप की आवश्यकता नहीं -- 🔗 **उद्धरण** - IDs के साथ पिछले अवलोकनों का संदर्भ दें (http://localhost:37777/api/observation/{id} के माध्यम से एक्सेस करें या http://localhost:37777 पर वेब व्यूअर में सभी देखें) -- 🧪 **बीटा चैनल** - संस्करण स्विचिंग के माध्यम से Endless Mode जैसी प्रायोगिक सुविधाओं को आज़माएं +- 🔗 **उद्धरण** - worker API के माध्यम से IDs के साथ पिछले अवलोकनों का संदर्भ दें या वेब व्यूअर में सभी देखें --- @@ -135,7 +195,6 @@ Claude Code को पुनः आरंभ करें। पिछले स - **[इंस्टॉलेशन गाइड](https://docs.claude-mem.ai/installation)** - त्वरित शुरुआत और उन्नत इंस्टॉलेशन - **[उपयोग गाइड](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem स्वचालित रूप से कैसे काम करता है - **[खोज उपकरण](https://docs.claude-mem.ai/usage/search-tools)** - प्राकृतिक भाषा के साथ अपने प्रोजेक्ट इतिहास को क्वेरी करें -- **[बीटा सुविधाएं](https://docs.claude-mem.ai/beta-features)** - Endless Mode जैसी प्रायोगिक सुविधाओं को आज़माएं ### सर्वोत्तम अभ्यास @@ -156,6 +215,7 @@ Claude Code को पुनः आरंभ करें। पिछले स - **[कॉन्फ़िगरेशन](https://docs.claude-mem.ai/configuration)** - पर्यावरण चर और सेटिंग्स - **[विकास](https://docs.claude-mem.ai/development)** - बिल्डिंग, परीक्षण, योगदान +- **[रिलीज़ ब्रांच](https://docs.claude-mem.ai/branches)** - स्थिर, core-dev, और community-edge ब्रांच प्रवाह - **[समस्या निवारण](https://docs.claude-mem.ai/troubleshooting)** - सामान्य समस्याएं और समाधान --- @@ -166,7 +226,7 @@ Claude Code को पुनः आरंभ करें। पिछले स 1. **5 जीवनचक्र Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook स्क्रिप्ट) 2. **स्मार्ट इंस्टॉल** - कैश्ड डिपेंडेंसी चेकर (pre-hook स्क्रिप्ट, जीवनचक्र hook नहीं) -3. **Worker सेवा** - वेब व्यूअर UI और 10 खोज endpoints के साथ पोर्ट 37777 पर HTTP API, Bun द्वारा प्रबंधित +3. **Worker सेवा** - वेब व्यूअर UI और खोज endpoints के साथ लोकल HTTP API, Bun द्वारा प्रबंधित 4. **SQLite डेटाबेस** - सत्र, अवलोकन, सारांश संग्रहीत करता है 5. **mem-search स्किल** - प्रगतिशील प्रकटीकरण के साथ प्राकृतिक भाषा क्वेरी 6. **Chroma वेक्टर डेटाबेस** - बुद्धिमान संदर्भ पुनर्प्राप्ति के लिए हाइब्रिड सिमेंटिक + कीवर्ड खोज @@ -175,46 +235,51 @@ Claude Code को पुनः आरंभ करें। पिछले स --- -## mem-search स्किल +## MCP खोज उपकरण -Claude-Mem mem-search स्किल के माध्यम से बुद्धिमान खोज प्रदान करता है जो स्वचालित रूप से सक्रिय हो जाती है जब आप पिछले काम के बारे में पूछते हैं: +Claude-Mem एक टोकन-कुशल **3-लेयर वर्कफ़्लो पैटर्न** का पालन करते हुए **4 MCP टूल्स** के माध्यम से बुद्धिमान मेमोरी खोज प्रदान करता है: + +**3-लेयर वर्कफ़्लो:** + +1. **`search`** - IDs के साथ कॉम्पैक्ट इंडेक्स प्राप्त करें (~50-100 टोकन/परिणाम) +2. **`timeline`** - दिलचस्प परिणामों के आसपास कालानुक्रमिक संदर्भ प्राप्त करें +3. **`get_observations`** - केवल फ़िल्टर किए गए IDs के लिए पूर्ण विवरण प्राप्त करें (~500-1,000 टोकन/परिणाम) **यह कैसे काम करता है:** -- बस स्वाभाविक रूप से पूछें: *"हमने पिछले सत्र में क्या किया?"* या *"क्या हमने पहले इस बग को ठीक किया था?"* -- Claude स्वचालित रूप से प्रासंगिक संदर्भ खोजने के लिए mem-search स्किल को सक्रिय करता है +- Claude आपकी मेमोरी खोजने के लिए MCP टूल्स का उपयोग करता है +- परिणामों का एक इंडेक्स प्राप्त करने के लिए `search` से शुरू करें +- विशिष्ट अवलोकनों के आसपास क्या हो रहा था यह देखने के लिए `timeline` का उपयोग करें +- प्रासंगिक IDs के लिए पूर्ण विवरण प्राप्त करने के लिए `get_observations` का उपयोग करें +- विवरण प्राप्त करने से पहले फ़िल्टर करके **~10x टोकन बचत** -**उपलब्ध खोज संचालन:** +**उपलब्ध MCP टूल्स:** -1. **अवलोकन खोजें** - अवलोकनों में पूर्ण-पाठ खोज -2. **सत्र खोजें** - सत्र सारांशों में पूर्ण-पाठ खोज -3. **प्रॉम्प्ट खोजें** - कच्चे उपयोगकर्ता अनुरोध खोजें -4. **अवधारणा द्वारा** - अवधारणा टैग द्वारा खोजें (discovery, problem-solution, pattern, आदि) -5. **फ़ाइल द्वारा** - विशिष्ट फ़ाइलों का संदर्भ देने वाले अवलोकन खोजें -6. **प्रकार द्वारा** - प्रकार द्वारा खोजें (decision, bugfix, feature, refactor, discovery, change) -7. **हालिया संदर्भ** - एक प्रोजेक्ट के लिए हालिया सत्र संदर्भ प्राप्त करें -8. **टाइमलाइन** - समय में एक विशिष्ट बिंदु के आसपास संदर्भ की एकीकृत टाइमलाइन प्राप्त करें -9. **क्वेरी द्वारा टाइमलाइन** - अवलोकनों को खोजें और सर्वश्रेष्ठ मिलान के आसपास टाइमलाइन संदर्भ प्राप्त करें -10. **API सहायता** - खोज API दस्तावेज़ीकरण प्राप्त करें +1. **`search`** - पूर्ण-पाठ क्वेरी के साथ मेमोरी इंडेक्स खोजें, प्रकार/तिथि/प्रोजेक्ट के अनुसार फ़िल्टर करें +2. **`timeline`** - किसी विशिष्ट अवलोकन या क्वेरी के आसपास कालानुक्रमिक संदर्भ प्राप्त करें +3. **`get_observations`** - IDs द्वारा पूर्ण अवलोकन विवरण प्राप्त करें (हमेशा कई IDs को बैच करें) -**प्राकृतिक भाषा क्वेरी के उदाहरण:** +**उपयोग उदाहरण:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// चरण 1: इंडेक्स के लिए खोजें +search(query="authentication bug", type="bugfix", limit=10) + +// चरण 2: इंडेक्स की समीक्षा करें, प्रासंगिक IDs की पहचान करें (जैसे, #123, #456) + +// चरण 3: पूर्ण विवरण प्राप्त करें +get_observations(ids=[123, 456]) ``` विस्तृत उदाहरणों के लिए [खोज उपकरण गाइड](https://docs.claude-mem.ai/usage/search-tools) देखें। --- -## बीटा सुविधाएं +## रिलीज़ ब्रांच -Claude-Mem **बीटा चैनल** के साथ **Endless Mode** (विस्तारित सत्रों के लिए बायोमिमेटिक मेमोरी आर्किटेक्चर) जैसी प्रायोगिक सुविधाएं प्रदान करता है। http://localhost:37777 → Settings पर वेब व्यूअर UI से स्थिर और बीटा संस्करणों के बीच स्विच करें। - -Endless Mode के विवरण और इसे आज़माने के तरीके के लिए **[बीटा सुविधाएं दस्तावेज़ीकरण](https://docs.claude-mem.ai/beta-features)** देखें। +स्थिर रिलीज़ `main` से शिप होती हैं और npm पर प्रकाशित होती हैं। `core-dev` और +`community-edge` शुरुआती विश्वसनीयता सुधारों और सामुदायिक एकीकरण के लिए +सोर्स-रन ब्रांच हैं। ब्रांच प्रवाह और गैर-स्थिर रन निर्देशों के लिए +**[रिलीज़ ब्रांच](https://docs.claude-mem.ai/branches)** देखें। --- @@ -226,6 +291,17 @@ Endless Mode के विवरण और इसे आज़माने क - **uv**: वेक्टर खोज के लिए Python पैकेज मैनेजर (यदि गायब हो तो ऑटो-इंस्टॉल) - **SQLite 3**: स्थायी स्टोरेज के लिए (बंडल किया गया) +--- +### Windows सेटअप नोट्स + +यदि आपको इस तरह की त्रुटि दिखाई देती है: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +सुनिश्चित करें कि Node.js और npm इंस्टॉल हैं और आपके PATH में जोड़े गए हैं। https://nodejs.org से नवीनतम Node.js इंस्टॉलर डाउनलोड करें और इंस्टॉलेशन के बाद अपना टर्मिनल पुनः आरंभ करें। + --- ## कॉन्फ़िगरेशन @@ -234,6 +310,45 @@ Endless Mode के विवरण और इसे आज़माने क सभी उपलब्ध सेटिंग्स और उदाहरणों के लिए **[कॉन्फ़िगरेशन गाइड](https://docs.claude-mem.ai/configuration)** देखें। +### मोड और भाषा कॉन्फ़िगरेशन + +Claude-Mem `CLAUDE_MEM_MODE` सेटिंग के माध्यम से कई वर्कफ़्लो मोड और भाषाओं का समर्थन करता है। + +यह विकल्प दोनों को नियंत्रित करता है: +- वर्कफ़्लो व्यवहार (जैसे code, chill, investigation) +- जनरेट किए गए अवलोकनों में उपयोग की जाने वाली भाषा + +#### कॉन्फ़िगर कैसे करें + +अपनी सेटिंग्स फ़ाइल को `~/.claude-mem/settings.json` पर संपादित करें: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +मोड `plugin/modes/` में परिभाषित हैं। स्थानीय रूप से सभी उपलब्ध मोड देखने के लिए: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### उपलब्ध मोड + +| मोड | विवरण | +|------------|-------------------------| +| `code` | डिफ़ॉल्ट अंग्रेज़ी मोड | +| `code--zh` | सरलीकृत चीनी मोड | +| `code--ja` | जापानी मोड | + +भाषा-विशिष्ट मोड `code--[lang]` पैटर्न का पालन करते हैं जहां `[lang]` ISO 639-1 भाषा कोड है (जैसे, चीनी के लिए `zh`, जापानी के लिए `ja`, स्पेनिश के लिए `es`)। + +> नोट: `code--zh` (सरलीकृत चीनी) पहले से ही बिल्ट-इन है — किसी अतिरिक्त इंस्टॉलेशन या प्लगइन अपडेट की आवश्यकता नहीं है। + +#### मोड बदलने के बाद + +नई मोड कॉन्फ़िगरेशन लागू करने के लिए Claude Code को पुनः आरंभ करें। --- ## विकास @@ -269,34 +384,47 @@ npm run bug-report 4. दस्तावेज़ीकरण अपडेट करें 5. एक Pull Request सबमिट करें +Claude-Mem तीन ब्रांच से शिप होता है: `main` (स्थिर), `core-dev`, और +`community-edge`। केवल `main` npm पर प्रकाशित होता है; अन्य सोर्स से +रन किए जाते हैं। रणनीति और लोकल रन निर्देशों के लिए [रिलीज़ ब्रांच](https://docs.claude-mem.ai/branches) देखें। + योगदान वर्कफ़्लो के लिए [विकास गाइड](https://docs.claude-mem.ai/development) देखें। --- -## License +## लाइसेंस -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem को Apache License 2.0 के तहत लाइसेंस प्राप्त है। -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +हमने Apache-2.0 इसलिए चुना क्योंकि स्थायी एजेंटिक मेमोरी को डेवलपर टूल्स, लोकल एजेंट्स, +MCP सर्वर, एंटरप्राइज़ सिस्टम, रोबोटिक्स स्टैक्स, और प्रोडक्शन एजेंट हार्नेस में +आसानी से एम्बेड करने योग्य होना चाहिए। -See the [LICENSE](LICENSE) file for full details. +पूर्ण विवरण के लिए [LICENSE](LICENSE) फ़ाइल देखें। लाइसेंसिंग स्कोप और +ओपन/कमर्शियल सीमा के लिए [docs/license.md](docs/license.md) +और [docs/ip-boundary.md](docs/ip-boundary.md) देखें। -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtime पर नोट**: `ragtime/` डायरेक्टरी **Apache License 2.0** के तहत लाइसेंस प्राप्त है। विवरण के लिए [ragtime/LICENSE](ragtime/LICENSE) देखें। --- - ## समर्थन - **दस्तावेज़ीकरण**: [docs/](docs/) - **समस्याएं**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **रिपॉजिटरी**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **आधिकारिक X अकाउंट**: [@Claude_Memory](https://x.com/Claude_Memory) +- **आधिकारिक Discord**: [Discord से जुड़ें](https://discord.com/invite/J4wttp9vDu) - **लेखक**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Claude Agent SDK के साथ निर्मित** | **Claude Code द्वारा संचालित** | **TypeScript के साथ बनाया गया** +**Claude Agent SDK के साथ निर्मित** | **Claude Code के साथ काम करता है** | **TypeScript के साथ बनाया गया** ---- \ No newline at end of file +--- + +### CMEM के बारे में क्या? + +CMEM एक ऐसा टोकन है जिसे किसी तीसरे पक्ष द्वारा बनाया गया है लेकिन Claude-Mem के निर्माता (Alex Newman, @thedotmack) द्वारा आधिकारिक रूप से अपनाया गया है। यह टोकन विकास के लिए एक सामुदायिक उत्प्रेरक और CMEM को उन डेवलपर्स और नॉलेज वर्कर्स तक पहुंचाने का एक माध्यम है जिन्हें इसकी सबसे ज़्यादा ज़रूरत है। + +आधिकारिक BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.hu.md b/docs/i18n/README.hu.md index 553621243..7a837eecc 100644 --- a/docs/i18n/README.hu.md +++ b/docs/i18n/README.hu.md @@ -1,6 +1,5 @@ 🌐 Ez egy automatikus fordítás. Közösségi javítások szívesen fogadottak! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Tartós memória tömörítési rendszer a Claude Code számára.

- License + License Version @@ -75,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Gyors kezdés • Hogyan működik • - Keresési eszközök • + Keresési eszközök • Dokumentáció • Konfiguráció • Hibaelhárítás • @@ -101,28 +132,57 @@ ## Gyors kezdés -Indítson el egy új Claude Code munkamenetet a terminálban, és írja be a következő parancsokat: +Telepítés egyetlen paranccsal: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Vagy telepítés OpenCode-hoz: + +```bash +npx claude-mem install --ide opencode +``` + +Vagy telepítés Antigravity CLI-hez ([beállítási útmutató](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Vagy telepítés a plugin marketplace-ről a Claude Code-on belül: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusan megjelenik az új munkamenetekben. +> **Megjegyzés:** A Claude-Mem az npm-en is elérhető, de az `npm install -g claude-mem` csak a **SDK/könyvtár** részt telepíti — nem regisztrálja a plugin hookokat, és nem állítja be a worker szolgáltatást. Mindig a `npx claude-mem install` vagy a fenti `/plugin` parancsok segítségével telepítsen. + +### 🦞 OpenClaw Gateway + +Telepítse a claude-mem-et tartós memória pluginként az [OpenClaw](https://openclaw.ai) gateway-eken egyetlen paranccsal: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +A telepítő kezeli a függőségeket, a plugin beállítását, az AI szolgáltató konfigurációját, a worker indítását, valamint az opcionális valós idejű megfigyelési feedeket Telegramra, Discordra, Slackre és másokra. Részletekért lásd az [OpenClaw integrációs útmutatót](https://docs.claude-mem.ai/openclaw-integration). + **Főbb jellemzők:** - 🧠 **Tartós memória** - A kontextus túléli a munkameneteket - 📊 **Progresszív felfedés** - Többrétegű memória-visszakeresés token költség láthatósággal - 🔍 **Skill-alapú keresés** - Lekérdezheti projekt előzményeit a mem-search skill segítségével -- 🖥️ **Webes megjelenítő felület** - Valós idejű memória stream a http://localhost:37777 címen +- 🖥️ **Webes megjelenítő felület** - Valós idejű memória stream a worker indításakor kiírt URL-en - 💻 **Claude Desktop Skill** - Memória keresése Claude Desktop beszélgetésekből - 🔒 **Adatvédelmi kontroll** - Használja a `` címkéket az érzékeny tartalom kizárásához - ⚙️ **Kontextus konfiguráció** - Finomhangolt kontroll afelett, hogy milyen kontextus kerül beillesztésre - 🤖 **Automatikus működés** - Nincs szükség manuális beavatkozásra -- 🔗 **Hivatkozások** - Hivatkozás múltbeli megfigyelésekre ID-kkal (hozzáférés: http://localhost:37777/api/observation/{id} vagy mindegyik megtekintése a webes felületen a http://localhost:37777 címen) -- 🧪 **Béta csatorna** - Kísérleti funkciók, mint az Endless Mode kipróbálása verziócserével +- 🔗 **Hivatkozások** - Hivatkozás múltbeli megfigyelésekre ID-k alapján a worker API-n keresztül, vagy megtekintés a webes felületen --- @@ -135,7 +195,6 @@ Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusa - **[Telepítési útmutató](https://docs.claude-mem.ai/installation)** - Gyors indítás és haladó telepítés - **[Használati útmutató](https://docs.claude-mem.ai/usage/getting-started)** - Hogyan működik automatikusan a Claude-Mem - **[Keresési eszközök](https://docs.claude-mem.ai/usage/search-tools)** - Projekt előzmények lekérdezése természetes nyelvvel -- **[Béta funkciók](https://docs.claude-mem.ai/beta-features)** - Kísérleti funkciók, mint az Endless Mode kipróbálása ### Bevált gyakorlatok @@ -156,6 +215,7 @@ Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusa - **[Konfiguráció](https://docs.claude-mem.ai/configuration)** - Környezeti változók és beállítások - **[Fejlesztés](https://docs.claude-mem.ai/development)** - Építés, tesztelés, hozzájárulás +- **[Kiadási ágak](https://docs.claude-mem.ai/branches)** - A stable, core-dev és community-edge ágak folyamata - **[Hibaelhárítás](https://docs.claude-mem.ai/troubleshooting)** - Gyakori problémák és megoldások --- @@ -165,56 +225,61 @@ Indítsa újra a Claude Code-ot. A korábbi munkamenetek kontextusa automatikusa **Fő komponensek:** 1. **5 életciklus hook** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook szkript) -2. **Intelligens telepítés** - Gyorsítótárazott függőség ellenőrző (pre-hook szkript, nem életciklus hook) -3. **Worker szolgáltatás** - HTTP API a 37777-es porton webes megjelenítő felülettel és 10 keresési végponttal, Bun által kezelve +2. **Intelligens telepítés** - Gyorsítótárazott függőségellenőrző (pre-hook szkript, nem életciklus hook) +3. **Worker szolgáltatás** - Helyi HTTP API webes megjelenítő felülettel és keresési végpontokkal, Bun által kezelve 4. **SQLite adatbázis** - Munkamenetek, megfigyelések, összefoglalók tárolása 5. **mem-search Skill** - Természetes nyelvi lekérdezések progresszív felfedéssel -6. **Chroma vektor adatbázis** - Hibrid szemantikus + kulcsszó keresés intelligens kontextus visszakereséshez +6. **Chroma vektor adatbázis** - Hibrid szemantikus + kulcsszó keresés intelligens kontextus-visszakereséshez -További részletekért lásd az [Architektúra áttekintést](https://docs.claude-mem.ai/architecture/overview). +Részletekért lásd az [Architektúra áttekintést](https://docs.claude-mem.ai/architecture/overview). --- -## mem-search Skill +## MCP keresési eszközök -A Claude-Mem intelligens keresést biztosít a mem-search skillen keresztül, amely automatikusan aktiválódik, amikor múltbeli munkáról kérdez: +A Claude-Mem intelligens memóriakeresést biztosít **4 MCP eszközön** keresztül, egy token-hatékony **3-rétegű munkafolyamat-minta** alapján: + +**A 3-rétegű munkafolyamat:** + +1. **`search`** - Kompakt index lekérése ID-kkal (~50-100 token/eredmény) +2. **`timeline`** - Időrendi kontextus lekérése az érdekes eredmények körül +3. **`get_observations`** - Teljes részletek lekérése KIZÁRÓLAG a szűrt ID-khez (~500-1000 token/eredmény) **Hogyan működik:** -- Csak kérdezzen természetesen: *"Mit csináltunk az előző munkamenetben?"* vagy *"Javítottuk már ezt a hibát korábban?"* -- Claude automatikusan meghívja a mem-search skillet a releváns kontextus megtalálásához +- A Claude MCP eszközöket használ a memória kereséséhez +- Kezdje a `search`-sel, hogy egy indexet kapjon az eredményekről +- Használja a `timeline`-t, hogy lássa, mi történt egy adott megfigyelés körül +- Használja a `get_observations`-t, hogy teljes részleteket kérjen le a releváns ID-khez +- **~10x token megtakarítás** azáltal, hogy a részletek lekérése előtt szűr -**Elérhető keresési műveletek:** +**Elérhető MCP eszközök:** -1. **Megfigyelések keresése** - Teljes szöveges keresés a megfigyelésekben -2. **Munkamenetek keresése** - Teljes szöveges keresés munkamenet összefoglalókban -3. **Promptok keresése** - Nyers felhasználói kérések keresése -4. **Koncepció szerint** - Keresés koncepció címkék alapján (discovery, problem-solution, pattern, stb.) -5. **Fájl szerint** - Adott fájlokra hivatkozó megfigyelések keresése -6. **Típus szerint** - Keresés típus alapján (decision, bugfix, feature, refactor, discovery, change) -7. **Legutóbbi kontextus** - Legutóbbi munkamenet kontextus lekérése egy projekthez -8. **Idővonal** - Egységes idővonal kontextus lekérése egy adott időpont körül -9. **Idővonal lekérdezéssel** - Megfigyelések keresése és idővonal kontextus lekérése a legjobb találat körül -10. **API segítség** - Keresési API dokumentáció lekérése +1. **`search`** - Memóriaindex keresése teljes szöveges lekérdezésekkel, szűrés típus/dátum/projekt szerint +2. **`timeline`** - Időrendi kontextus lekérése egy adott megfigyelés vagy lekérdezés körül +3. **`get_observations`** - Teljes megfigyelési részletek lekérése ID-k alapján (mindig kötegelve, több ID-vel) -**Példa természetes nyelvi lekérdezésekre:** +**Példa használat:** -``` -"Milyen hibákat javítottunk az előző munkamenetben?" -"Hogyan implementáltuk az autentikációt?" -"Milyen változtatások történtek a worker-service.ts fájlban?" -"Mutasd a legutóbbi munkát ezen a projekten" -"Mi történt, amikor hozzáadtuk a megjelenítő felületet?" +```typescript +// 1. lépés: Index keresése +search(query="authentication bug", type="bugfix", limit=10) + +// 2. lépés: Index áttekintése, releváns ID-k azonosítása (pl. #123, #456) + +// 3. lépés: Teljes részletek lekérése +get_observations(ids=[123, 456]) ``` Részletes példákért lásd a [Keresési eszközök útmutatót](https://docs.claude-mem.ai/usage/search-tools). --- -## Béta funkciók +## Kiadási ágak -A Claude-Mem **béta csatornát** kínál kísérleti funkciókkal, mint az **Endless Mode** (biomimetikus memória architektúra hosszabb munkamenetekhez). Váltson a stabil és béta verziók között a webes megjelenítő felületről a http://localhost:37777 → Settings címen. - -További részletekért az Endless Mode-ról és annak kipróbálásáról lásd a **[Béta funkciók dokumentációt](https://docs.claude-mem.ai/beta-features)**. +A stabil kiadások a `main` ágból jelennek meg, és az npm-re kerülnek publikálásra. A `core-dev` és a +`community-edge` forráskódból futtatott ágak a korai megbízhatósági javításokhoz és a +közösségi integrációkhoz. Lásd a **[Kiadási ágak](https://docs.claude-mem.ai/branches)** oldalt +az ágfolyamatért és a nem-stabil futtatási utasításokért. --- @@ -226,6 +291,17 @@ További részletekért az Endless Mode-ról és annak kipróbálásáról lásd - **uv**: Python csomagkezelő vektor kereséshez (automatikusan települ, ha hiányzik) - **SQLite 3**: Tartós tároláshoz (mellékelve) +--- +### Windows telepítési megjegyzések + +Ha az alábbihoz hasonló hibát lát: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Győződjön meg róla, hogy a Node.js és az npm telepítve van, és hozzá van adva a PATH-hoz. Töltse le a legújabb Node.js telepítőt a https://nodejs.org oldalról, és indítsa újra a terminált a telepítés után. + --- ## Konfiguráció @@ -234,6 +310,45 @@ A beállítások a `~/.claude-mem/settings.json` fájlban kezelhetők (automatik Az összes elérhető beállításért és példákért lásd a **[Konfigurációs útmutatót](https://docs.claude-mem.ai/configuration)**. +### Mód és nyelv konfiguráció + +A Claude-Mem több munkafolyamat-módot és nyelvet támogat a `CLAUDE_MEM_MODE` beállításon keresztül. + +Ez a beállítás mindkettőt vezérli: +- A munkafolyamat viselkedését (pl. code, chill, investigation) +- A generált megfigyelésekben használt nyelvet + +#### Hogyan konfigurálja + +Szerkessze a beállítási fájlt a `~/.claude-mem/settings.json` helyen: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +A módok a `plugin/modes/` mappában vannak meghatározva. Az összes elérhető mód helyi megtekintéséhez: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Elérhető módok + +| Mód | Leírás | +|------------|-------------------------| +| `code` | Alapértelmezett angol mód | +| `code--zh` | Egyszerűsített kínai mód | +| `code--ja` | Japán mód | + +A nyelvspecifikus módok a `code--[lang]` mintát követik, ahol a `[lang]` az ISO 639-1 nyelvkód (pl. `zh` kínaihoz, `ja` japánhoz, `es` spanyolhoz). + +> Megjegyzés: a `code--zh` (egyszerűsített kínai) már beépített — nincs szükség további telepítésre vagy plugin frissítésre. + +#### A mód megváltoztatása után + +Indítsa újra a Claude Code-ot az új mód konfiguráció alkalmazásához. --- ## Fejlesztés @@ -269,32 +384,48 @@ A hozzájárulásokat szívesen fogadjuk! Kérjük: 4. Frissítse a dokumentációt 5. Nyújtson be egy Pull Requestet -A hozzájárulási munkafolyamatért lásd a [Fejlesztési útmutatót](https://docs.claude-mem.ai/development). +A Claude-Mem három ágból jelenik meg: `main` (stabil), `core-dev` és +`community-edge`. Kizárólag a `main` kerül publikálásra az npm-en; a többi +forráskódból fut. Lásd a [Kiadási ágak](https://docs.claude-mem.ai/branches) oldalt a +stratégiáért és a helyi futtatási utasításokért. + +Lásd a [Fejlesztési útmutatót](https://docs.claude-mem.ai/development) a hozzájárulási munkafolyamatért. --- -## License +## Licenc -This project is licensed under the **Apache License 2.0** (Apache-2.0). +A Claude-Mem az Apache License 2.0 licenc alatt áll. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Az Apache-2.0-t azért választottuk, mert a tartós ágenskodó memóriának +könnyen beágyazhatónak kell lennie fejlesztői eszközökbe, helyi ügynökökbe, MCP szerverekbe, vállalati +rendszerekbe, robotikai stackekbe és éles ügynök-hordozókba. -See the [LICENSE](LICENSE) file for full details. +A teljes részletekért lásd a [LICENSE](LICENSE) fájlt. Lásd a [docs/license.md](docs/license.md) +és a [docs/ip-boundary.md](docs/ip-boundary.md) fájlokat a licencelési hatókörért és a +nyílt/kereskedelmi határvonalért. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Megjegyzés a Ragtime-ról**: A `ragtime/` mappa az **Apache License 2.0** licenc alatt áll. Részletekért lásd a [ragtime/LICENSE](ragtime/LICENSE) fájlt. --- - ## Támogatás - **Dokumentáció**: [docs/](docs/) - **Hibák**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Tároló**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Hivatalos X fiók**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Hivatalos Discord**: [Csatlakozás a Discordhoz](https://discord.com/invite/J4wttp9vDu) - **Szerző**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Claude Agent SDK-val építve** | **Claude Code által hajtva** | **TypeScript-tel készítve** \ No newline at end of file +**Claude Agent SDK-val építve** | **Claude Code-dal működik** | **TypeScript-tel készítve** + +--- + +### Mi a helyzet a CMEM-mel? + +A CMEM egy harmadik fél által létrehozott token, amelyet a Claude-Mem alkotója (Alex Newman, @thedotmack) hivatalosan is felkarolt. A token a közösségi növekedés katalizátoraként és a CMEM-et az azt leginkább igénylő fejlesztőkhöz és tudásmunkásokhoz eljuttató eszközként funkcionál. + +Hivatalos BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.id.md b/docs/i18n/README.id.md index 4cf651dc4..54c7c5fe5 100644 --- a/docs/i18n/README.id.md +++ b/docs/i18n/README.id.md @@ -1,6 +1,5 @@ 🌐 Ini adalah terjemahan otomatis. Koreksi dari komunitas sangat dipersilakan! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Sistem kompresi memori persisten yang dibangun untuk Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Mulai Cepat • @@ -101,28 +132,57 @@ ## Mulai Cepat -Mulai sesi Claude Code baru di terminal dan masukkan perintah berikut: +Instal dengan satu perintah: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Atau instal untuk OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Atau instal untuk Antigravity CLI ([panduan pengaturan](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Atau instal dari plugin marketplace di dalam Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Restart Claude Code. Konteks dari sesi sebelumnya akan secara otomatis muncul di sesi baru. +> **Catatan:** Claude-Mem juga dipublikasikan di npm, tetapi `npm install -g claude-mem` hanya menginstal **SDK/library saja** — ini tidak mendaftarkan plugin hooks atau menyiapkan layanan worker. Selalu instal melalui `npx claude-mem install` atau perintah `/plugin` di atas. + +### 🦞 OpenClaw Gateway + +Instal claude-mem sebagai plugin memori persisten pada gateway [OpenClaw](https://openclaw.ai) dengan satu perintah: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Installer ini menangani dependensi, pengaturan plugin, konfigurasi penyedia AI, startup worker, dan feed observasi real-time opsional ke Telegram, Discord, Slack, dan lainnya. Lihat [Panduan Integrasi OpenClaw](https://docs.claude-mem.ai/openclaw-integration) untuk detail. + **Fitur Utama:** - 🧠 **Memori Persisten** - Konteks bertahan di seluruh sesi - 📊 **Progressive Disclosure** - Pengambilan memori berlapis dengan visibilitas biaya token - 🔍 **Pencarian Berbasis Skill** - Query riwayat proyek Anda dengan mem-search skill -- 🖥️ **Web Viewer UI** - Stream memori real-time di http://localhost:37777 +- 🖥️ **Web Viewer UI** - Stream memori real-time di URL worker yang dicetak saat startup - 💻 **Claude Desktop Skill** - Cari memori dari percakapan Claude Desktop - 🔒 **Kontrol Privasi** - Gunakan tag `` untuk mengecualikan konten sensitif dari penyimpanan - ⚙️ **Konfigurasi Konteks** - Kontrol yang detail atas konteks apa yang diinjeksikan - 🤖 **Operasi Otomatis** - Tidak memerlukan intervensi manual -- 🔗 **Kutipan** - Referensi observasi masa lalu dengan ID (akses melalui http://localhost:37777/api/observation/{id} atau lihat semua di web viewer di http://localhost:37777) -- 🧪 **Beta Channel** - Coba fitur eksperimental seperti Endless Mode melalui peralihan versi +- 🔗 **Kutipan** - Referensi observasi masa lalu dengan ID melalui worker API atau lihat semua di web viewer --- @@ -135,7 +195,6 @@ Restart Claude Code. Konteks dari sesi sebelumnya akan secara otomatis muncul di - **[Panduan Instalasi](https://docs.claude-mem.ai/installation)** - Mulai cepat & instalasi lanjutan - **[Panduan Penggunaan](https://docs.claude-mem.ai/usage/getting-started)** - Bagaimana Claude-Mem bekerja secara otomatis - **[Alat Pencarian](https://docs.claude-mem.ai/usage/search-tools)** - Query riwayat proyek Anda dengan bahasa alami -- **[Fitur Beta](https://docs.claude-mem.ai/beta-features)** - Coba fitur eksperimental seperti Endless Mode ### Praktik Terbaik @@ -156,6 +215,7 @@ Restart Claude Code. Konteks dari sesi sebelumnya akan secara otomatis muncul di - **[Konfigurasi](https://docs.claude-mem.ai/configuration)** - Variabel environment & pengaturan - **[Pengembangan](https://docs.claude-mem.ai/development)** - Membangun, testing, kontribusi +- **[Release Branches](https://docs.claude-mem.ai/branches)** - Alur branch stable, core-dev, dan community-edge - **[Pemecahan Masalah](https://docs.claude-mem.ai/troubleshooting)** - Masalah umum & solusi --- @@ -166,7 +226,7 @@ Restart Claude Code. Konteks dari sesi sebelumnya akan secara otomatis muncul di 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skrip hook) 2. **Smart Install** - Pemeriksa dependensi yang di-cache (skrip pre-hook, bukan lifecycle hook) -3. **Worker Service** - HTTP API di port 37777 dengan web viewer UI dan 10 endpoint pencarian, dikelola oleh Bun +3. **Worker Service** - HTTP API lokal dengan web viewer UI dan endpoint pencarian, dikelola oleh Bun 4. **SQLite Database** - Menyimpan sesi, observasi, ringkasan 5. **mem-search Skill** - Query bahasa alami dengan progressive disclosure 6. **Chroma Vector Database** - Pencarian hybrid semantik + keyword untuk pengambilan konteks yang cerdas @@ -175,46 +235,51 @@ Lihat [Ringkasan Arsitektur](https://docs.claude-mem.ai/architecture/overview) u --- -## mem-search Skill +## Alat Pencarian MCP -Claude-Mem menyediakan pencarian cerdas melalui mem-search skill yang secara otomatis dipanggil saat Anda bertanya tentang pekerjaan masa lalu: +Claude-Mem menyediakan pencarian memori cerdas melalui **4 alat MCP** yang mengikuti pola alur kerja **3 lapis** yang hemat token: + +**Alur Kerja 3 Lapis:** + +1. **`search`** - Dapatkan indeks ringkas dengan ID (~50-100 token/hasil) +2. **`timeline`** - Dapatkan konteks kronologis di sekitar hasil yang menarik +3. **`get_observations`** - Ambil detail lengkap HANYA untuk ID yang telah difilter (~500-1.000 token/hasil) **Cara Kerja:** -- Tanya saja secara alami: *"Apa yang kita lakukan sesi terakhir?"* atau *"Apakah kita sudah memperbaiki bug ini sebelumnya?"* -- Claude secara otomatis memanggil mem-search skill untuk menemukan konteks yang relevan +- Claude menggunakan alat MCP untuk mencari memori Anda +- Mulai dengan `search` untuk mendapatkan indeks hasil +- Gunakan `timeline` untuk melihat apa yang terjadi di sekitar observasi tertentu +- Gunakan `get_observations` untuk mengambil detail lengkap untuk ID yang relevan +- **Penghematan token ~10x** dengan memfilter sebelum mengambil detail -**Operasi Pencarian yang Tersedia:** +**Alat MCP yang Tersedia:** -1. **Search Observations** - Pencarian teks lengkap di seluruh observasi -2. **Search Sessions** - Pencarian teks lengkap di seluruh ringkasan sesi -3. **Search Prompts** - Cari permintaan pengguna mentah -4. **By Concept** - Temukan berdasarkan tag konsep (discovery, problem-solution, pattern, dll.) -5. **By File** - Temukan observasi yang mereferensikan file tertentu -6. **By Type** - Temukan berdasarkan tipe (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Dapatkan konteks sesi terbaru untuk sebuah proyek -8. **Timeline** - Dapatkan timeline terpadu dari konteks di sekitar titik waktu tertentu -9. **Timeline by Query** - Cari observasi dan dapatkan konteks timeline di sekitar kecocokan terbaik -10. **API Help** - Dapatkan dokumentasi API pencarian +1. **`search`** - Cari indeks memori dengan query teks lengkap, filter berdasarkan tipe/tanggal/proyek +2. **`timeline`** - Dapatkan konteks kronologis di sekitar observasi atau query tertentu +3. **`get_observations`** - Ambil detail observasi lengkap berdasarkan ID (selalu batch beberapa ID) -**Contoh Query Bahasa Alami:** +**Contoh Penggunaan:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Langkah 1: Cari untuk indeks +search(query="authentication bug", type="bugfix", limit=10) + +// Langkah 2: Tinjau indeks, identifikasi ID yang relevan (mis., #123, #456) + +// Langkah 3: Ambil detail lengkap +get_observations(ids=[123, 456]) ``` Lihat [Panduan Alat Pencarian](https://docs.claude-mem.ai/usage/search-tools) untuk contoh detail. --- -## Fitur Beta +## Release Branches -Claude-Mem menawarkan **beta channel** dengan fitur eksperimental seperti **Endless Mode** (arsitektur memori biomimetik untuk sesi yang diperpanjang). Beralih antara versi stabil dan beta dari web viewer UI di http://localhost:37777 → Settings. - -Lihat **[Dokumentasi Fitur Beta](https://docs.claude-mem.ai/beta-features)** untuk detail tentang Endless Mode dan cara mencobanya. +Rilis stabil dikirim dari `main` dan dipublikasikan ke npm. `core-dev` dan +`community-edge` adalah branch yang dijalankan dari source untuk perbaikan reliabilitas awal dan +integrasi komunitas. Lihat **[Release Branches](https://docs.claude-mem.ai/branches)** +untuk alur branch dan instruksi menjalankan versi non-stable. --- @@ -226,6 +291,17 @@ Lihat **[Dokumentasi Fitur Beta](https://docs.claude-mem.ai/beta-features)** unt - **uv**: Python package manager untuk pencarian vektor (otomatis diinstal jika tidak ada) - **SQLite 3**: Untuk penyimpanan persisten (terbundel) +--- +### Catatan Pengaturan Windows + +Jika Anda melihat error seperti: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Pastikan Node.js dan npm sudah terinstal dan ditambahkan ke PATH Anda. Unduh installer Node.js terbaru dari https://nodejs.org dan restart terminal Anda setelah instalasi. + --- ## Konfigurasi @@ -234,6 +310,45 @@ Pengaturan dikelola di `~/.claude-mem/settings.json` (otomatis dibuat dengan def Lihat **[Panduan Konfigurasi](https://docs.claude-mem.ai/configuration)** untuk semua pengaturan dan contoh yang tersedia. +### Konfigurasi Mode & Bahasa + +Claude-Mem mendukung beberapa mode alur kerja dan bahasa melalui pengaturan `CLAUDE_MEM_MODE`. + +Opsi ini mengontrol keduanya: +- Perilaku alur kerja (mis. code, chill, investigation) +- Bahasa yang digunakan dalam observasi yang dihasilkan + +#### Cara Konfigurasi + +Edit file pengaturan Anda di `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Mode didefinisikan di `plugin/modes/`. Untuk melihat semua mode yang tersedia secara lokal: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Mode yang Tersedia + +| Mode | Deskripsi | +|------------|-------------------------| +| `code` | Mode Bahasa Inggris default | +| `code--zh` | Mode Bahasa Mandarin Sederhana | +| `code--ja` | Mode Bahasa Jepang | + +Mode khusus bahasa mengikuti pola `code--[lang]` di mana `[lang]` adalah kode bahasa ISO 639-1 (mis., `zh` untuk Mandarin, `ja` untuk Jepang, `es` untuk Spanyol). + +> Catatan: `code--zh` (Mandarin Sederhana) sudah terintegrasi secara bawaan — tidak diperlukan instalasi tambahan atau pembaruan plugin. + +#### Setelah Mengubah Mode + +Restart Claude Code untuk menerapkan konfigurasi mode baru. --- ## Pengembangan @@ -269,34 +384,48 @@ Kontribusi sangat dipersilakan! Silakan: 4. Perbarui dokumentasi 5. Kirim Pull Request +Claude-Mem dikirim dari tiga branch: `main` (stable), `core-dev`, dan +`community-edge`. Hanya `main` yang dipublikasikan ke npm; yang lainnya dijalankan dari +source. Lihat [Release Branches](https://docs.claude-mem.ai/branches) untuk +strategi dan instruksi menjalankan secara lokal. + Lihat [Panduan Pengembangan](https://docs.claude-mem.ai/development) untuk alur kerja kontribusi. --- -## License +## Lisensi -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem dilisensikan di bawah Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Kami memilih Apache-2.0 karena memori agentik yang tahan lama seharusnya mudah untuk disematkan dalam +alat pengembang, agen lokal, server MCP, sistem enterprise, stack robotika, +dan production agent harness. -See the [LICENSE](LICENSE) file for full details. +Lihat file [LICENSE](LICENSE) untuk detail lengkap. Lihat [docs/license.md](docs/license.md) +dan [docs/ip-boundary.md](docs/ip-boundary.md) untuk cakupan lisensi dan batas +open/commercial. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Catatan tentang Ragtime**: Direktori `ragtime/` dilisensikan di bawah **Apache License 2.0**. Lihat [ragtime/LICENSE](ragtime/LICENSE) untuk detail. --- - ## Dukungan - **Dokumentasi**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repositori**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Akun X Resmi**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Resmi**: [Gabung Discord](https://discord.com/invite/J4wttp9vDu) - **Penulis**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- **Built with Claude Agent SDK** | **Works with Claude Code** | **Made with TypeScript** ---- \ No newline at end of file +--- + +### Bagaimana dengan CMEM? + +CMEM adalah token yang dibuat oleh pihak ketiga tetapi secara resmi diakui oleh pencipta Claude-Mem (Alex Newman, @thedotmack). Token ini berperan sebagai katalisator komunitas untuk pertumbuhan dan wahana untuk membawa CMEM kepada para developer dan pekerja pengetahuan yang paling membutuhkannya. + +Official BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md index 2341ad3c7..0f770fe56 100644 --- a/docs/i18n/README.it.md +++ b/docs/i18n/README.it.md @@ -1,6 +1,5 @@ 🌐 Questa è una traduzione automatica. Le correzioni della comunità sono benvenute! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Sistema di compressione della memoria persistente creato per Claude Code.

- License + License Version @@ -75,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Avvio Rapido • Come Funziona • - Strumenti di Ricerca • + Strumenti di Ricerca • Documentazione • Configurazione • Risoluzione dei Problemi • @@ -94,35 +125,64 @@

- Claude-Mem preserva il contesto in modo fluido tra le sessioni catturando automaticamente le osservazioni sull'utilizzo degli strumenti, generando riepiloghi semantici e rendendoli disponibili per le sessioni future. Questo consente a Claude di mantenere la continuità della conoscenza sui progetti anche dopo la fine o la riconnessione delle sessioni. + Claude-Mem preserva il contesto in modo fluido tra le sessioni, catturando automaticamente le osservazioni sull'utilizzo degli strumenti, generando riepiloghi semantici e rendendoli disponibili per le sessioni future. Questo consente a Claude di mantenere la continuità della conoscenza sui progetti anche dopo la fine o la riconnessione delle sessioni.

--- ## Avvio Rapido -Avvia una nuova sessione di Claude Code nel terminale e inserisci i seguenti comandi: +Installa con un singolo comando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Oppure installa per OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Oppure installa per Antigravity CLI ([guida all'installazione](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Oppure installa dal marketplace dei plugin all'interno di Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticamente nelle nuove sessioni. +> **Nota:** Claude-Mem è pubblicato anche su npm, ma `npm install -g claude-mem` installa **solo l'SDK/libreria** — non registra gli hook del plugin né configura il servizio worker. Installa sempre tramite `npx claude-mem install` o i comandi `/plugin` sopra indicati. + +### 🦞 OpenClaw Gateway + +Installa claude-mem come plugin di memoria persistente sui gateway [OpenClaw](https://openclaw.ai) con un singolo comando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Il programma di installazione gestisce le dipendenze, la configurazione del plugin, la configurazione del provider AI, l'avvio del worker e i flussi opzionali di osservazione in tempo reale verso Telegram, Discord, Slack e altro ancora. Consulta la [Guida all'Integrazione OpenClaw](https://docs.claude-mem.ai/openclaw-integration) per i dettagli. + **Caratteristiche Principali:** - 🧠 **Memoria Persistente** - Il contesto sopravvive tra le sessioni - 📊 **Divulgazione Progressiva** - Recupero della memoria a strati con visibilità del costo in token - 🔍 **Ricerca Basata su Skill** - Interroga la cronologia del tuo progetto con la skill mem-search -- 🖥️ **Interfaccia Web Viewer** - Stream della memoria in tempo reale su http://localhost:37777 +- 🖥️ **Interfaccia Web Viewer** - Stream della memoria in tempo reale all'URL del worker stampato all'avvio - 💻 **Skill per Claude Desktop** - Cerca nella memoria dalle conversazioni di Claude Desktop - 🔒 **Controllo della Privacy** - Usa i tag `` per escludere contenuti sensibili dall'archiviazione - ⚙️ **Configurazione del Contesto** - Controllo granulare su quale contesto viene iniettato - 🤖 **Funzionamento Automatico** - Nessun intervento manuale richiesto -- 🔗 **Citazioni** - Fai riferimento a osservazioni passate con ID (accedi tramite http://localhost:37777/api/observation/{id} o visualizza tutto nel web viewer su http://localhost:37777) -- 🧪 **Canale Beta** - Prova funzionalità sperimentali come Endless Mode tramite il cambio di versione +- 🔗 **Citazioni** - Fai riferimento a osservazioni passate con ID tramite l'API del worker o visualizza tutto nel web viewer --- @@ -135,7 +195,6 @@ Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticam - **[Guida all'Installazione](https://docs.claude-mem.ai/installation)** - Avvio rapido e installazione avanzata - **[Guida all'Uso](https://docs.claude-mem.ai/usage/getting-started)** - Come funziona automaticamente Claude-Mem - **[Strumenti di Ricerca](https://docs.claude-mem.ai/usage/search-tools)** - Interroga la cronologia del progetto con linguaggio naturale -- **[Funzionalità Beta](https://docs.claude-mem.ai/beta-features)** - Prova funzionalità sperimentali come Endless Mode ### Best Practice @@ -156,6 +215,7 @@ Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticam - **[Configurazione](https://docs.claude-mem.ai/configuration)** - Variabili d'ambiente e impostazioni - **[Sviluppo](https://docs.claude-mem.ai/development)** - Build, test e flusso di contribuzione +- **[Release Branches](https://docs.claude-mem.ai/branches)** - Flusso dei branch stable, core-dev e community-edge - **[Risoluzione dei Problemi](https://docs.claude-mem.ai/troubleshooting)** - Problemi comuni e soluzioni --- @@ -166,7 +226,7 @@ Riavvia Claude Code. Il contesto delle sessioni precedenti apparirà automaticam 1. **5 Hook del Ciclo di Vita** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 script hook) 2. **Installazione Intelligente** - Controllo delle dipendenze in cache (script pre-hook, non un hook del ciclo di vita) -3. **Servizio Worker** - API HTTP sulla porta 37777 con interfaccia web viewer e 10 endpoint di ricerca, gestita da Bun +3. **Servizio Worker** - API HTTP locale con interfaccia web viewer ed endpoint di ricerca, gestita da Bun 4. **Database SQLite** - Memorizza sessioni, osservazioni, riepiloghi 5. **Skill mem-search** - Query in linguaggio naturale con divulgazione progressiva 6. **Database Vettoriale Chroma** - Ricerca ibrida semantica + keyword per recupero intelligente del contesto @@ -175,46 +235,51 @@ Vedi [Panoramica dell'Architettura](https://docs.claude-mem.ai/architecture/over --- -## Skill mem-search +## Strumenti di Ricerca MCP -Claude-Mem fornisce una ricerca intelligente tramite la skill mem-search che si attiva automaticamente quando chiedi del lavoro passato: +Claude-Mem fornisce una ricerca intelligente della memoria attraverso **4 strumenti MCP**, seguendo un pattern di flusso di lavoro **a 3 livelli** efficiente in termini di token: + +**Il Flusso di Lavoro a 3 Livelli:** + +1. **`search`** - Ottieni un indice compatto con gli ID (~50-100 token/risultato) +2. **`timeline`** - Ottieni il contesto cronologico attorno ai risultati interessanti +3. **`get_observations`** - Recupera i dettagli completi SOLO per gli ID filtrati (~500-1.000 token/risultato) **Come Funziona:** -- Chiedi semplicemente in modo naturale: *"Cosa abbiamo fatto nell'ultima sessione?"* o *"Abbiamo già risolto questo bug prima?"* -- Claude invoca automaticamente la skill mem-search per trovare il contesto rilevante +- Claude utilizza gli strumenti MCP per cercare nella tua memoria +- Inizia con `search` per ottenere un indice dei risultati +- Usa `timeline` per vedere cosa stava accadendo attorno a osservazioni specifiche +- Usa `get_observations` per recuperare i dettagli completi degli ID rilevanti +- **Risparmio di token di circa 10 volte** filtrando prima di recuperare i dettagli -**Operazioni di Ricerca Disponibili:** +**Strumenti MCP Disponibili:** -1. **Search Observations** - Ricerca full-text nelle osservazioni -2. **Search Sessions** - Ricerca full-text nei riepiloghi delle sessioni -3. **Search Prompts** - Ricerca nelle richieste utente grezze -4. **By Concept** - Trova per tag di concetto (discovery, problem-solution, pattern, ecc.) -5. **By File** - Trova osservazioni che fanno riferimento a file specifici -6. **By Type** - Trova per tipo (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Ottieni il contesto recente della sessione per un progetto -8. **Timeline** - Ottieni la timeline unificata del contesto attorno a un punto specifico nel tempo -9. **Timeline by Query** - Cerca osservazioni e ottieni il contesto della timeline attorno alla corrispondenza migliore -10. **API Help** - Ottieni la documentazione dell'API di ricerca +1. **`search`** - Cerca nell'indice della memoria con query full-text, filtri per tipo/data/progetto +2. **`timeline`** - Ottieni il contesto cronologico attorno a un'osservazione o query specifica +3. **`get_observations`** - Recupera i dettagli completi delle osservazioni tramite ID (raggruppa sempre più ID insieme) -**Esempi di Query in Linguaggio Naturale:** +**Esempio di Utilizzo:** -``` -"Quali bug abbiamo risolto nell'ultima sessione?" -"Come abbiamo implementato l'autenticazione?" -"Quali modifiche sono state apportate a worker-service.ts?" -"Mostrami il lavoro recente su questo progetto" -"Cosa stava succedendo quando abbiamo aggiunto l'interfaccia del viewer?" +```typescript +// Passo 1: Cerca per ottenere l'indice +search(query="authentication bug", type="bugfix", limit=10) + +// Passo 2: Rivedi l'indice, identifica gli ID rilevanti (es. #123, #456) + +// Passo 3: Recupera i dettagli completi +get_observations(ids=[123, 456]) ``` Vedi [Guida agli Strumenti di Ricerca](https://docs.claude-mem.ai/usage/search-tools) per esempi dettagliati. --- -## Funzionalità Beta +## Release Branches -Claude-Mem offre un **canale beta** con funzionalità sperimentali come **Endless Mode** (architettura di memoria biomimetica per sessioni estese). Passa dalla versione stabile a quella beta dall'interfaccia web viewer su http://localhost:37777 → Settings. - -Vedi **[Documentazione delle Funzionalità Beta](https://docs.claude-mem.ai/beta-features)** per dettagli su Endless Mode e come provarlo. +Le release stabili vengono pubblicate da `main` e distribuite su npm. `core-dev` e +`community-edge` sono branch eseguiti dal sorgente per correzioni di affidabilità +anticipate e integrazioni della community. Vedi **[Release Branches](https://docs.claude-mem.ai/branches)** +per il flusso dei branch e le istruzioni di esecuzione non stabili. --- @@ -226,6 +291,17 @@ Vedi **[Documentazione delle Funzionalità Beta](https://docs.claude-mem.ai/beta - **uv**: Gestore di pacchetti Python per la ricerca vettoriale (installato automaticamente se mancante) - **SQLite 3**: Per l'archiviazione persistente (incluso) +--- +### Note per la Configurazione su Windows + +Se visualizzi un errore simile a: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Assicurati che Node.js e npm siano installati e aggiunti al tuo PATH. Scarica l'ultimo installer di Node.js da https://nodejs.org e riavvia il terminale dopo l'installazione. + --- ## Configurazione @@ -234,6 +310,45 @@ Le impostazioni sono gestite in `~/.claude-mem/settings.json` (creato automatica Vedi la **[Guida alla Configurazione](https://docs.claude-mem.ai/configuration)** per tutte le impostazioni disponibili ed esempi. +### Configurazione di Modalità e Lingua + +Claude-Mem supporta più modalità di flusso di lavoro e lingue tramite l'impostazione `CLAUDE_MEM_MODE`. + +Questa opzione controlla sia: +- Il comportamento del flusso di lavoro (es. code, chill, investigation) +- La lingua utilizzata nelle osservazioni generate + +#### Come Configurare + +Modifica il tuo file di impostazioni in `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Le modalità sono definite in `plugin/modes/`. Per vedere tutte le modalità disponibili localmente: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Modalità Disponibili + +| Modalità | Descrizione | +|------------|-------------------------| +| `code` | Modalità predefinita in inglese | +| `code--zh` | Modalità in cinese semplificato | +| `code--ja` | Modalità in giapponese | + +Le modalità specifiche per lingua seguono il pattern `code--[lang]`, dove `[lang]` è il codice lingua ISO 639-1 (es. `zh` per il cinese, `ja` per il giapponese, `es` per lo spagnolo). + +> Nota: `code--zh` (cinese semplificato) è già incluso di default — non è richiesta alcuna installazione aggiuntiva o aggiornamento del plugin. + +#### Dopo aver Cambiato Modalità + +Riavvia Claude Code per applicare la nuova configurazione di modalità. --- ## Sviluppo @@ -269,34 +384,48 @@ I contributi sono benvenuti! Per favore: 4. Aggiorna la documentazione 5. Invia una Pull Request +Claude-Mem viene distribuito da tre branch: `main` (stabile), `core-dev` e +`community-edge`. Solo `main` viene pubblicato su npm; gli altri vengono eseguiti dal +sorgente. Vedi [Release Branches](https://docs.claude-mem.ai/branches) per la +strategia e le istruzioni di esecuzione locale. + Vedi [Guida allo Sviluppo](https://docs.claude-mem.ai/development) per il flusso di contribuzione. --- -## License +## Licenza -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem è distribuito con licenza Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Abbiamo scelto Apache-2.0 perché una memoria agentica durevole dovrebbe essere facile +da integrare in strumenti per sviluppatori, agenti locali, server MCP, sistemi +aziendali, stack di robotica e harness di agenti in produzione. -See the [LICENSE](LICENSE) file for full details. +Vedi il file [LICENSE](LICENSE) per i dettagli completi. Vedi [docs/license.md](docs/license.md) +e [docs/ip-boundary.md](docs/ip-boundary.md) per l'ambito della licenza e il confine +tra open source e commerciale. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Nota su Ragtime**: la directory `ragtime/` è distribuita con licenza **Apache License 2.0**. Vedi [ragtime/LICENSE](ragtime/LICENSE) per i dettagli. --- - ## Supporto - **Documentazione**: [docs/](docs/) - **Problemi**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Account X Ufficiale**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Ufficiale**: [Unisciti a Discord](https://discord.com/invite/J4wttp9vDu) - **Autore**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Creato con Claude Agent SDK** | **Alimentato da Claude Code** | **Realizzato con TypeScript** +**Creato con Claude Agent SDK** | **Funziona con Claude Code** | **Realizzato con TypeScript** ---- \ No newline at end of file +--- + +### E il CMEM? + +CMEM è un token creato da terze parti ma ufficialmente adottato dal creatore di Claude-Mem (Alex Newman, @thedotmack). Il token funge da catalizzatore per la community, favorendo la crescita e fungendo da veicolo per portare CMEM agli sviluppatori e ai knowledge worker che ne hanno più bisogno. + +CA BASE Ufficiale: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md index bec9e016d..c4c0acbab 100644 --- a/docs/i18n/README.ja.md +++ b/docs/i18n/README.ja.md @@ -1,6 +1,5 @@ 🌐 これは自動翻訳です。コミュニティによる修正を歓迎します! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code向けに構築された永続的メモリ圧縮システム

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

クイックスタート • @@ -101,28 +132,57 @@ ## クイックスタート -ターミナルで新しいClaude Codeセッションを開始し、次のコマンドを入力します: +単一のコマンドでインストールします: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +または、OpenCode用にインストールします: + +```bash +npx claude-mem install --ide opencode +``` + +または、Antigravity CLI用にインストールします([セットアップガイド](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +または、Claude Code内のプラグインマーケットプレイスからインストールします: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Claude Codeを再起動します。以前のセッションからのコンテキストが新しいセッションに自動的に表示されます。 +> **注:** Claude-MemはnpmにもPublishされていますが、`npm install -g claude-mem`は**SDK/ライブラリのみ**をインストールします — プラグインフックの登録やワーカーサービスのセットアップは行われません。必ず上記の`npx claude-mem install`または`/plugin`コマンドを使用してインストールしてください。 + +### 🦞 OpenClawゲートウェイ + +[OpenClaw](https://openclaw.ai)ゲートウェイに、単一のコマンドで永続メモリプラグインとしてclaude-memをインストールできます: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +インストーラーは、依存関係、プラグインセットアップ、AIプロバイダー設定、ワーカー起動、そしてTelegram、Discord、Slackなどへのオプションのリアルタイム観察フィードを処理します。詳細は[OpenClaw統合ガイド](https://docs.claude-mem.ai/openclaw-integration)を参照してください。 + **主な機能:** - 🧠 **永続的メモリ** - セッション間でコンテキストが保持される - 📊 **プログレッシブディスクロージャー** - トークンコストの可視性を持つ階層的メモリ取得 - 🔍 **スキルベース検索** - mem-searchスキルでプロジェクト履歴をクエリ -- 🖥️ **Webビューア UI** - http://localhost:37777 でリアルタイムメモリストリームを表示 +- 🖥️ **Webビューア UI** - 起動時に表示されるワーカーURLでリアルタイムメモリストリームを閲覧 - 💻 **Claude Desktopスキル** - Claude Desktopの会話からメモリを検索 - 🔒 **プライバシー制御** - ``タグを使用して機密コンテンツをストレージから除外 - ⚙️ **コンテキスト設定** - どのコンテキストが注入されるかを細かく制御 - 🤖 **自動動作** - 手動介入不要 -- 🔗 **引用** - IDで過去の観察を参照(http://localhost:37777/api/observation/{id} でアクセス、またはhttp://localhost:37777 のWebビューアですべて表示) -- 🧪 **ベータチャネル** - バージョン切り替えでEndless Modeなどの実験的機能を試す +- 🔗 **引用** - ワーカーAPIを通じてIDで過去の観察を参照、またはWebビューアですべて表示 --- @@ -135,7 +195,6 @@ Claude Codeを再起動します。以前のセッションからのコンテキ - **[インストールガイド](https://docs.claude-mem.ai/installation)** - クイックスタートと高度なインストール - **[使用ガイド](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Memが自動的に動作する仕組み - **[検索ツール](https://docs.claude-mem.ai/usage/search-tools)** - 自然言語でプロジェクト履歴をクエリ -- **[ベータ機能](https://docs.claude-mem.ai/beta-features)** - Endless Modeなどの実験的機能を試す ### ベストプラクティス @@ -156,6 +215,7 @@ Claude Codeを再起動します。以前のセッションからのコンテキ - **[設定](https://docs.claude-mem.ai/configuration)** - 環境変数と設定 - **[開発](https://docs.claude-mem.ai/development)** - ビルド、テスト、コントリビューション +- **[リリースブランチ](https://docs.claude-mem.ai/branches)** - stable、core-dev、community-edgeブランチのフロー - **[トラブルシューティング](https://docs.claude-mem.ai/troubleshooting)** - よくある問題と解決策 --- @@ -166,7 +226,7 @@ Claude Codeを再起動します。以前のセッションからのコンテキ 1. **5つのライフサイクルフック** - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd(6つのフックスクリプト) 2. **スマートインストール** - キャッシュされた依存関係チェッカー(プレフックスクリプト、ライフサイクルフックではない) -3. **ワーカーサービス** - ポート37777上のHTTP API、WebビューアUIと10の検索エンドポイント、Bunで管理 +3. **ワーカーサービス** - WebビューアUIと検索エンドポイントを備えたローカルHTTP API、Bunで管理 4. **SQLiteデータベース** - セッション、観察、サマリーを保存 5. **mem-searchスキル** - プログレッシブディスクロージャーを備えた自然言語クエリ 6. **Chromaベクトルデータベース** - インテリジェントなコンテキスト取得のためのハイブリッドセマンティック+キーワード検索 @@ -175,46 +235,50 @@ Claude Codeを再起動します。以前のセッションからのコンテキ --- -## mem-searchスキル +## MCP検索ツール -Claude-Memは、過去の作業について尋ねると自動的に呼び出されるmem-searchスキルを通じてインテリジェント検索を提供します: +Claude-Memは、トークン効率の良い**3層ワークフローパターン**に従う**4つのMCPツール**を通じてインテリジェントなメモリ検索を提供します: + +**3層ワークフロー:** + +1. **`search`** - IDを含むコンパクトなインデックスを取得(~50〜100トークン/結果) +2. **`timeline`** - 興味深い結果周辺の時系列コンテキストを取得 +3. **`get_observations`** - フィルタリングされたIDについてのみ完全な詳細を取得(~500〜1,000トークン/結果) **仕組み:** -- 自然に質問するだけ: *「前回のセッションで何をしましたか?」* または *「以前このバグを修正しましたか?」* -- Claudeは自動的にmem-searchスキルを呼び出して関連するコンテキストを検索します +- ClaudeはMCPツールを使用してメモリを検索します +- まず`search`でインデックスを取得します +- `timeline`を使用して特定の観察の周辺で何が起きていたかを確認します +- `get_observations`を使用して関連するIDの完全な詳細を取得します +- 詳細を取得する前にフィルタリングすることで**約10倍のトークン節約**を実現します -**利用可能な検索操作:** +**利用可能なMCPツール:** -1. **観察の検索** - 観察全体にわたる全文検索 -2. **セッションの検索** - セッションサマリー全体にわたる全文検索 -3. **プロンプトの検索** - 生のユーザーリクエストを検索 -4. **コンセプト別** - コンセプトタグで検索(discovery、problem-solution、patternなど) -5. **ファイル別** - 特定のファイルを参照している観察を検索 -6. **タイプ別** - タイプ別に検索(decision、bugfix、feature、refactor、discovery、change) -7. **最近のコンテキスト** - プロジェクトの最近のセッションコンテキストを取得 -8. **タイムライン** - 特定の時点周辺のコンテキストの統一タイムラインを取得 -9. **クエリ別タイムライン** - 観察を検索し、最適な一致周辺のタイムラインコンテキストを取得 -10. **APIヘルプ** - 検索APIドキュメントを取得 +1. **`search`** - 全文検索クエリでメモリインデックスを検索し、タイプ/日付/プロジェクトでフィルタリング +2. **`timeline`** - 特定の観察またはクエリ周辺の時系列コンテキストを取得 +3. **`get_observations`** - IDによって完全な観察詳細を取得(常に複数のIDをまとめてバッチ処理) -**自然言語クエリの例:** +**使用例:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// ステップ1: インデックスを検索 +search(query="authentication bug", type="bugfix", limit=10) + +// ステップ2: インデックスを確認し、関連するIDを特定(例: #123、#456) + +// ステップ3: 完全な詳細を取得 +get_observations(ids=[123, 456]) ``` 詳細な例は[検索ツールガイド](https://docs.claude-mem.ai/usage/search-tools)を参照してください。 --- -## ベータ機能 +## リリースブランチ -Claude-Memは、**Endless Mode**(拡張セッション用の生体模倣メモリアーキテクチャ)などの実験的機能を備えた**ベータチャネル**を提供します。http://localhost:37777 → SettingsのWebビューアUIから安定版とベータ版を切り替えます。 - -Endless Modeと試用方法の詳細については、**[ベータ機能ドキュメント](https://docs.claude-mem.ai/beta-features)** を参照してください。 +安定版リリースは`main`から出荷され、npmに公開されます。`core-dev`と +`community-edge`は、早期の信頼性修正やコミュニティ統合のためのソース実行ブランチです。ブランチフローと非安定版の実行手順については、**[リリースブランチ](https://docs.claude-mem.ai/branches)** +を参照してください。 --- @@ -226,6 +290,17 @@ Endless Modeと試用方法の詳細については、**[ベータ機能ドキ - **uv**: ベクトル検索用のPythonパッケージマネージャー(不足している場合は自動インストール) - **SQLite 3**: 永続ストレージ用(バンドル済み) +--- +### Windowsセットアップに関する注意事項 + +次のようなエラーが表示される場合: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Node.jsとnpmがインストールされ、PATHに追加されていることを確認してください。https://nodejs.org から最新のNode.jsインストーラーをダウンロードし、インストール後にターミナルを再起動してください。 + --- ## 設定 @@ -234,6 +309,45 @@ Endless Modeと試用方法の詳細については、**[ベータ機能ドキ 利用可能なすべての設定と例については、**[設定ガイド](https://docs.claude-mem.ai/configuration)** を参照してください。 +### モードと言語の設定 + +Claude-Memは、`CLAUDE_MEM_MODE`設定を通じて複数のワークフローモードと言語をサポートします。 + +このオプションは以下の両方を制御します: +- ワークフローの動作(code、chill、investigationなど) +- 生成される観察で使用される言語 + +#### 設定方法 + +`~/.claude-mem/settings.json`にある設定ファイルを編集します: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +モードは`plugin/modes/`で定義されています。ローカルで利用可能なすべてのモードを確認するには: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### 利用可能なモード + +| モード | 説明 | +|------------|-------------------------| +| `code` | デフォルトの英語モード | +| `code--zh` | 簡体字中国語モード | +| `code--ja` | 日本語モード | + +言語固有のモードは`code--[lang]`というパターンに従います。ここで`[lang]`はISO 639-1言語コードです(中国語は`zh`、日本語は`ja`、スペイン語は`es`など)。 + +> 注: `code--zh`(簡体字中国語)はすでに組み込まれています — 追加のインストールやプラグインの更新は不要です。 + +#### モード変更後 + +新しいモード設定を適用するには、Claude Codeを再起動してください。 --- ## 開発 @@ -269,32 +383,47 @@ npm run bug-report 4. ドキュメントを更新 5. プルリクエストを提出 +Claude-Memは`main`(安定版)、`core-dev`、`community-edge`の3つのブランチから +出荷されます。npmに公開されるのは`main`のみで、他はソースから実行されます。 +ブランチ戦略とローカル実行手順については[リリースブランチ](https://docs.claude-mem.ai/branches)を参照してください。 + コントリビューションワークフローについては[開発ガイド](https://docs.claude-mem.ai/development)を参照してください。 --- -## License +## ライセンス -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Memは Apache License 2.0 の下でライセンスされています。 -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +永続的なエージェントメモリは、開発者ツール、ローカルエージェント、MCPサーバー、 +エンタープライズシステム、ロボティクススタック、および本番エージェントハーネスに +簡単に組み込めるべきだと考え、Apache-2.0を選択しました。 -See the [LICENSE](LICENSE) file for full details. +詳細については[LICENSE](LICENSE)ファイルを参照してください。ライセンスの範囲とオープン/商用の +境界については[docs/license.md](docs/license.md)および[docs/ip-boundary.md](docs/ip-boundary.md) +を参照してください。 -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtimeに関する注記**: `ragtime/`ディレクトリは**Apache License 2.0**の下でライセンスされています。詳細は[ragtime/LICENSE](ragtime/LICENSE)を参照してください。 --- - ## サポート - **ドキュメント**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **リポジトリ**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **公式Xアカウント**: [@Claude_Memory](https://x.com/Claude_Memory) +- **公式Discord**: [Discordに参加](https://discord.com/invite/J4wttp9vDu) - **作者**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- **Claude Agent SDKで構築** | **Claude Codeで動作** | **TypeScriptで作成** + +--- + +### CMEMについて + +CMEMは第三者によって作成されたトークンですが、Claude-Memの作成者(Alex Newman、@thedotmack)によって公式に採用されています。このトークンは、成長のためのコミュニティ触媒として、また、CMEMを最も必要としている開発者やナレッジワーカーに届けるための手段として機能します。 + +公式BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md index 076a37f78..6bb83135a 100644 --- a/docs/i18n/README.ko.md +++ b/docs/i18n/README.ko.md @@ -1,6 +1,5 @@ 🌐 이것은 자동 번역입니다. 커뮤니티의 수정 제안을 환영합니다! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code를 위해 구축된 지속적인 메모리 압축 시스템.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

빠른 시작 • @@ -101,28 +132,57 @@ ## 빠른 시작 -터미널에서 새 Claude Code 세션을 시작하고 다음 명령을 입력하세요: +한 줄 명령으로 설치하세요: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +또는 OpenCode용으로 설치하세요: + +```bash +npx claude-mem install --ide opencode +``` + +또는 Antigravity CLI용으로 설치하세요 ([설치 가이드](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +또는 Claude Code 내에서 플러그인 마켓플레이스를 통해 설치하세요: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 자동으로 새 세션에 나타납니다. +> **참고:** Claude-Mem은 npm에도 게시되어 있지만, `npm install -g claude-mem`은 **SDK/라이브러리만** 설치합니다 — 플러그인 후크를 등록하거나 워커 서비스를 설정하지 않습니다. 항상 `npx claude-mem install` 또는 위의 `/plugin` 명령을 통해 설치하세요. + +### 🦞 OpenClaw 게이트웨이 + +한 줄 명령으로 [OpenClaw](https://openclaw.ai) 게이트웨이에 claude-mem을 지속적인 메모리 플러그인으로 설치하세요: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +설치 프로그램은 종속성, 플러그인 설정, AI 제공업체 구성, 워커 시작, 그리고 Telegram, Discord, Slack 등으로의 선택적 실시간 관찰 피드를 처리합니다. 자세한 내용은 [OpenClaw 통합 가이드](https://docs.claude-mem.ai/openclaw-integration)를 참조하세요. + **주요 기능:** - 🧠 **지속적인 메모리** - 세션 간 컨텍스트 유지 - 📊 **점진적 공개** - 토큰 비용 가시성을 갖춘 계층화된 메모리 검색 - 🔍 **스킬 기반 검색** - mem-search 스킬로 프로젝트 기록 쿼리 -- 🖥️ **웹 뷰어 UI** - http://localhost:37777 에서 실시간 메모리 스트림 확인 +- 🖥️ **웹 뷰어 UI** - 시작 시 출력되는 워커 URL에서 실시간 메모리 스트림 확인 - 💻 **Claude Desktop 스킬** - Claude Desktop 대화에서 메모리 검색 - 🔒 **개인정보 제어** - `` 태그를 사용하여 민감한 콘텐츠를 저장소에서 제외 - ⚙️ **컨텍스트 설정** - 주입되는 컨텍스트에 대한 세밀한 제어 - 🤖 **자동 작동** - 수동 개입 불필요 -- 🔗 **인용** - ID로 과거 관찰 참조 (http://localhost:37777/api/observation/{id} 를 통해 액세스하거나 http://localhost:37777 의 웹 뷰어에서 모두 보기) -- 🧪 **베타 채널** - 버전 전환을 통해 Endless Mode와 같은 실험적 기능 사용 +- 🔗 **인용** - 워커 API를 통해 ID로 과거 관찰 참조하거나 웹 뷰어에서 모두 확인 --- @@ -135,7 +195,6 @@ Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 자동으로 - **[설치 가이드](https://docs.claude-mem.ai/installation)** - 빠른 시작 및 고급 설치 - **[사용 가이드](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem이 자동으로 작동하는 방법 - **[검색 도구](https://docs.claude-mem.ai/usage/search-tools)** - 자연어로 프로젝트 기록 쿼리 -- **[베타 기능](https://docs.claude-mem.ai/beta-features)** - Endless Mode와 같은 실험적 기능 시도 ### 모범 사례 @@ -156,6 +215,7 @@ Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 자동으로 - **[설정](https://docs.claude-mem.ai/configuration)** - 환경 변수 및 설정 - **[개발](https://docs.claude-mem.ai/development)** - 빌드, 테스트, 기여 +- **[릴리스 브랜치](https://docs.claude-mem.ai/branches)** - Stable, core-dev, community-edge 브랜치 흐름 - **[문제 해결](https://docs.claude-mem.ai/troubleshooting)** - 일반적인 문제 및 해결 방법 --- @@ -166,7 +226,7 @@ Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 자동으로 1. **5개 라이프사이클 후크** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6개 후크 스크립트) 2. **스마트 설치** - 캐시된 종속성 검사기 (사전 후크 스크립트, 라이프사이클 후크 아님) -3. **워커 서비스** - 웹 뷰어 UI와 10개 검색 엔드포인트를 갖춘 포트 37777의 HTTP API, Bun으로 관리 +3. **워커 서비스** - 웹 뷰어 UI와 검색 엔드포인트를 갖춘 로컬 HTTP API, Bun으로 관리 4. **SQLite 데이터베이스** - 세션, 관찰, 요약 저장 5. **mem-search 스킬** - 점진적 공개를 통한 자연어 쿼리 6. **Chroma 벡터 데이터베이스** - 지능형 컨텍스트 검색을 위한 하이브리드 의미론적 + 키워드 검색 @@ -175,46 +235,51 @@ Claude Code를 재시작하세요. 이전 세션의 컨텍스트가 자동으로 --- -## mem-search 스킬 +## MCP 검색 도구 -Claude-Mem은 과거 작업에 대해 질문할 때 자동으로 호출되는 mem-search 스킬을 통해 지능형 검색을 제공합니다: +Claude-Mem은 토큰 효율적인 **3계층 워크플로우 패턴**을 따르는 **4개의 MCP 도구**를 통해 지능형 메모리 검색을 제공합니다: + +**3계층 워크플로우:** + +1. **`search`** - ID가 포함된 압축된 인덱스 가져오기 (결과당 ~50-100 토큰) +2. **`timeline`** - 흥미로운 결과 주변의 시간순 컨텍스트 가져오기 +3. **`get_observations`** - 필터링된 ID에 대해서만 전체 세부 정보 가져오기 (결과당 ~500-1,000 토큰) **작동 방식:** -- 자연스럽게 질문하세요: *"지난 세션에서 무엇을 했나요?"* 또는 *"이 버그를 이전에 수정했나요?"* -- Claude가 관련 컨텍스트를 찾기 위해 mem-search 스킬을 자동으로 호출합니다 +- Claude는 MCP 도구를 사용하여 메모리를 검색합니다 +- `search`로 시작하여 결과 인덱스를 가져옵니다 +- `timeline`을 사용하여 특정 관찰 주변에서 무슨 일이 있었는지 확인합니다 +- `get_observations`를 사용하여 관련 ID에 대한 전체 세부 정보를 가져옵니다 +- 세부 정보를 가져오기 전에 필터링하여 **약 10배의 토큰 절약** 효과를 얻습니다 -**사용 가능한 검색 작업:** +**사용 가능한 MCP 도구:** -1. **관찰 검색** - 관찰에 대한 전체 텍스트 검색 -2. **세션 검색** - 세션 요약에 대한 전체 텍스트 검색 -3. **프롬프트 검색** - 원시 사용자 요청 검색 -4. **개념별** - 개념 태그로 찾기 (discovery, problem-solution, pattern 등) -5. **파일별** - 특정 파일을 참조하는 관찰 찾기 -6. **유형별** - 유형별로 찾기 (decision, bugfix, feature, refactor, discovery, change) -7. **최근 컨텍스트** - 프로젝트의 최근 세션 컨텍스트 가져오기 -8. **타임라인** - 특정 시점 주변의 통합된 컨텍스트 타임라인 가져오기 -9. **쿼리별 타임라인** - 관찰을 검색하고 가장 일치하는 항목 주변의 타임라인 컨텍스트 가져오기 -10. **API 도움말** - 검색 API 문서 가져오기 +1. **`search`** - 전체 텍스트 쿼리로 메모리 인덱스 검색, 유형/날짜/프로젝트별 필터링 +2. **`timeline`** - 특정 관찰 또는 쿼리 주변의 시간순 컨텍스트 가져오기 +3. **`get_observations`** - ID로 전체 관찰 세부 정보 가져오기 (항상 여러 ID를 일괄 처리) -**자연어 쿼리 예제:** +**사용 예제:** -``` -"지난 세션에서 어떤 버그를 수정했나요?" -"인증을 어떻게 구현했나요?" -"worker-service.ts에 어떤 변경 사항이 있었나요?" -"이 프로젝트의 최근 작업을 보여주세요" -"뷰어 UI를 추가할 때 무슨 일이 있었나요?" +```typescript +// 1단계: 인덱스 검색 +search(query="authentication bug", type="bugfix", limit=10) + +// 2단계: 인덱스 검토, 관련 ID 식별 (예: #123, #456) + +// 3단계: 전체 세부 정보 가져오기 +get_observations(ids=[123, 456]) ``` 자세한 예제는 [검색 도구 가이드](https://docs.claude-mem.ai/usage/search-tools)를 참조하세요. --- -## 베타 기능 +## 릴리스 브랜치 -Claude-Mem은 **Endless Mode**(확장된 세션을 위한 생체모방 메모리 아키텍처)와 같은 실험적 기능을 제공하는 **베타 채널**을 제공합니다. http://localhost:37777 → Settings의 웹 뷰어 UI에서 안정 버전과 베타 버전 간 전환이 가능합니다. - -Endless Mode 및 사용 방법에 대한 자세한 내용은 **[베타 기능 문서](https://docs.claude-mem.ai/beta-features)**를 참조하세요. +안정적인 릴리스는 `main`에서 배포되며 npm에 게시됩니다. `core-dev`와 +`community-edge`는 초기 안정성 수정과 커뮤니티 통합을 위한 소스 실행 브랜치입니다. +브랜치 흐름과 비안정 버전 실행 방법은 **[릴리스 브랜치](https://docs.claude-mem.ai/branches)**를 +참조하세요. --- @@ -226,6 +291,17 @@ Endless Mode 및 사용 방법에 대한 자세한 내용은 **[베타 기능 - **uv**: 벡터 검색을 위한 Python 패키지 관리자 (누락 시 자동 설치) - **SQLite 3**: 영구 저장을 위한 데이터베이스 (번들 포함) +--- +### Windows 설치 참고 사항 + +다음과 같은 오류가 표시되는 경우: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Node.js와 npm이 설치되어 있고 PATH에 추가되어 있는지 확인하세요. https://nodejs.org 에서 최신 Node.js 설치 프로그램을 다운로드하고 설치 후 터미널을 재시작하세요. + --- ## 설정 @@ -234,6 +310,45 @@ Endless Mode 및 사용 방법에 대한 자세한 내용은 **[베타 기능 사용 가능한 모든 설정 및 예제는 **[설정 가이드](https://docs.claude-mem.ai/configuration)**를 참조하세요. +### 모드 및 언어 설정 + +Claude-Mem은 `CLAUDE_MEM_MODE` 설정을 통해 다양한 워크플로우 모드와 언어를 지원합니다. + +이 옵션은 다음 두 가지를 모두 제어합니다: +- 워크플로우 동작 (예: code, chill, investigation) +- 생성된 관찰에서 사용되는 언어 + +#### 설정 방법 + +`~/.claude-mem/settings.json`에 있는 설정 파일을 편집하세요: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +모드는 `plugin/modes/`에 정의되어 있습니다. 로컬에서 사용 가능한 모든 모드를 확인하려면: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### 사용 가능한 모드 + +| 모드 | 설명 | +|------------|-------------------------| +| `code` | 기본 영어 모드 | +| `code--zh` | 중국어 간체 모드 | +| `code--ja` | 일본어 모드 | + +언어별 모드는 `code--[lang]` 패턴을 따르며, 여기서 `[lang]`은 ISO 639-1 언어 코드입니다 (예: 중국어는 `zh`, 일본어는 `ja`, 스페인어는 `es`). + +> 참고: `code--zh` (중국어 간체)는 이미 내장되어 있습니다 — 추가 설치나 플러그인 업데이트가 필요하지 않습니다. + +#### 모드 변경 후 + +새 모드 설정을 적용하려면 Claude Code를 재시작하세요. --- ## 개발 @@ -269,34 +384,48 @@ npm run bug-report 4. 문서 업데이트 5. Pull Request 제출 +Claude-Mem은 `main` (stable), `core-dev`, `community-edge`의 세 브랜치에서 +배포됩니다. `main`만 npm에 게시되며, 나머지는 소스에서 실행됩니다. +전략과 로컬 실행 방법은 [릴리스 브랜치](https://docs.claude-mem.ai/branches)를 +참조하세요. + 기여 워크플로우는 [개발 가이드](https://docs.claude-mem.ai/development)를 참조하세요. --- -## License +## 라이선스 -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem은 Apache License 2.0에 따라 라이선스가 부여됩니다. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +내구성 있는 에이전틱 메모리는 개발자 도구, 로컬 에이전트, MCP 서버, 엔터프라이즈 +시스템, 로보틱스 스택, 그리고 프로덕션 에이전트 하네스에 쉽게 내장될 수 있어야 +한다는 이유로 Apache-2.0을 선택했습니다. -See the [LICENSE](LICENSE) file for full details. +전체 세부 사항은 [LICENSE](LICENSE) 파일을 참조하세요. 라이선스 범위와 +오픈/상업적 경계에 대해서는 [docs/license.md](docs/license.md)와 +[docs/ip-boundary.md](docs/ip-boundary.md)를 참조하세요. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtime 관련 참고 사항**: `ragtime/` 디렉토리는 **Apache License 2.0**에 따라 라이선스가 부여됩니다. 자세한 내용은 [ragtime/LICENSE](ragtime/LICENSE)를 참조하세요. --- - ## 지원 - **문서**: [docs/](docs/) - **이슈**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **저장소**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **공식 X 계정**: [@Claude_Memory](https://x.com/Claude_Memory) +- **공식 Discord**: [Discord 참여하기](https://discord.com/invite/J4wttp9vDu) - **작성자**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- **Claude Agent SDK로 구축** | **Claude Code 기반** | **TypeScript로 제작** ---- \ No newline at end of file +--- + +### CMEM이란 무엇인가요? + +CMEM은 제3자가 만든 토큰이지만 Claude-Mem의 제작자(Alex Newman, @thedotmack)가 공식적으로 받아들인 토큰입니다. 이 토큰은 성장을 위한 커뮤니티 촉매제이자 CMEM을 가장 필요로 하는 개발자와 지식 노동자들에게 전달하는 수단 역할을 합니다. + +공식 BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.nl.md b/docs/i18n/README.nl.md index 74ec69330..dd8716d7a 100644 --- a/docs/i18n/README.nl.md +++ b/docs/i18n/README.nl.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Persistent geheugencompressiesysteem gebouwd voor Claude Code.

- License + License Version @@ -74,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Snel Starten • Hoe Het Werkt • - Zoektools • + Zoektools • Documentatie • Configuratie • Probleemoplossing • @@ -100,28 +132,57 @@ ## Snel Starten -Start een nieuwe Claude Code sessie in de terminal en voer de volgende commando's in: +Installeer met één enkel commando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Of installeer voor OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Of installeer voor Antigravity CLI ([installatiegids](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Of installeer vanuit de plugin marketplace binnen Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Herstart Claude Code. Context van eerdere sessies verschijnt automatisch in nieuwe sessies. +> **Let op:** Claude-Mem wordt ook op npm gepubliceerd, maar `npm install -g claude-mem` installeert alleen de **SDK/bibliotheek** — het registreert de plugin hooks niet en zet de worker service niet op. Installeer altijd via `npx claude-mem install` of de bovenstaande `/plugin` commando's. + +### 🦞 OpenClaw Gateway + +Installeer claude-mem als een persistente geheugenplugin op [OpenClaw](https://openclaw.ai) gateways met één enkel commando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Het installatieprogramma regelt afhankelijkheden, plugin-instellingen, AI-providerconfiguratie, worker-opstart en optionele real-time waarnemingsfeeds naar Telegram, Discord, Slack en meer. Zie de [OpenClaw Integratiegids](https://docs.claude-mem.ai/openclaw-integration) voor details. + **Belangrijkste Functies:** - 🧠 **Persistent Geheugen** - Context blijft behouden tussen sessies - 📊 **Progressieve Onthulling** - Gelaagde geheugenophaling met zichtbaarheid van tokenkosten -- 🔍 **Vaardigheidgebaseerd Zoeken** - Bevraag je projectgeschiedenis met mem-search vaardigheid -- 🖥️ **Web Viewer UI** - Real-time geheugenstroom op http://localhost:37777 +- 🔍 **Vaardigheidgebaseerd Zoeken** - Bevraag je projectgeschiedenis met de mem-search vaardigheid +- 🖥️ **Web Viewer UI** - Real-time geheugenstroom op de worker-URL die bij het opstarten wordt weergegeven - 💻 **Claude Desktop Vaardigheid** - Zoek geheugen vanuit Claude Desktop gesprekken - 🔒 **Privacycontrole** - Gebruik `` tags om gevoelige content uit te sluiten van opslag - ⚙️ **Context Configuratie** - Fijnmazige controle over welke context wordt geïnjecteerd - 🤖 **Automatische Werking** - Geen handmatige tussenkomst vereist -- 🔗 **Citaten** - Verwijs naar eerdere waarnemingen met ID's (toegang via http://localhost:37777/api/observation/{id} of bekijk alle in de web viewer op http://localhost:37777) -- 🧪 **Bètakanaal** - Probeer experimentele functies zoals Endless Mode via versieschakeling +- 🔗 **Citaten** - Verwijs naar eerdere waarnemingen met ID's via de worker API of bekijk alles in de web viewer --- @@ -134,7 +195,6 @@ Herstart Claude Code. Context van eerdere sessies verschijnt automatisch in nieu - **[Installatiegids](https://docs.claude-mem.ai/installation)** - Snel starten & geavanceerde installatie - **[Gebruikersgids](https://docs.claude-mem.ai/usage/getting-started)** - Hoe Claude-Mem automatisch werkt - **[Zoektools](https://docs.claude-mem.ai/usage/search-tools)** - Bevraag je projectgeschiedenis met natuurlijke taal -- **[Bètafuncties](https://docs.claude-mem.ai/beta-features)** - Probeer experimentele functies zoals Endless Mode ### Beste Praktijken @@ -155,6 +215,7 @@ Herstart Claude Code. Context van eerdere sessies verschijnt automatisch in nieu - **[Configuratie](https://docs.claude-mem.ai/configuration)** - Omgevingsvariabelen & instellingen - **[Ontwikkeling](https://docs.claude-mem.ai/development)** - Bouwen, testen, bijdragen +- **[Release Branches](https://docs.claude-mem.ai/branches)** - Stable, core-dev en community-edge branch-flow - **[Probleemoplossing](https://docs.claude-mem.ai/troubleshooting)** - Veelvoorkomende problemen & oplossingen --- @@ -165,7 +226,7 @@ Herstart Claude Code. Context van eerdere sessies verschijnt automatisch in nieu 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Slimme Installatie** - Gecachte afhankelijkheidscontrole (pre-hook script, geen lifecycle hook) -3. **Worker Service** - HTTP API op poort 37777 met web viewer UI en 10 zoekeindpunten, beheerd door Bun +3. **Worker Service** - Lokale HTTP API met web viewer UI en zoekendpoints, beheerd door Bun 4. **SQLite Database** - Slaat sessies, waarnemingen, samenvattingen op 5. **mem-search Vaardigheid** - Natuurlijke taal queries met progressieve onthulling 6. **Chroma Vector Database** - Hybride semantisch + zoekwoord zoeken voor intelligente context ophaling @@ -174,46 +235,51 @@ Zie [Architectuuroverzicht](https://docs.claude-mem.ai/architecture/overview) vo --- -## mem-search Vaardigheid +## MCP Zoektools -Claude-Mem biedt intelligent zoeken via de mem-search vaardigheid die automatisch wordt aangeroepen wanneer je vraagt over eerder werk: +Claude-Mem biedt intelligent geheugenzoeken via **4 MCP-tools** volgens een tokenefficiënt **3-lagen workflowpatroon**: + +**De 3-Lagen Workflow:** + +1. **`search`** - Krijg een compacte index met ID's (~50-100 tokens/resultaat) +2. **`timeline`** - Krijg chronologische context rond interessante resultaten +3. **`get_observations`** - Haal volledige details op ALLEEN voor gefilterde ID's (~500-1.000 tokens/resultaat) **Hoe Het Werkt:** -- Vraag gewoon natuurlijk: *"Wat hebben we vorige sessie gedaan?"* of *"Hebben we deze bug eerder opgelost?"* -- Claude roept automatisch de mem-search vaardigheid aan om relevante context te vinden +- Claude gebruikt MCP-tools om je geheugen te doorzoeken +- Begin met `search` om een index van resultaten te krijgen +- Gebruik `timeline` om te zien wat er gebeurde rond specifieke waarnemingen +- Gebruik `get_observations` om volledige details op te halen voor relevante ID's +- **~10x tokenbesparing** door te filteren vóórdat details worden opgehaald -**Beschikbare Zoekoperaties:** +**Beschikbare MCP-Tools:** -1. **Search Observations** - Volledige tekst zoeken door waarnemingen -2. **Search Sessions** - Volledige tekst zoeken door sessiesamenvattingen -3. **Search Prompts** - Zoek ruwe gebruikersverzoeken -4. **By Concept** - Vind op concepttags (discovery, problem-solution, pattern, etc.) -5. **By File** - Vind waarnemingen die specifieke bestanden refereren -6. **By Type** - Vind op type (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Krijg recente sessiecontext voor een project -8. **Timeline** - Krijg uniforme tijdlijn van context rond een specifiek tijdstip -9. **Timeline by Query** - Zoek naar waarnemingen en krijg tijdlijncontext rond beste match -10. **API Help** - Krijg zoek API documentatie +1. **`search`** - Doorzoek de geheugenindex met volledige-tekst queries, filter op type/datum/project +2. **`timeline`** - Krijg chronologische context rond een specifieke waarneming of query +3. **`get_observations`** - Haal volledige waarnemingsdetails op via ID's (bundel altijd meerdere ID's) -**Voorbeeld Natuurlijke Taal Queries:** +**Voorbeeldgebruik:** -``` -"Welke bugs hebben we vorige sessie opgelost?" -"Hoe hebben we authenticatie geïmplementeerd?" -"Welke wijzigingen zijn gemaakt aan worker-service.ts?" -"Laat me recent werk aan dit project zien" -"Wat gebeurde er toen we de viewer UI toevoegden?" +```typescript +// Stap 1: Zoek naar index +search(query="authentication bug", type="bugfix", limit=10) + +// Stap 2: Bekijk de index, identificeer relevante ID's (bijv. #123, #456) + +// Stap 3: Haal volledige details op +get_observations(ids=[123, 456]) ``` Zie [Zoektools Gids](https://docs.claude-mem.ai/usage/search-tools) voor gedetailleerde voorbeelden. --- -## Bètafuncties +## Release Branches -Claude-Mem biedt een **bètakanaal** met experimentele functies zoals **Endless Mode** (biomimetische geheugenarchitectuur voor uitgebreide sessies). Schakel tussen stabiele en bètaversies vanuit de web viewer UI op http://localhost:37777 → Settings. - -Zie **[Bètafuncties Documentatie](https://docs.claude-mem.ai/beta-features)** voor details over Endless Mode en hoe je het kunt proberen. +Stabiele releases worden uitgebracht vanuit `main` en gepubliceerd op npm. `core-dev` en +`community-edge` zijn branches die vanuit de broncode draaien voor vroege betrouwbaarheidsfixes en +community-integraties. Zie **[Release Branches](https://docs.claude-mem.ai/branches)** +voor de branch-flow en instructies voor het draaien van niet-stabiele versies. --- @@ -225,14 +291,64 @@ Zie **[Bètafuncties Documentatie](https://docs.claude-mem.ai/beta-features)** v - **uv**: Python package manager voor vector zoeken (automatisch geïnstalleerd indien ontbreekt) - **SQLite 3**: Voor persistente opslag (meegeleverd) +--- +### Opmerkingen bij Windows-installatie + +Als je een fout ziet zoals: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Zorg ervoor dat Node.js en npm zijn geïnstalleerd en toegevoegd aan je PATH. Download het nieuwste Node.js-installatieprogramma van https://nodejs.org en herstart je terminal na installatie. + --- ## Configuratie -Instellingen worden beheerd in `~/.claude-mem/settings.json` (automatisch aangemaakt met standaardinstellingen bij eerste run). Configureer AI model, worker poort, data directory, logniveau en context injectie-instellingen. +Instellingen worden beheerd in `~/.claude-mem/settings.json` (automatisch aangemaakt met standaardinstellingen bij eerste run). Configureer AI-model, worker-poort, datamap, logniveau en context-injectie-instellingen. Zie de **[Configuratiegids](https://docs.claude-mem.ai/configuration)** voor alle beschikbare instellingen en voorbeelden. +### Modus- & Taalconfiguratie + +Claude-Mem ondersteunt meerdere workflowmodi en talen via de `CLAUDE_MEM_MODE` instelling. + +Deze optie regelt zowel: +- Het workflowgedrag (bijv. code, chill, investigation) +- De taal die wordt gebruikt in gegenereerde waarnemingen + +#### Hoe te Configureren + +Bewerk je instellingenbestand op `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Modi zijn gedefinieerd in `plugin/modes/`. Om alle lokaal beschikbare modi te zien: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Beschikbare Modi + +| Modus | Beschrijving | +|------------|-------------------------| +| `code` | Standaard Engelse modus | +| `code--zh` | Vereenvoudigd Chinese modus | +| `code--ja` | Japanse modus | + +Taalspecifieke modi volgen het patroon `code--[lang]` waarbij `[lang]` de ISO 639-1 taalcode is (bijv. `zh` voor Chinees, `ja` voor Japans, `es` voor Spaans). + +> Let op: `code--zh` (Vereenvoudigd Chinees) is al ingebouwd — geen extra installatie of plugin-update is vereist. + +#### Na het Wijzigen van de Modus + +Herstart Claude Code om de nieuwe modusconfiguratie toe te passen. --- ## Ontwikkeling @@ -268,32 +384,48 @@ Bijdragen zijn welkom! Gelieve: 4. Update documentatie 5. Dien een Pull Request in +Claude-Mem wordt uitgebracht vanuit drie branches: `main` (stable), `core-dev`, en +`community-edge`. Alleen `main` wordt gepubliceerd op npm; de andere draaien vanuit +de broncode. Zie [Release Branches](https://docs.claude-mem.ai/branches) voor de +strategie en instructies voor lokaal draaien. + Zie [Ontwikkelingsgids](https://docs.claude-mem.ai/development) voor bijdrageworkflow. --- -## License +## Licentie -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem wordt uitgebracht onder de Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +We hebben voor Apache-2.0 gekozen omdat duurzaam agentic geheugen eenvoudig ingebed +moet kunnen worden in ontwikkelaarstools, lokale agents, MCP-servers, enterprise-systemen, +robotica-stacks en productie-agentharnassen. -See the [LICENSE](LICENSE) file for full details. +Zie het [LICENSE](LICENSE) bestand voor volledige details. Zie [docs/license.md](docs/license.md) +en [docs/ip-boundary.md](docs/ip-boundary.md) voor de licentiescope en de +grens tussen open en commercieel gebruik. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Opmerking over Ragtime**: De `ragtime/` map is gelicenseerd onder de **Apache License 2.0**. Zie [ragtime/LICENSE](ragtime/LICENSE) voor details. --- - ## Ondersteuning - **Documentatie**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Officieel X-account**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Officiële Discord**: [Word lid van Discord](https://discord.com/invite/J4wttp9vDu) - **Auteur**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Gebouwd met Claude Agent SDK** | **Aangedreven door Claude Code** | **Gemaakt met TypeScript** \ No newline at end of file +**Gebouwd met Claude Agent SDK** | **Werkt met Claude Code** | **Gemaakt met TypeScript** + +--- + +### Hoe Zit Het met CMEM? + +CMEM is een token gecreëerd door een derde partij, maar officieel omarmd door de maker van Claude-Mem (Alex Newman, @thedotmack). Het token fungeert als een katalysator voor de community voor groei en een middel om CMEM te brengen naar de ontwikkelaars en kenniswerkers die het het hardst nodig hebben. + +Officieel BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.no.md b/docs/i18n/README.no.md index c04745e19..82858b090 100644 --- a/docs/i18n/README.no.md +++ b/docs/i18n/README.no.md @@ -1,6 +1,5 @@ 🌐 Dette er en automatisk oversettelse. Bidrag fra fellesskapet er velkomne! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Vedvarende minnekomprimeringssystem bygget for Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Hurtigstart • @@ -94,35 +125,64 @@

- Claude-Mem bevarer sømløst kontekst på tvers av økter ved automatisk å fange opp observasjoner av verktøybruk, generere semantiske sammendrag, og gjøre dem tilgjengelige for fremtidige økter. Dette gjør det mulig for Claude å opprettholde kunnskapskontinuitet om prosjekter selv etter at økter avsluttes eller gjenopprettes. + Claude-Mem bevarer sømløst kontekst på tvers av økter ved automatisk å fange opp observasjoner av verktøybruk, generere semantiske sammendrag, og gjøre dem tilgjengelige for fremtidige økter. Dette gjør det mulig for Claude å opprettholde kunnskapskontinuitet om prosjekter selv etter at økter avsluttes eller gjenopptas.

--- ## Hurtigstart -Start en ny Claude Code-økt i terminalen og skriv inn følgende kommandoer: +Installer med én enkelt kommando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Eller installer for OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Eller installer for Antigravity CLI ([oppsettsveiledning](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Eller installer fra plugin-markedsplassen inne i Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Start Claude Code på nytt. Kontekst fra tidligere økter vil automatisk vises i nye økter. +> **Merk:** Claude-Mem er også publisert på npm, men `npm install -g claude-mem` installerer kun **SDK-et/biblioteket** — det registrerer ikke plugin-hookene eller setter opp worker-tjenesten. Installer alltid via `npx claude-mem install` eller `/plugin`-kommandoene ovenfor. + +### 🦞 OpenClaw Gateway + +Installer claude-mem som en vedvarende minneplugin på [OpenClaw](https://openclaw.ai)-gatewayer med én enkelt kommando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Installasjonsprogrammet håndterer avhengigheter, plugin-oppsett, konfigurasjon av AI-leverandør, oppstart av worker, og valgfrie sanntids observasjonsstrømmer til Telegram, Discord, Slack og mer. Se [OpenClaw-integrasjonsveiledningen](https://docs.claude-mem.ai/openclaw-integration) for detaljer. + **Nøkkelfunksjoner:** - 🧠 **Vedvarende Minne** - Kontekst overlever på tvers av økter - 📊 **Progressiv Avsløring** - Lagdelt minnehenting med synlighet av tokenkostnader - 🔍 **Ferdighetsbasert Søk** - Spør om prosjekthistorikken din med mem-search-ferdigheten -- 🖥️ **Nettleser UI** - Sanntids minnestrøm på http://localhost:37777 +- 🖥️ **Nettleser-UI** - Sanntids minnestrøm på worker-URL-en som skrives ut ved oppstart - 💻 **Claude Desktop-ferdighet** - Søk i minne fra Claude Desktop-samtaler - 🔒 **Personvernkontroll** - Bruk ``-tagger for å ekskludere sensitivt innhold fra lagring - ⚙️ **Kontekstkonfigurasjon** - Finjustert kontroll over hvilken kontekst som injiseres - 🤖 **Automatisk Drift** - Ingen manuell inngripen nødvendig -- 🔗 **Kildehenvisninger** - Referer til tidligere observasjoner med ID-er (tilgang via http://localhost:37777/api/observation/{id} eller se alle i nettviseren på http://localhost:37777) -- 🧪 **Beta-kanal** - Prøv eksperimentelle funksjoner som Endless Mode via versjonsbytte +- 🔗 **Kildehenvisninger** - Referer til tidligere observasjoner med ID-er gjennom worker-API-et eller se alle i nettviseren --- @@ -135,7 +195,6 @@ Start Claude Code på nytt. Kontekst fra tidligere økter vil automatisk vises i - **[Installasjonsveiledning](https://docs.claude-mem.ai/installation)** - Hurtigstart og avansert installasjon - **[Brukerveiledning](https://docs.claude-mem.ai/usage/getting-started)** - Hvordan Claude-Mem fungerer automatisk - **[Søkeverktøy](https://docs.claude-mem.ai/usage/search-tools)** - Spør om prosjekthistorikken din med naturlig språk -- **[Beta-funksjoner](https://docs.claude-mem.ai/beta-features)** - Prøv eksperimentelle funksjoner som Endless Mode ### Beste Praksis @@ -155,7 +214,8 @@ Start Claude Code på nytt. Kontekst fra tidligere økter vil automatisk vises i ### Konfigurasjon og Utvikling - **[Konfigurasjon](https://docs.claude-mem.ai/configuration)** - Miljøvariabler og innstillinger -- **[Utvikling](https://docs.claude-mem.ai/development)** - Bygging, testing, bidragsflyt +- **[Utvikling](https://docs.claude-mem.ai/development)** - Bygging, testing, bidrag +- **[Utgivelsesgrener](https://docs.claude-mem.ai/branches)** - Flyten mellom stable-, core-dev- og community-edge-grenene - **[Feilsøking](https://docs.claude-mem.ai/troubleshooting)** - Vanlige problemer og løsninger --- @@ -166,7 +226,7 @@ Start Claude Code på nytt. Kontekst fra tidligere økter vil automatisk vises i 1. **5 Livssyklus-Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-skript) 2. **Smart Installasjon** - Bufret avhengighetssjekker (pre-hook-skript, ikke en livssyklus-hook) -3. **Worker Service** - HTTP API på port 37777 med nettleser UI og 10 søkeendepunkter, administrert av Bun +3. **Worker Service** - Lokal HTTP API med nettleser-UI og søkeendepunkter, administrert av Bun 4. **SQLite Database** - Lagrer økter, observasjoner, sammendrag 5. **mem-search-ferdighet** - Naturligspråklige spørringer med progressiv avsløring 6. **Chroma Vektordatabase** - Hybrid semantisk + nøkkelordsøk for intelligent konteksthenting @@ -175,46 +235,51 @@ Se [Arkitekturoversikt](https://docs.claude-mem.ai/architecture/overview) for de --- -## mem-search-ferdighet +## MCP-Søkeverktøy -Claude-Mem tilbyr intelligent søk gjennom mem-search-ferdigheten som automatisk aktiveres når du spør om tidligere arbeid: +Claude-Mem tilbyr intelligent minnesøk gjennom **4 MCP-verktøy** som følger et token-effektivt **3-lags arbeidsflytmønster**: + +**3-Lags Arbeidsflyten:** + +1. **`search`** - Få en kompakt indeks med ID-er (~50–100 tokens/resultat) +2. **`timeline`** - Få kronologisk kontekst rundt interessante resultater +3. **`get_observations`** - Hent fullstendige detaljer KUN for filtrerte ID-er (~500–1 000 tokens/resultat) **Hvordan Det Fungerer:** -- Bare spør naturlig: *"Hva gjorde vi forrige økt?"* eller *"Fikset vi denne feilen før?"* -- Claude aktiverer automatisk mem-search-ferdigheten for å finne relevant kontekst +- Claude bruker MCP-verktøy til å søke i minnet ditt +- Start med `search` for å få en indeks over resultater +- Bruk `timeline` for å se hva som skjedde rundt spesifikke observasjoner +- Bruk `get_observations` for å hente fullstendige detaljer for relevante ID-er +- **~10x tokenbesparelse** ved å filtrere før detaljer hentes -**Tilgjengelige Søkeoperasjoner:** +**Tilgjengelige MCP-verktøy:** -1. **Search Observations** - Fulltekstsøk på tvers av observasjoner -2. **Search Sessions** - Fulltekstsøk på tvers av øktsammendrag -3. **Search Prompts** - Søk i rå brukerforespørsler -4. **By Concept** - Finn etter konsept-tagger (discovery, problem-solution, pattern, osv.) -5. **By File** - Finn observasjoner som refererer til spesifikke filer -6. **By Type** - Finn etter type (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Få nylig øktkontekst for et prosjekt -8. **Timeline** - Få samlet tidslinje av kontekst rundt et spesifikt tidspunkt -9. **Timeline by Query** - Søk etter observasjoner og få tidslinjekontekst rundt beste treff -10. **API Help** - Få søke-API-dokumentasjon +1. **`search`** - Søk i minneindeksen med fulltekstspørringer, filtrer etter type/dato/prosjekt +2. **`timeline`** - Få kronologisk kontekst rundt en spesifikk observasjon eller spørring +3. **`get_observations`** - Hent fullstendige observasjonsdetaljer etter ID-er (samle alltid flere ID-er) -**Eksempel på Naturligspråklige Spørringer:** +**Eksempel på Bruk:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Steg 1: Søk for å få indeks +search(query="authentication bug", type="bugfix", limit=10) + +// Steg 2: Gjennomgå indeksen, identifiser relevante ID-er (f.eks. #123, #456) + +// Steg 3: Hent fullstendige detaljer +get_observations(ids=[123, 456]) ``` Se [Søkeverktøy-veiledning](https://docs.claude-mem.ai/usage/search-tools) for detaljerte eksempler. --- -## Beta-funksjoner +## Utgivelsesgrener -Claude-Mem tilbyr en **beta-kanal** med eksperimentelle funksjoner som **Endless Mode** (biomimetisk minnearkitektur for utvidede økter). Bytt mellom stabile og beta-versjoner fra nettleser-UI på http://localhost:37777 → Settings. - -Se **[Beta-funksjoner Dokumentasjon](https://docs.claude-mem.ai/beta-features)** for detaljer om Endless Mode og hvordan du prøver det. +Stabile utgivelser leveres fra `main` og publiseres til npm. `core-dev` og +`community-edge` er kildekjørte grener for tidlige pålitelighetsfikser og +integrasjoner fra fellesskapet. Se **[Utgivelsesgrener](https://docs.claude-mem.ai/branches)** +for grenflyten og instruksjoner for å kjøre ikke-stabile versjoner. --- @@ -226,6 +291,17 @@ Se **[Beta-funksjoner Dokumentasjon](https://docs.claude-mem.ai/beta-features)** - **uv**: Python-pakkeadministrator for vektorsøk (autoinstalleres hvis mangler) - **SQLite 3**: For vedvarende lagring (inkludert) +--- +### Merknader om Windows-oppsett + +Hvis du ser en feil som denne: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Sørg for at Node.js og npm er installert og lagt til i din PATH. Last ned den nyeste Node.js-installereren fra https://nodejs.org og start terminalen på nytt etter installasjonen. + --- ## Konfigurasjon @@ -234,6 +310,45 @@ Innstillinger administreres i `~/.claude-mem/settings.json` (opprettes automatis Se **[Konfigurasjonsveiledning](https://docs.claude-mem.ai/configuration)** for alle tilgjengelige innstillinger og eksempler. +### Modus- og Språkkonfigurasjon + +Claude-Mem støtter flere arbeidsflytmoduser og språk via innstillingen `CLAUDE_MEM_MODE`. + +Dette valget styrer både: +- Arbeidsflytatferden (f.eks. code, chill, investigation) +- Språket som brukes i genererte observasjoner + +#### Hvordan Konfigurere + +Rediger innstillingsfilen din på `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Moduser er definert i `plugin/modes/`. For å se alle tilgjengelige moduser lokalt: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Tilgjengelige Moduser + +| Modus | Beskrivelse | +|------------|-------------------------| +| `code` | Standard engelsk modus | +| `code--zh` | Forenklet kinesisk modus | +| `code--ja` | Japansk modus | + +Språkspesifikke moduser følger mønsteret `code--[språk]` der `[språk]` er ISO 639-1-språkkoden (f.eks. `zh` for kinesisk, `ja` for japansk, `es` for spansk). + +> Merk: `code--zh` (forenklet kinesisk) er allerede innebygd — ingen ytterligere installasjon eller plugin-oppdatering er nødvendig. + +#### Etter Endring av Modus + +Start Claude Code på nytt for å ta i bruk den nye modus-konfigurasjonen. --- ## Utvikling @@ -244,7 +359,7 @@ Se **[Utviklingsveiledning](https://docs.claude-mem.ai/development)** for byggei ## Feilsøking -Hvis du opplever problemer, beskriv problemet til Claude og troubleshoot-ferdigheten vil automatisk diagnostisere og gi løsninger. +Hvis du opplever problemer, beskriv problemet til Claude, så vil troubleshoot-ferdigheten automatisk diagnostisere det og gi løsninger. Se **[Feilsøkingsveiledning](https://docs.claude-mem.ai/troubleshooting)** for vanlige problemer og løsninger. @@ -269,34 +384,48 @@ Bidrag er velkomne! Vennligst: 4. Oppdater dokumentasjonen 5. Send inn en Pull Request +Claude-Mem leveres fra tre grener: `main` (stabil), `core-dev`, og +`community-edge`. Kun `main` publiseres til npm; de andre kjøres fra +kildekoden. Se [Utgivelsesgrener](https://docs.claude-mem.ai/branches) for +strategien og instruksjoner for lokal kjøring. + Se [Utviklingsveiledning](https://docs.claude-mem.ai/development) for bidragsflyt. --- -## License +## Lisens -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem er lisensiert under Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Vi valgte Apache-2.0 fordi varig agentisk minne bør være enkelt å bygge inn i +utviklerverktøy, lokale agenter, MCP-servere, bedriftssystemer, robotikkstakker +og produksjonsagent-harnesser. -See the [LICENSE](LICENSE) file for full details. +Se filen [LICENSE](LICENSE) for fullstendige detaljer. Se [docs/license.md](docs/license.md) +og [docs/ip-boundary.md](docs/ip-boundary.md) for lisensieringsomfang og +grensen mellom åpen kildekode og kommersiell bruk. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Merknad om Ragtime**: Katalogen `ragtime/` er lisensiert under **Apache License 2.0**. Se [ragtime/LICENSE](ragtime/LICENSE) for detaljer. --- - ## Støtte - **Dokumentasjon**: [docs/](docs/) - **Problemer**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Offisiell X-konto**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Offisiell Discord**: [Bli med på Discord](https://discord.com/invite/J4wttp9vDu) - **Forfatter**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Bygget med Claude Agent SDK** | **Drevet av Claude Code** | **Laget med TypeScript** +**Bygget med Claude Agent SDK** | **Fungerer med Claude Code** | **Laget med TypeScript** ---- \ No newline at end of file +--- + +### Hva Med CMEM? + +CMEM er et token opprettet av en tredjepart, men offisielt omfavnet av skaperen av Claude-Mem (Alex Newman, @thedotmack). Tokenet fungerer som en katalysator for fellesskapets vekst og et middel for å bringe CMEM til utviklerne og kunnskapsarbeiderne som trenger det mest. + +Offisiell BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.pl.md b/docs/i18n/README.pl.md index 6c7973a5c..cdd333584 100644 --- a/docs/i18n/README.pl.md +++ b/docs/i18n/README.pl.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

System trwałej kompresji pamięci stworzony dla Claude Code.

- License + License Version @@ -74,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Szybki Start • Jak To Działa • - Narzędzia Wyszukiwania • + Narzędzia Wyszukiwania • Dokumentacja • Konfiguracja • Rozwiązywanie Problemów • @@ -93,35 +125,64 @@

- Claude-Mem płynnie zachowuje kontekst między sesjami, automatycznie przechwytując obserwacje użycia narzędzi, generując semantyczne podsumowania i udostępniając je przyszłym sesjom. To umożliwia Claude utrzymanie ciągłości wiedzy o projektach nawet po zakończeniu lub ponownym połączeniu sesji. + Claude-Mem płynnie zachowuje kontekst między sesjami, automatycznie przechwytując obserwacje użycia narzędzi, generując semantyczne podsumowania i udostępniając je przyszłym sesjom. Dzięki temu Claude może utrzymać ciągłość wiedzy o projektach nawet po zakończeniu sesji lub ponownym połączeniu.

--- ## Szybki Start -Uruchom nową sesję Claude Code w terminalu i wprowadź następujące polecenia: +Zainstaluj za pomocą jednego polecenia: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Lub zainstaluj dla OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Lub zainstaluj dla Antigravity CLI ([przewodnik konfiguracji](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Lub zainstaluj z marketplace wtyczek wewnątrz Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi się w nowych sesjach. +> **Uwaga:** Claude-Mem jest również opublikowany na npm, ale `npm install -g claude-mem` instaluje **wyłącznie SDK/bibliotekę** — nie rejestruje hooków wtyczki ani nie konfiguruje usługi worker. Zawsze instaluj za pomocą `npx claude-mem install` lub powyższych poleceń `/plugin`. + +### 🦞 OpenClaw Gateway + +Zainstaluj claude-mem jako wtyczkę trwałej pamięci na bramkach [OpenClaw](https://openclaw.ai) za pomocą jednego polecenia: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Instalator obsługuje zależności, konfigurację wtyczki, konfigurację dostawcy AI, uruchomienie workera oraz opcjonalne strumienie obserwacji w czasie rzeczywistym do Telegram, Discord, Slack i innych. Zobacz [Przewodnik Integracji OpenClaw](https://docs.claude-mem.ai/openclaw-integration), aby poznać szczegóły. + **Kluczowe Funkcje:** - 🧠 **Trwała Pamięć** - Kontekst przetrwa między sesjami - 📊 **Stopniowe Ujawnianie** - Warstwowe pobieranie pamięci z widocznością kosztów tokenów - 🔍 **Wyszukiwanie Oparte na Umiejętnościach** - Przeszukuj historię projektu za pomocą umiejętności mem-search -- 🖥️ **Interfejs Przeglądarki Internetowej** - Strumień pamięci w czasie rzeczywistym pod adresem http://localhost:37777 +- 🖥️ **Interfejs Przeglądarki Internetowej** - Strumień pamięci w czasie rzeczywistym pod adresem URL workera wyświetlonym przy uruchomieniu - 💻 **Umiejętność Claude Desktop** - Przeszukuj pamięć z konwersacji Claude Desktop - 🔒 **Kontrola Prywatności** - Użyj tagów ``, aby wykluczyć wrażliwe treści z przechowywania - ⚙️ **Konfiguracja Kontekstu** - Szczegółowa kontrola nad tym, jaki kontekst jest wstrzykiwany - 🤖 **Automatyczne Działanie** - Nie wymaga ręcznej interwencji -- 🔗 **Cytowania** - Odniesienia do przeszłych obserwacji za pomocą identyfikatorów (dostęp przez http://localhost:37777/api/observation/{id} lub wyświetl wszystkie w przeglądarce internetowej pod adresem http://localhost:37777) -- 🧪 **Kanał Beta** - Wypróbuj eksperymentalne funkcje, takie jak Endless Mode, poprzez przełączanie wersji +- 🔗 **Cytowania** - Odniesienia do przeszłych obserwacji za pomocą identyfikatorów przez API workera lub wyświetl wszystkie w przeglądarce internetowej --- @@ -134,7 +195,6 @@ Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi - **[Przewodnik Instalacji](https://docs.claude-mem.ai/installation)** - Szybki start i zaawansowana instalacja - **[Przewodnik Użytkowania](https://docs.claude-mem.ai/usage/getting-started)** - Jak Claude-Mem działa automatycznie - **[Narzędzia Wyszukiwania](https://docs.claude-mem.ai/usage/search-tools)** - Przeszukuj historię projektu w języku naturalnym -- **[Funkcje Beta](https://docs.claude-mem.ai/beta-features)** - Wypróbuj eksperymentalne funkcje, takie jak Endless Mode ### Najlepsze Praktyki @@ -155,6 +215,7 @@ Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi - **[Konfiguracja](https://docs.claude-mem.ai/configuration)** - Zmienne środowiskowe i ustawienia - **[Rozwój](https://docs.claude-mem.ai/development)** - Budowanie, testowanie, współpraca +- **[Gałęzie Wydań](https://docs.claude-mem.ai/branches)** - Przepływ gałęzi stable, core-dev i community-edge - **[Rozwiązywanie Problemów](https://docs.claude-mem.ai/troubleshooting)** - Typowe problemy i rozwiązania --- @@ -165,55 +226,60 @@ Uruchom ponownie Claude Code. Kontekst z poprzednich sesji automatycznie pojawi 1. **5 Hooków Cyklu Życia** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skryptów hooków) 2. **Inteligentna Instalacja** - Buforowany sprawdzacz zależności (skrypt pre-hook, nie hook cyklu życia) -3. **Usługa Worker** - HTTP API na porcie 37777 z interfejsem przeglądarki internetowej i 10 punktami końcowymi wyszukiwania, zarządzana przez Bun +3. **Usługa Worker** - Lokalne HTTP API z interfejsem przeglądarki internetowej i punktami końcowymi wyszukiwania, zarządzane przez Bun 4. **Baza Danych SQLite** - Przechowuje sesje, obserwacje, podsumowania 5. **Umiejętność mem-search** - Zapytania w języku naturalnym ze stopniowym ujawnianiem 6. **Baza Wektorów Chroma** - Hybrydowe wyszukiwanie semantyczne + słowa kluczowe dla inteligentnego pobierania kontekstu -Zobacz [Przegląd Architektury](https://docs.claude-mem.ai/architecture/overview) dla szczegółów. +Zobacz [Przegląd Architektury](https://docs.claude-mem.ai/architecture/overview), aby poznać szczegóły. --- -## Umiejętność mem-search +## Narzędzia Wyszukiwania MCP -Claude-Mem zapewnia inteligentne wyszukiwanie poprzez umiejętność mem-search, która automatycznie aktywuje się, gdy pytasz o przeszłą pracę: +Claude-Mem zapewnia inteligentne wyszukiwanie pamięci poprzez **4 narzędzia MCP** zgodnie z efektywnym pod względem tokenów wzorcem **3-warstwowego przepływu pracy**: + +**3-Warstwowy Przepływ Pracy:** + +1. **`search`** - Uzyskaj kompaktowy indeks z identyfikatorami (~50-100 tokenów/wynik) +2. **`timeline`** - Uzyskaj chronologiczny kontekst wokół interesujących wyników +3. **`get_observations`** - Pobierz pełne szczegóły TYLKO dla przefiltrowanych identyfikatorów (~500-1 000 tokenów/wynik) **Jak To Działa:** -- Po prostu pytaj naturalnie: *"Co robiliśmy w ostatniej sesji?"* lub *"Czy naprawiliśmy ten błąd wcześniej?"* -- Claude automatycznie wywołuje umiejętność mem-search, aby znaleźć odpowiedni kontekst +- Claude używa narzędzi MCP do przeszukiwania Twojej pamięci +- Zacznij od `search`, aby uzyskać indeks wyników +- Użyj `timeline`, aby zobaczyć, co działo się wokół konkretnych obserwacji +- Użyj `get_observations`, aby pobrać pełne szczegóły dla odpowiednich identyfikatorów +- **Oszczędność tokenów ~10x** dzięki filtrowaniu przed pobraniem szczegółów -**Dostępne Operacje Wyszukiwania:** +**Dostępne Narzędzia MCP:** -1. **Search Observations** - Wyszukiwanie pełnotekstowe w obserwacjach -2. **Search Sessions** - Wyszukiwanie pełnotekstowe w podsumowaniach sesji -3. **Search Prompts** - Wyszukiwanie surowych żądań użytkownika -4. **By Concept** - Znajdź według tagów koncepcyjnych (discovery, problem-solution, pattern, itp.) -5. **By File** - Znajdź obserwacje odnoszące się do określonych plików -6. **By Type** - Znajdź według typu (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Pobierz ostatni kontekst sesji dla projektu -8. **Timeline** - Uzyskaj ujednoliconą oś czasu kontekstu wokół określonego punktu w czasie -9. **Timeline by Query** - Wyszukaj obserwacje i uzyskaj kontekst osi czasu wokół najlepszego dopasowania -10. **API Help** - Uzyskaj dokumentację API wyszukiwania +1. **`search`** - Przeszukuj indeks pamięci za pomocą zapytań pełnotekstowych, filtruj według typu/daty/projektu +2. **`timeline`** - Uzyskaj chronologiczny kontekst wokół konkretnej obserwacji lub zapytania +3. **`get_observations`** - Pobierz pełne szczegóły obserwacji według identyfikatorów (zawsze grupuj wiele identyfikatorów) -**Przykładowe Zapytania w Języku Naturalnym:** +**Przykładowe Użycie:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Krok 1: Wyszukaj indeks +search(query="authentication bug", type="bugfix", limit=10) + +// Krok 2: Przejrzyj indeks, zidentyfikuj odpowiednie identyfikatory (np. #123, #456) + +// Krok 3: Pobierz pełne szczegóły +get_observations(ids=[123, 456]) ``` -Zobacz [Przewodnik Narzędzi Wyszukiwania](https://docs.claude-mem.ai/usage/search-tools) dla szczegółowych przykładów. +Zobacz [Przewodnik Narzędzi Wyszukiwania](https://docs.claude-mem.ai/usage/search-tools), aby poznać szczegółowe przykłady. --- -## Funkcje Beta +## Gałęzie Wydań -Claude-Mem oferuje **kanał beta** z eksperymentalnymi funkcjami, takimi jak **Endless Mode** (biomimetyczna architektura pamięci dla rozszerzonych sesji). Przełączaj się między stabilnymi a beta wersjami z interfejsu przeglądarki internetowej pod adresem http://localhost:37777 → Settings. - -Zobacz **[Dokumentacja Funkcji Beta](https://docs.claude-mem.ai/beta-features)** dla szczegółów dotyczących Endless Mode i sposobu wypróbowania. +Stabilne wydania są publikowane z gałęzi `main` i trafiają do npm. `core-dev` i +`community-edge` to gałęzie uruchamiane ze źródła, przeznaczone do wczesnych poprawek +niezawodności i integracji społeczności. Zobacz **[Gałęzie Wydań](https://docs.claude-mem.ai/branches)**, +aby poznać przepływ gałęzi i instrukcje uruchamiania wersji niestabilnych. --- @@ -225,19 +291,69 @@ Zobacz **[Dokumentacja Funkcji Beta](https://docs.claude-mem.ai/beta-features)** - **uv**: Menedżer pakietów Python do wyszukiwania wektorowego (automatycznie instalowany, jeśli brakuje) - **SQLite 3**: Do trwałego przechowywania (dołączony) +--- +### Uwagi Dotyczące Konfiguracji na Windows + +Jeśli widzisz błąd podobny do: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Upewnij się, że Node.js i npm są zainstalowane i dodane do zmiennej PATH. Pobierz najnowszy instalator Node.js ze strony https://nodejs.org i uruchom ponownie terminal po instalacji. + --- ## Konfiguracja Ustawienia są zarządzane w `~/.claude-mem/settings.json` (automatycznie tworzone z domyślnymi wartościami przy pierwszym uruchomieniu). Skonfiguruj model AI, port workera, katalog danych, poziom logowania i ustawienia wstrzykiwania kontekstu. -Zobacz **[Przewodnik Konfiguracji](https://docs.claude-mem.ai/configuration)** dla wszystkich dostępnych ustawień i przykładów. +Zobacz **[Przewodnik Konfiguracji](https://docs.claude-mem.ai/configuration)**, aby poznać wszystkie dostępne ustawienia i przykłady. +### Konfiguracja Trybu i Języka + +Claude-Mem obsługuje wiele trybów pracy i języków poprzez ustawienie `CLAUDE_MEM_MODE`. + +Ta opcja kontroluje jednocześnie: +- Zachowanie przepływu pracy (np. code, chill, investigation) +- Język używany w generowanych obserwacjach + +#### Jak Skonfigurować + +Edytuj plik ustawień w `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Tryby są zdefiniowane w `plugin/modes/`. Aby zobaczyć wszystkie dostępne tryby lokalnie: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Dostępne Tryby + +| Tryb | Opis | +|------------|-------------------------| +| `code` | Domyślny tryb angielski | +| `code--zh` | Tryb uproszczonego chińskiego | +| `code--ja` | Tryb japoński | + +Tryby specyficzne dla języka podążają za wzorcem `code--[lang]`, gdzie `[lang]` to kod języka ISO 639-1 (np. `zh` dla chińskiego, `ja` dla japońskiego, `es` dla hiszpańskiego). + +> Uwaga: `code--zh` (uproszczony chiński) jest już wbudowany — nie jest wymagana dodatkowa instalacja ani aktualizacja wtyczki. + +#### Po Zmianie Trybu + +Uruchom ponownie Claude Code, aby zastosować nową konfigurację trybu. --- ## Rozwój -Zobacz **[Przewodnik Rozwoju](https://docs.claude-mem.ai/development)** dla instrukcji budowania, testowania i przepływu pracy współpracy. +Zobacz **[Przewodnik Rozwoju](https://docs.claude-mem.ai/development)**, aby poznać instrukcje budowania, testowania i przepływu pracy współpracy. --- @@ -268,32 +384,48 @@ Wkład jest mile widziany! Proszę: 4. Zaktualizuj dokumentację 5. Prześlij Pull Request +Claude-Mem jest wydawany z trzech gałęzi: `main` (stabilna), `core-dev` oraz +`community-edge`. Tylko `main` jest publikowana na npm; pozostałe są uruchamiane +ze źródła. Zobacz [Gałęzie Wydań](https://docs.claude-mem.ai/branches), aby poznać +strategię i instrukcje lokalnego uruchamiania. + Zobacz [Przewodnik Rozwoju](https://docs.claude-mem.ai/development) dla przepływu pracy współpracy. --- -## License +## Licencja -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem jest licencjonowany na podstawie Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Wybraliśmy Apache-2.0, ponieważ trwała pamięć agentowa powinna być łatwa do +osadzenia w narzędziach deweloperskich, lokalnych agentach, serwerach MCP, +systemach korporacyjnych, stosach robotyki i produkcyjnych środowiskach agentów. -See the [LICENSE](LICENSE) file for full details. +Zobacz plik [LICENSE](LICENSE), aby poznać pełne szczegóły. Zobacz [docs/license.md](docs/license.md) +oraz [docs/ip-boundary.md](docs/ip-boundary.md), aby poznać zakres licencjonowania i +granicę między wersją otwartą a komercyjną. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Uwaga dotycząca Ragtime**: Katalog `ragtime/` jest licencjonowany na podstawie **Apache License 2.0**. Zobacz [ragtime/LICENSE](ragtime/LICENSE), aby poznać szczegóły. --- - ## Wsparcie - **Dokumentacja**: [docs/](docs/) - **Problemy**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repozytorium**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Oficjalne Konto X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Oficjalny Discord**: [Dołącz do Discord](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Zbudowano za pomocą Claude Agent SDK** | **Zasilane przez Claude Code** | **Wykonane w TypeScript** \ No newline at end of file +**Zbudowano za pomocą Claude Agent SDK** | **Działa z Claude Code** | **Wykonane w TypeScript** + +--- + +### A Co z CMEM? + +CMEM to token stworzony przez stronę trzecią, ale oficjalnie zaakceptowany przez twórcę Claude-Mem (Alex Newman, @thedotmack). Token pełni rolę katalizatora rozwoju społeczności i wehikułu wprowadzającego CMEM do deweloperów i pracowników wiedzy, którzy najbardziej go potrzebują. + +Oficjalny adres kontraktu BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.pt-br.md b/docs/i18n/README.pt-br.md index a3a9961d8..343d328bc 100644 --- a/docs/i18n/README.pt-br.md +++ b/docs/i18n/README.pt-br.md @@ -1,6 +1,5 @@ 🌐 Esta é uma tradução automatizada. Correções da comunidade são bem-vindas! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Sistema de compressão de memória persistente construído para Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Início Rápido • @@ -94,48 +125,76 @@

- Claude-Mem preserva o contexto perfeitamente entre sessões, capturando automaticamente observações de uso de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isso permite que Claude mantenha a continuidade do conhecimento sobre projetos mesmo após o término ou reconexão de sessões. + Claude-Mem preserva o contexto perfeitamente entre sessões, capturando automaticamente observações de uso de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isso permite que o Claude mantenha a continuidade do conhecimento sobre projetos mesmo após o término ou a reconexão das sessões.

--- ## Início Rápido -Inicie uma nova sessão do Claude Code no terminal e digite os seguintes comandos: +Instale com um único comando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Ou instale para o OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Ou instale para o Antigravity CLI ([guia de configuração](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Ou instale a partir do marketplace de plugins dentro do Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticamente em novas sessões. +> **Observação:** o Claude-Mem também é publicado no npm, mas `npm install -g claude-mem` instala **apenas o SDK/biblioteca** — ele não registra os hooks do plugin nem configura o serviço worker. Sempre instale via `npx claude-mem install` ou pelos comandos `/plugin` acima. + +### 🦞 OpenClaw Gateway + +Instale o claude-mem como um plugin de memória persistente em gateways [OpenClaw](https://openclaw.ai) com um único comando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +O instalador cuida das dependências, da configuração do plugin, da configuração do provedor de IA, da inicialização do worker e de feeds opcionais de observação em tempo real para Telegram, Discord, Slack e outros. Consulte o [Guia de Integração com o OpenClaw](https://docs.claude-mem.ai/openclaw-integration) para mais detalhes. + **Principais Recursos:** - 🧠 **Memória Persistente** - O contexto sobrevive entre sessões - 📊 **Divulgação Progressiva** - Recuperação de memória em camadas com visibilidade de custo de tokens -- 🔍 **Busca Baseada em Skill** - Consulte seu histórico de projeto com a skill mem-search -- 🖥️ **Interface Web de Visualização** - Fluxo de memória em tempo real em http://localhost:37777 +- 🔍 **Busca Baseada em Skill** - Consulte o histórico do seu projeto com a skill mem-search +- 🖥️ **Interface Web de Visualização** - Fluxo de memória em tempo real na URL do worker exibida na inicialização - 💻 **Skill para Claude Desktop** - Busque memória em conversas do Claude Desktop - 🔒 **Controle de Privacidade** - Use tags `` para excluir conteúdo sensível do armazenamento - ⚙️ **Configuração de Contexto** - Controle refinado sobre qual contexto é injetado - 🤖 **Operação Automática** - Nenhuma intervenção manual necessária -- 🔗 **Citações** - Referencie observações passadas com IDs (acesse via http://localhost:37777/api/observation/{id} ou visualize todas no visualizador web em http://localhost:37777) -- 🧪 **Canal Beta** - Experimente recursos experimentais como o Endless Mode através da troca de versões +- 🔗 **Citações** - Referencie observações passadas com IDs através da API do worker ou visualize todas no visualizador web --- ## Documentação -📚 **[Ver Documentação Completa](https://docs.claude-mem.ai/)** - Navegar no site oficial +📚 **[Ver Documentação Completa](https://docs.claude-mem.ai/)** - Navegue no site oficial ### Começando - **[Guia de Instalação](https://docs.claude-mem.ai/installation)** - Início rápido e instalação avançada -- **[Guia de Uso](https://docs.claude-mem.ai/usage/getting-started)** - Como Claude-Mem funciona automaticamente -- **[Ferramentas de Busca](https://docs.claude-mem.ai/usage/search-tools)** - Consulte seu histórico de projeto com linguagem natural -- **[Recursos Beta](https://docs.claude-mem.ai/beta-features)** - Experimente recursos experimentais como o Endless Mode +- **[Guia de Uso](https://docs.claude-mem.ai/usage/getting-started)** - Como o Claude-Mem funciona automaticamente +- **[Ferramentas de Busca](https://docs.claude-mem.ai/usage/search-tools)** - Consulte o histórico do seu projeto com linguagem natural ### Melhores Práticas @@ -146,7 +205,7 @@ Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticam - **[Visão Geral](https://docs.claude-mem.ai/architecture/overview)** - Componentes do sistema e fluxo de dados - **[Evolução da Arquitetura](https://docs.claude-mem.ai/architecture-evolution)** - A jornada da v3 à v5 -- **[Arquitetura de Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Como Claude-Mem usa hooks de ciclo de vida +- **[Arquitetura de Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Como o Claude-Mem usa hooks de ciclo de vida - **[Referência de Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripts de hook explicados - **[Serviço Worker](https://docs.claude-mem.ai/architecture/worker-service)** - API HTTP e gerenciamento do Bun - **[Banco de Dados](https://docs.claude-mem.ai/architecture/database)** - Schema SQLite e busca FTS5 @@ -156,6 +215,7 @@ Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticam - **[Configuração](https://docs.claude-mem.ai/configuration)** - Variáveis de ambiente e configurações - **[Desenvolvimento](https://docs.claude-mem.ai/development)** - Build, testes e contribuição +- **[Branches de Release](https://docs.claude-mem.ai/branches)** - Fluxo das branches stable, core-dev e community-edge - **[Solução de Problemas](https://docs.claude-mem.ai/troubleshooting)** - Problemas comuns e soluções --- @@ -166,7 +226,7 @@ Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticam 1. **5 Hooks de Ciclo de Vida** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook) 2. **Instalação Inteligente** - Verificador de dependências em cache (script pré-hook, não um hook de ciclo de vida) -3. **Serviço Worker** - API HTTP na porta 37777 com interface de visualização web e 10 endpoints de busca, gerenciado pelo Bun +3. **Serviço Worker** - API HTTP local com interface de visualização web e endpoints de busca, gerenciado pelo Bun 4. **Banco de Dados SQLite** - Armazena sessões, observações, resumos 5. **Skill mem-search** - Consultas em linguagem natural com divulgação progressiva 6. **Banco de Dados Vetorial Chroma** - Busca híbrida semântica + palavra-chave para recuperação inteligente de contexto @@ -175,46 +235,51 @@ Veja [Visão Geral da Arquitetura](https://docs.claude-mem.ai/architecture/overv --- -## Skill mem-search +## Ferramentas de Busca MCP -Claude-Mem fornece busca inteligente através da skill mem-search que se auto-invoca quando você pergunta sobre trabalhos anteriores: +O Claude-Mem fornece busca inteligente de memória através de **4 ferramentas MCP** seguindo um padrão de fluxo de trabalho em **3 camadas**, eficiente em termos de tokens: + +**O Fluxo de Trabalho em 3 Camadas:** + +1. **`search`** - Obtenha um índice compacto com IDs (~50-100 tokens/resultado) +2. **`timeline`** - Obtenha o contexto cronológico em torno de resultados interessantes +3. **`get_observations`** - Busque detalhes completos APENAS para os IDs filtrados (~500-1.000 tokens/resultado) **Como Funciona:** -- Apenas pergunte naturalmente: *"O que fizemos na última sessão?"* ou *"Já corrigimos esse bug antes?"* -- Claude invoca automaticamente a skill mem-search para encontrar contexto relevante +- O Claude usa ferramentas MCP para buscar na sua memória +- Comece com `search` para obter um índice de resultados +- Use `timeline` para ver o que estava acontecendo em torno de observações específicas +- Use `get_observations` para buscar detalhes completos dos IDs relevantes +- **Economia de tokens de ~10x** ao filtrar antes de buscar os detalhes -**Operações de Busca Disponíveis:** +**Ferramentas MCP Disponíveis:** -1. **Search Observations** - Busca de texto completo em observações -2. **Search Sessions** - Busca de texto completo em resumos de sessão -3. **Search Prompts** - Busca em solicitações brutas do usuário -4. **By Concept** - Encontre por tags de conceito (discovery, problem-solution, pattern, etc.) -5. **By File** - Encontre observações que referenciam arquivos específicos -6. **By Type** - Encontre por tipo (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Obtenha contexto de sessão recente para um projeto -8. **Timeline** - Obtenha linha do tempo unificada de contexto em torno de um ponto específico no tempo -9. **Timeline by Query** - Busque observações e obtenha contexto de linha do tempo em torno da melhor correspondência -10. **API Help** - Obtenha documentação da API de busca +1. **`search`** - Busca no índice de memória com consultas de texto completo, filtros por tipo/data/projeto +2. **`timeline`** - Obtenha o contexto cronológico em torno de uma observação ou consulta específica +3. **`get_observations`** - Busque detalhes completos de observações por IDs (sempre agrupe múltiplos IDs) -**Exemplos de Consultas em Linguagem Natural:** +**Exemplo de Uso:** -``` -"Quais bugs corrigimos na última sessão?" -"Como implementamos a autenticação?" -"Quais mudanças foram feitas em worker-service.ts?" -"Mostre-me trabalhos recentes neste projeto" -"O que estava acontecendo quando adicionamos a interface de visualização?" +```typescript +// Etapa 1: Buscar o índice +search(query="authentication bug", type="bugfix", limit=10) + +// Etapa 2: Revisar o índice, identificar IDs relevantes (ex.: #123, #456) + +// Etapa 3: Buscar os detalhes completos +get_observations(ids=[123, 456]) ``` -Veja [Guia de Ferramentas de Busca](https://docs.claude-mem.ai/usage/search-tools) para exemplos detalhados. +Veja o [Guia de Ferramentas de Busca](https://docs.claude-mem.ai/usage/search-tools) para exemplos detalhados. --- -## Recursos Beta +## Branches de Release -Claude-Mem oferece um **canal beta** com recursos experimentais como **Endless Mode** (arquitetura de memória biomimética para sessões estendidas). Alterne entre versões estável e beta pela interface de visualização web em http://localhost:37777 → Settings. - -Veja **[Documentação de Recursos Beta](https://docs.claude-mem.ai/beta-features)** para detalhes sobre o Endless Mode e como experimentá-lo. +Os releases estáveis são publicados a partir da branch `main` e disponibilizados no npm. As branches `core-dev` e +`community-edge` são branches executadas a partir do código-fonte para correções de confiabilidade antecipadas e +integrações da comunidade. Veja **[Branches de Release](https://docs.claude-mem.ai/branches)** +para o fluxo das branches e instruções de execução não estável. --- @@ -226,14 +291,64 @@ Veja **[Documentação de Recursos Beta](https://docs.claude-mem.ai/beta-feature - **uv**: Gerenciador de pacotes Python para busca vetorial (instalado automaticamente se ausente) - **SQLite 3**: Para armazenamento persistente (incluído) +--- +### Notas de Configuração para Windows + +Se você vir um erro como: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Certifique-se de que o Node.js e o npm estejam instalados e adicionados ao seu PATH. Baixe o instalador mais recente do Node.js em https://nodejs.org e reinicie seu terminal após a instalação. + --- ## Configuração -As configurações são gerenciadas em `~/.claude-mem/settings.json` (criado automaticamente com valores padrão na primeira execução). Configure modelo de IA, porta do worker, diretório de dados, nível de log e configurações de injeção de contexto. +As configurações são gerenciadas em `~/.claude-mem/settings.json` (criado automaticamente com valores padrão na primeira execução). Configure o modelo de IA, a porta do worker, o diretório de dados, o nível de log e as configurações de injeção de contexto. Veja o **[Guia de Configuração](https://docs.claude-mem.ai/configuration)** para todas as configurações disponíveis e exemplos. +### Configuração de Modo e Idioma + +O Claude-Mem oferece suporte a múltiplos modos de fluxo de trabalho e idiomas através da configuração `CLAUDE_MEM_MODE`. + +Essa opção controla: +- O comportamento do fluxo de trabalho (ex.: code, chill, investigation) +- O idioma usado nas observações geradas + +#### Como Configurar + +Edite seu arquivo de configurações em `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Os modos são definidos em `plugin/modes/`. Para ver todos os modos disponíveis localmente: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Modos Disponíveis + +| Modo | Descrição | +|------------|-------------------------| +| `code` | Modo padrão em inglês | +| `code--zh` | Modo em chinês simplificado | +| `code--ja` | Modo em japonês | + +Os modos específicos de idioma seguem o padrão `code--[lang]`, onde `[lang]` é o código de idioma ISO 639-1 (ex.: `zh` para chinês, `ja` para japonês, `es` para espanhol). + +> Observação: o `code--zh` (chinês simplificado) já vem integrado — nenhuma instalação adicional ou atualização de plugin é necessária. + +#### Após Alterar o Modo + +Reinicie o Claude Code para aplicar a nova configuração de modo. --- ## Desenvolvimento @@ -244,7 +359,7 @@ Veja o **[Guia de Desenvolvimento](https://docs.claude-mem.ai/development)** par ## Solução de Problemas -Se você estiver enfrentando problemas, descreva o problema para Claude e a skill troubleshoot diagnosticará automaticamente e fornecerá correções. +Se estiver enfrentando problemas, descreva o problema para o Claude e a skill troubleshoot diagnosticará automaticamente e fornecerá correções. Veja o **[Guia de Solução de Problemas](https://docs.claude-mem.ai/troubleshooting)** para problemas comuns e soluções. @@ -269,32 +384,48 @@ Contribuições são bem-vindas! Por favor: 4. Atualize a documentação 5. Envie um Pull Request -Veja [Guia de Desenvolvimento](https://docs.claude-mem.ai/development) para o fluxo de contribuição. +O Claude-Mem é distribuído a partir de três branches: `main` (estável), `core-dev` e +`community-edge`. Apenas a `main` é publicada no npm; as demais são executadas a partir do +código-fonte. Veja [Branches de Release](https://docs.claude-mem.ai/branches) para a +estratégia e instruções de execução local. + +Veja o [Guia de Desenvolvimento](https://docs.claude-mem.ai/development) para o fluxo de contribuição. --- -## License +## Licença -This project is licensed under the **Apache License 2.0** (Apache-2.0). +O Claude-Mem é licenciado sob a Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Escolhemos a Apache-2.0 porque a memória agêntica duradoura deve ser fácil de incorporar em +ferramentas de desenvolvimento, agentes locais, servidores MCP, sistemas empresariais, stacks de robótica +e harnesses de agentes em produção. -See the [LICENSE](LICENSE) file for full details. +Veja o arquivo [LICENSE](LICENSE) para todos os detalhes. Veja [docs/license.md](docs/license.md) +e [docs/ip-boundary.md](docs/ip-boundary.md) para o escopo de licenciamento e a +fronteira entre o aberto e o comercial. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Nota sobre o Ragtime**: o diretório `ragtime/` é licenciado sob a **Apache License 2.0**. Veja [ragtime/LICENSE](ragtime/LICENSE) para detalhes. --- - ## Suporte - **Documentação**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repositório**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Conta X Oficial**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Oficial**: [Entrar no Discord](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Construído com Claude Agent SDK** | **Desenvolvido por Claude Code** | **Feito com TypeScript** \ No newline at end of file +**Construído com Claude Agent SDK** | **Funciona com Claude Code** | **Feito com TypeScript** + +--- + +### E o CMEM? + +CMEM é um token criado por terceiros, mas oficialmente adotado pelo criador do Claude-Mem (Alex Newman, @thedotmack). O token funciona como um catalisador comunitário de crescimento e um veículo para levar o CMEM aos desenvolvedores e profissionais do conhecimento que mais precisam dele. + +CA Oficial na BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.pt.md b/docs/i18n/README.pt.md new file mode 100644 index 000000000..9e1ff0919 --- /dev/null +++ b/docs/i18n/README.pt.md @@ -0,0 +1,433 @@ +🌐 Esta é uma tradução automática. Correções da comunidade são bem-vindas! + +

+
+ + + + + Claude-Mem + + +
+ + Vercel OSS Program + +

+ +

+ 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk +

+ +

Sistema de compressão de memória persistente construído para o Claude Code.

+ +

+ + License + + + Version + + + Node + + + Mentioned in Awesome Claude Code + +

+ +

+ + + + + thedotmack/claude-mem | Trendshift + + +

+ +
+ + + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +
+ +

+ Início Rápido • + Como Funciona • + Ferramentas de Pesquisa • + Documentação • + Configuração • + Resolução de Problemas • + Licença +

+ +

+ O Claude-Mem preserva o contexto entre sessões de forma transparente, capturando automaticamente observações de utilização de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isto permite ao Claude manter continuidade de conhecimento sobre projetos mesmo depois de as sessões terminarem ou de haver reconexão. +

+ +--- + +## Início Rápido + +Instale com um único comando: + +```bash +npx claude-mem install +``` + +Ou instale para o OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Ou instale para o Antigravity CLI ([guia de configuração](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Ou instale a partir do marketplace de plugins dentro do Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem +``` + +Reinicie o Claude Code. O contexto de sessões anteriores irá aparecer automaticamente em novas sessões. + +> **Nota:** O Claude-Mem também está publicado no npm, mas `npm install -g claude-mem` instala apenas o **SDK/biblioteca** — não regista os hooks do plugin nem configura o serviço worker. Instale sempre através de `npx claude-mem install` ou dos comandos `/plugin` acima. + +### 🦞 OpenClaw Gateway + +Instale o claude-mem como um plugin de memória persistente em gateways [OpenClaw](https://openclaw.ai) com um único comando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +O instalador trata das dependências, da configuração do plugin, da configuração do fornecedor de IA, do arranque do worker e de feeds opcionais de observação em tempo real para Telegram, Discord, Slack, entre outros. Consulte o [Guia de Integração com o OpenClaw](https://docs.claude-mem.ai/openclaw-integration) para mais detalhes. + +**Principais Funcionalidades:** + +- 🧠 **Memória Persistente** - O contexto sobrevive entre sessões +- 📊 **Divulgação Progressiva** - Recuperação de memória em camadas com visibilidade do custo em tokens +- 🔍 **Pesquisa Baseada em Skill** - Consulte o histórico do seu projeto com a skill mem-search +- 🖥️ **Interface Web Viewer** - Fluxo de memória em tempo real no URL do worker apresentado no arranque +- 💻 **Skill do Claude Desktop** - Pesquise a memória a partir de conversas no Claude Desktop +- 🔒 **Controlo de Privacidade** - Use tags `` para excluir conteúdo sensível do armazenamento +- ⚙️ **Configuração de Contexto** - Controlo detalhado sobre que contexto é injetado +- 🤖 **Funcionamento Automático** - Não é necessária intervenção manual +- 🔗 **Citações** - Referencie observações anteriores com IDs através da API do worker ou visualize todas no web viewer + +--- + +## Documentação + +📚 **[Ver Documentação Completa](https://docs.claude-mem.ai/)** - Navegue no site oficial + +### Introdução + +- **[Guia de Instalação](https://docs.claude-mem.ai/installation)** - Início rápido e instalação avançada +- **[Guia de Utilização](https://docs.claude-mem.ai/usage/getting-started)** - Como o Claude-Mem funciona automaticamente +- **[Ferramentas de Pesquisa](https://docs.claude-mem.ai/usage/search-tools)** - Consulte o histórico do seu projeto com linguagem natural + +### Boas Práticas + +- **[Engenharia de Contexto](https://docs.claude-mem.ai/context-engineering)** - Princípios de otimização de contexto para agentes de IA +- **[Divulgação Progressiva](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofia por trás da estratégia de preparação de contexto do Claude-Mem + +### Arquitetura + +- **[Visão Geral](https://docs.claude-mem.ai/architecture/overview)** - Componentes do sistema e fluxo de dados +- **[Evolução da Arquitetura](https://docs.claude-mem.ai/architecture-evolution)** - A jornada da v3 à v5 +- **[Arquitetura de Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Como o Claude-Mem utiliza hooks de ciclo de vida +- **[Referência de Hooks](https://docs.claude-mem.ai/architecture/hooks)** - Explicação dos 7 scripts de hook +- **[Serviço Worker](https://docs.claude-mem.ai/architecture/worker-service)** - API HTTP e gestão via Bun +- **[Base de Dados](https://docs.claude-mem.ai/architecture/database)** - Esquema SQLite e pesquisa FTS5 +- **[Arquitetura de Pesquisa](https://docs.claude-mem.ai/architecture/search-architecture)** - Pesquisa híbrida com a base de dados vetorial Chroma + +### Configuração e Desenvolvimento + +- **[Configuração](https://docs.claude-mem.ai/configuration)** - Variáveis de ambiente e definições +- **[Desenvolvimento](https://docs.claude-mem.ai/development)** - Compilação, testes e contribuição +- **[Ramos de Lançamento](https://docs.claude-mem.ai/branches)** - Fluxo dos ramos stable, core-dev e community-edge +- **[Resolução de Problemas](https://docs.claude-mem.ai/troubleshooting)** - Problemas comuns e soluções + +--- + +## Como Funciona + +**Componentes Principais:** + +1. **5 Hooks de Ciclo de Vida** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook) +2. **Instalação Inteligente** - Verificador de dependências em cache (script pré-hook, não um hook de ciclo de vida) +3. **Serviço Worker** - API HTTP local com interface web viewer e endpoints de pesquisa, gerida pelo Bun +4. **Base de Dados SQLite** - Armazena sessões, observações e resumos +5. **Skill mem-search** - Consultas em linguagem natural com divulgação progressiva +6. **Base de Dados Vetorial Chroma** - Pesquisa híbrida semântica + por palavras-chave para recuperação inteligente de contexto + +Consulte a [Visão Geral da Arquitetura](https://docs.claude-mem.ai/architecture/overview) para mais detalhes. + +--- + +## Ferramentas de Pesquisa MCP + +O Claude-Mem disponibiliza pesquisa de memória inteligente através de **4 ferramentas MCP**, seguindo um padrão de **fluxo de trabalho em 3 camadas** eficiente em termos de tokens: + +**O Fluxo de Trabalho em 3 Camadas:** + +1. **`search`** - Obtém um índice compacto com IDs (~50-100 tokens/resultado) +2. **`timeline`** - Obtém o contexto cronológico em torno de resultados interessantes +3. **`get_observations`** - Obtém detalhes completos APENAS para os IDs filtrados (~500-1.000 tokens/resultado) + +**Como Funciona:** +- O Claude utiliza ferramentas MCP para pesquisar a sua memória +- Comece com `search` para obter um índice de resultados +- Utilize `timeline` para ver o que estava a acontecer em torno de observações específicas +- Utilize `get_observations` para obter detalhes completos dos IDs relevantes +- **Poupança de cerca de 10x em tokens** ao filtrar antes de obter os detalhes + +**Ferramentas MCP Disponíveis:** + +1. **`search`** - Pesquisa o índice de memória com consultas de texto integral, filtrando por tipo/data/projeto +2. **`timeline`** - Obtém o contexto cronológico em torno de uma observação ou consulta específica +3. **`get_observations`** - Obtém detalhes completos de observações por IDs (agrupe sempre vários IDs) + +**Exemplo de Utilização:** + +```typescript +// Passo 1: Pesquisar índice +search(query="authentication bug", type="bugfix", limit=10) + +// Passo 2: Rever o índice, identificar os IDs relevantes (ex.: #123, #456) + +// Passo 3: Obter detalhes completos +get_observations(ids=[123, 456]) +``` + +Consulte o [Guia de Ferramentas de Pesquisa](https://docs.claude-mem.ai/usage/search-tools) para exemplos detalhados. + +--- + +## Ramos de Lançamento + +Os lançamentos stable partem do ramo `main` e são publicados no npm. Os ramos `core-dev` e +`community-edge` são ramos executados a partir do código-fonte, destinados a correções de fiabilidade antecipadas e +integrações com a comunidade. Consulte **[Ramos de Lançamento](https://docs.claude-mem.ai/branches)** +para o fluxo dos ramos e instruções de execução não-stable. + +--- + +## Requisitos do Sistema + +- **Node.js**: 20.0.0 ou superior +- **Claude Code**: Versão mais recente com suporte para plugins +- **Bun**: Runtime JavaScript e gestor de processos (instalado automaticamente se estiver em falta) +- **uv**: Gestor de pacotes Python para pesquisa vetorial (instalado automaticamente se estiver em falta) +- **SQLite 3**: Para armazenamento persistente (incluído) + +--- +### Notas de Configuração para Windows + +Se vir um erro semelhante a: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Certifique-se de que o Node.js e o npm estão instalados e adicionados ao seu PATH. Descarregue o instalador mais recente do Node.js em https://nodejs.org e reinicie o terminal após a instalação. + +--- + +## Configuração + +As definições são geridas em `~/.claude-mem/settings.json` (criado automaticamente com valores predefinidos na primeira execução). Configure o modelo de IA, a porta do worker, o diretório de dados, o nível de log e as definições de injeção de contexto. + +Consulte o **[Guia de Configuração](https://docs.claude-mem.ai/configuration)** para todas as definições disponíveis e exemplos. + +### Configuração de Modo e Idioma + +O Claude-Mem suporta múltiplos modos de fluxo de trabalho e idiomas através da definição `CLAUDE_MEM_MODE`. + +Esta opção controla tanto: +- O comportamento do fluxo de trabalho (ex.: code, chill, investigation) +- O idioma utilizado nas observações geradas + +#### Como Configurar + +Edite o seu ficheiro de definições em `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Os modos estão definidos em `plugin/modes/`. Para ver todos os modos disponíveis localmente: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Modos Disponíveis + +| Modo | Descrição | +|------------|-------------------------| +| `code` | Modo padrão em inglês | +| `code--zh` | Modo em chinês simplificado | +| `code--ja` | Modo em japonês | + +Os modos específicos de idioma seguem o padrão `code--[lang]`, onde `[lang]` é o código de idioma ISO 639-1 (ex.: `zh` para chinês, `ja` para japonês, `es` para espanhol). + +> Nota: o `code--zh` (chinês simplificado) já está incluído por defeito — não é necessária instalação adicional nem atualização do plugin. + +#### Depois de Alterar o Modo + +Reinicie o Claude Code para aplicar a nova configuração de modo. +--- + +## Desenvolvimento + +Consulte o **[Guia de Desenvolvimento](https://docs.claude-mem.ai/development)** para instruções de compilação, testes e fluxo de contribuição. + +--- + +## Resolução de Problemas + +Se estiver a ter problemas, descreva o problema ao Claude e a skill de resolução de problemas irá diagnosticar automaticamente e fornecer correções. + +Consulte o **[Guia de Resolução de Problemas](https://docs.claude-mem.ai/troubleshooting)** para problemas comuns e soluções. + +--- + +## Relatórios de Erros + +Crie relatórios de erros abrangentes com o gerador automatizado: + +```bash +cd ~/.claude/plugins/marketplaces/thedotmack +npm run bug-report +``` + +## Contribuir + +Contribuições são bem-vindas! Por favor: + +1. Faça fork do repositório +2. Crie um ramo de funcionalidade (feature branch) +3. Faça as suas alterações com testes +4. Atualize a documentação +5. Submeta um Pull Request + +O Claude-Mem é lançado a partir de três ramos: `main` (stable), `core-dev` e +`community-edge`. Apenas o `main` é publicado no npm; os restantes são executados a partir do +código-fonte. Consulte [Ramos de Lançamento](https://docs.claude-mem.ai/branches) para a +estratégia e instruções de execução local. + +Consulte o [Guia de Desenvolvimento](https://docs.claude-mem.ai/development) para o fluxo de contribuição. + +--- + +## Licença + +O Claude-Mem está licenciado sob a Apache License 2.0. + +Escolhemos a Apache-2.0 porque a memória agêntica durável deve ser fácil de incorporar em +ferramentas de programação, agentes locais, servidores MCP, sistemas empresariais, stacks de robótica +e harnesses de agentes em produção. + +Consulte o ficheiro [LICENSE](LICENSE) para todos os detalhes. Consulte [docs/license.md](docs/license.md) +e [docs/ip-boundary.md](docs/ip-boundary.md) para o âmbito de licenciamento e a fronteira +entre o open e o comercial. + +**Nota sobre o Ragtime**: O diretório `ragtime/` está licenciado sob a **Apache License 2.0**. Consulte [ragtime/LICENSE](ragtime/LICENSE) para mais detalhes. + +--- + +## Suporte + +- **Documentação**: [docs/](docs/) +- **Problemas**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) +- **Repositório**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Conta X Oficial**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Oficial**: [Junte-se ao Discord](https://discord.com/invite/J4wttp9vDu) +- **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) + +--- + +**Construído com o Claude Agent SDK** | **Funciona com o Claude Code** | **Feito em TypeScript** + +--- + +### E o CMEM? + +O CMEM é um token criado por terceiros, mas oficialmente adotado pelo criador do Claude-Mem (Alex Newman, @thedotmack). O token funciona como catalisador comunitário para o crescimento e como veículo para levar o CMEM aos programadores e trabalhadores do conhecimento que mais dele precisam. + +CA Oficial na BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 + +--- \ No newline at end of file diff --git a/docs/i18n/README.ro.md b/docs/i18n/README.ro.md index e34619521..3ac8fc46b 100644 --- a/docs/i18n/README.ro.md +++ b/docs/i18n/README.ro.md @@ -1,6 +1,5 @@ 🌐 Aceasta este o traducere automată. Corecțiile din partea comunității sunt binevenite! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Sistem persistent de compresie a memoriei construit pentru Claude Code.

- License + License Version @@ -75,22 +79,49 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

- Start Rapid • - Cum Funcționează • - Instrumente de Căutare • - Documentație • - Configurare • - Depanare • - Licență + Start Rapid • + Cum Funcționează • + Instrumente de Căutare • + Documentație • + Configurare • + Depanare • + Licență

@@ -101,28 +132,57 @@ ## Start Rapid -Porniți o nouă sesiune Claude Code în terminal și introduceți următoarele comenzi: +Instalați cu o singură comandă: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Sau instalați pentru OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Sau instalați pentru Antigravity CLI ([ghid de configurare](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Sau instalați din marketplace-ul de plugin-uri direct din Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat în sesiunile noi. +> **Notă:** Claude-Mem este publicat și pe npm, dar `npm install -g claude-mem` instalează **doar SDK-ul/biblioteca** — nu înregistrează hook-urile plugin-ului și nu configurează serviciul worker. Instalați întotdeauna prin `npx claude-mem install` sau comenzile `/plugin` de mai sus. + +### 🦞 OpenClaw Gateway + +Instalați claude-mem ca plugin de memorie persistentă pe gateway-urile [OpenClaw](https://openclaw.ai) cu o singură comandă: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Programul de instalare gestionează dependențele, configurarea plugin-ului, configurarea furnizorului AI, pornirea worker-ului și fluxurile opționale de observații în timp real către Telegram, Discord, Slack și altele. Consultați [Ghidul de Integrare OpenClaw](https://docs.claude-mem.ai/openclaw-integration) pentru detalii. + **Caracteristici Principale:** - 🧠 **Memorie Persistentă** - Contextul supraviețuiește între sesiuni -- 📊 **Dezvăluire Progresivă** - Recuperare stratificată a memoriei cu vizibilitatea costurilor în tokeni +- 📊 **Dezvăluire Progresivă** - Recuperare stratificată a memoriei cu vizibilitate asupra costurilor în tokeni - 🔍 **Căutare Bazată pe Abilități** - Interogați istoricul proiectului cu abilitatea mem-search -- 🖥️ **Interfață Web Viewer** - Flux de memorie în timp real la http://localhost:37777 +- 🖥️ **Interfață Web Viewer** - Flux de memorie în timp real la adresa URL a worker-ului afișată la pornire - 💻 **Abilitate Claude Desktop** - Căutați în memorie din conversațiile Claude Desktop -- 🔒 **Control al Confidențialității** - Utilizați etichete `` pentru a exclude conținut sensibil de la stocare +- 🔒 **Control al Confidențialității** - Utilizați etichete `` pentru a exclude conținutul sensibil de la stocare - ⚙️ **Configurare Context** - Control fin asupra contextului care este injectat - 🤖 **Operare Automată** - Nu necesită intervenție manuală -- 🔗 **Citări** - Referință la observații anterioare cu ID-uri (accesați prin http://localhost:37777/api/observation/{id} sau vizualizați toate în web viewer la http://localhost:37777) -- 🧪 **Canal Beta** - Încercați funcții experimentale precum Endless Mode prin comutarea versiunii +- 🔗 **Citări** - Referință la observații anterioare cu ID-uri prin API-ul worker-ului sau vizualizați-le pe toate în web viewer --- @@ -135,27 +195,27 @@ Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat î - **[Ghid de Instalare](https://docs.claude-mem.ai/installation)** - Start rapid și instalare avansată - **[Ghid de Utilizare](https://docs.claude-mem.ai/usage/getting-started)** - Cum funcționează Claude-Mem automat - **[Instrumente de Căutare](https://docs.claude-mem.ai/usage/search-tools)** - Interogați istoricul proiectului cu limbaj natural -- **[Funcții Beta](https://docs.claude-mem.ai/beta-features)** - Încercați funcții experimentale precum Endless Mode ### Practici Recomandate -- **[Inginerie Context](https://docs.claude-mem.ai/context-engineering)** - Principii de optimizare a contextului pentru agenți AI +- **[Inginerie de Context](https://docs.claude-mem.ai/context-engineering)** - Principii de optimizare a contextului pentru agenți AI - **[Dezvăluire Progresivă](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofia din spatele strategiei de pregătire a contextului Claude-Mem ### Arhitectură - **[Prezentare Generală](https://docs.claude-mem.ai/architecture/overview)** - Componente de sistem și flux de date - **[Evoluția Arhitecturii](https://docs.claude-mem.ai/architecture-evolution)** - Parcursul de la v3 la v5 -- **[Arhitectura Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Cum folosește Claude-Mem hook-urile de ciclu de viață -- **[Referință Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripturi de hook explicate +- **[Arhitectura Hook-urilor](https://docs.claude-mem.ai/hooks-architecture)** - Cum folosește Claude-Mem hook-urile de ciclu de viață +- **[Referință Hook-uri](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripturi de hook explicate - **[Serviciu Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API și gestionare Bun -- **[Baza de Date](https://docs.claude-mem.ai/architecture/database)** - Schemă SQLite și căutare FTS5 +- **[Bază de Date](https://docs.claude-mem.ai/architecture/database)** - Schemă SQLite și căutare FTS5 - **[Arhitectura Căutării](https://docs.claude-mem.ai/architecture/search-architecture)** - Căutare hibridă cu baza de date vectorială Chroma ### Configurare și Dezvoltare - **[Configurare](https://docs.claude-mem.ai/configuration)** - Variabile de mediu și setări - **[Dezvoltare](https://docs.claude-mem.ai/development)** - Construire, testare, contribuție +- **[Ramuri de Lansare](https://docs.claude-mem.ai/branches)** - Fluxul ramurilor stable, core-dev și community-edge - **[Depanare](https://docs.claude-mem.ai/troubleshooting)** - Probleme comune și soluții --- @@ -166,7 +226,7 @@ Reporniți Claude Code. Contextul din sesiunile anterioare va apărea automat î 1. **5 Hook-uri de Ciclu de Viață** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripturi de hook) 2. **Instalare Inteligentă** - Verificator de dependențe în cache (script pre-hook, nu un hook de ciclu de viață) -3. **Serviciu Worker** - HTTP API pe portul 37777 cu interfață web viewer și 10 endpoint-uri de căutare, gestionat de Bun +3. **Serviciu Worker** - HTTP API local cu interfață web viewer și endpoint-uri de căutare, gestionat de Bun 4. **Bază de Date SQLite** - Stochează sesiuni, observații, rezumate 5. **Abilitatea mem-search** - Interogări în limbaj natural cu dezvăluire progresivă 6. **Bază de Date Vectorială Chroma** - Căutare hibridă semantică + cuvinte cheie pentru recuperare inteligentă a contextului @@ -175,46 +235,51 @@ Consultați [Prezentarea Generală a Arhitecturii](https://docs.claude-mem.ai/ar --- -## Abilitatea mem-search +## Instrumente de Căutare MCP -Claude-Mem oferă căutare inteligentă prin abilitatea mem-search care se invocă automat când întrebați despre lucrul trecut: +Claude-Mem oferă căutare inteligentă în memorie prin **4 instrumente MCP** care urmează un tipar de flux de lucru **eficient din punct de vedere al tokenilor, pe 3 niveluri**: + +**Fluxul de Lucru pe 3 Niveluri:** + +1. **`search`** - Obțineți un index compact cu ID-uri (~50-100 tokeni/rezultat) +2. **`timeline`** - Obțineți context cronologic în jurul rezultatelor interesante +3. **`get_observations`** - Preluați detalii complete DOAR pentru ID-urile filtrate (~500-1.000 tokeni/rezultat) **Cum Funcționează:** -- Întrebați natural: *"Ce am făcut în sesiunea trecută?"* sau *"Am rezolvat acest bug înainte?"* -- Claude invocă automat abilitatea mem-search pentru a găsi contextul relevant +- Claude folosește instrumente MCP pentru a căuta în memoria dumneavoastră +- Începeți cu `search` pentru a obține un index de rezultate +- Folosiți `timeline` pentru a vedea ce se întâmpla în jurul unor observații specifice +- Folosiți `get_observations` pentru a prelua detalii complete pentru ID-urile relevante +- **Economii de aproximativ 10x în tokeni** prin filtrare înainte de preluarea detaliilor -**Operații de Căutare Disponibile:** +**Instrumente MCP Disponibile:** -1. **Search Observations** - Căutare full-text în observații -2. **Search Sessions** - Căutare full-text în rezumatele sesiunilor -3. **Search Prompts** - Căutare în cererile brute ale utilizatorilor -4. **By Concept** - Găsire după etichete de concept (discovery, problem-solution, pattern, etc.) -5. **By File** - Găsire de observații care fac referire la fișiere specifice -6. **By Type** - Găsire după tip (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Obținere context recent al sesiunii pentru un proiect -8. **Timeline** - Obținere cronologie unificată a contextului în jurul unui punct specific în timp -9. **Timeline by Query** - Căutare observații și obținere context cronologic în jurul celei mai bune potriviri -10. **API Help** - Obținere documentație API de căutare +1. **`search`** - Căutați în indexul memoriei cu interogări full-text, filtrare după tip/dată/proiect +2. **`timeline`** - Obțineți context cronologic în jurul unei observații sau interogări specifice +3. **`get_observations`** - Preluați detalii complete ale observațiilor după ID-uri (grupați întotdeauna mai multe ID-uri) -**Exemple de Interogări în Limbaj Natural:** +**Exemplu de Utilizare:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Pasul 1: Căutați pentru index +search(query="authentication bug", type="bugfix", limit=10) + +// Pasul 2: Revizuiți indexul, identificați ID-urile relevante (de ex. #123, #456) + +// Pasul 3: Preluați detaliile complete +get_observations(ids=[123, 456]) ``` Consultați [Ghidul Instrumentelor de Căutare](https://docs.claude-mem.ai/usage/search-tools) pentru exemple detaliate. --- -## Funcții Beta +## Ramuri de Lansare -Claude-Mem oferă un **canal beta** cu funcții experimentale precum **Endless Mode** (arhitectură de memorie biomimetică pentru sesiuni extinse). Comutați între versiunile stabile și beta din interfața web viewer la http://localhost:37777 → Settings. - -Consultați **[Documentația Funcțiilor Beta](https://docs.claude-mem.ai/beta-features)** pentru detalii despre Endless Mode și cum să îl încercați. +Lansările stabile pornesc din `main` și sunt publicate pe npm. `core-dev` și +`community-edge` sunt ramuri rulate direct din sursă pentru remedieri timpurii de fiabilitate și +integrări comunitare. Consultați **[Ramuri de Lansare](https://docs.claude-mem.ai/branches)** +pentru fluxul ramurilor și instrucțiunile de rulare non-stabile. --- @@ -226,33 +291,83 @@ Consultați **[Documentația Funcțiilor Beta](https://docs.claude-mem.ai/beta-f - **uv**: Manager de pachete Python pentru căutare vectorială (instalat automat dacă lipsește) - **SQLite 3**: Pentru stocare persistentă (inclus) +--- +### Note de Configurare pentru Windows + +Dacă vedeți o eroare de tipul: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Asigurați-vă că Node.js și npm sunt instalate și adăugate în PATH. Descărcați cel mai recent program de instalare Node.js de la https://nodejs.org și reporniți terminalul după instalare. + --- ## Configurare -Setările sunt gestionate în `~/.claude-mem/settings.json` (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker, directorul de date, nivelul de log și setările de injectare a contextului. +Setările sunt gestionate în `~/.claude-mem/settings.json` (creat automat cu valori implicite la prima rulare). Configurați modelul AI, portul worker-ului, directorul de date, nivelul de log și setările de injectare a contextului. Consultați **[Ghidul de Configurare](https://docs.claude-mem.ai/configuration)** pentru toate setările disponibile și exemple. +### Configurarea Modului și Limbii + +Claude-Mem suportă mai multe moduri de lucru și limbi prin setarea `CLAUDE_MEM_MODE`. + +Această opțiune controlează: +- Comportamentul fluxului de lucru (de ex. code, chill, investigation) +- Limba folosită în observațiile generate + +#### Cum se Configurează + +Editați fișierul de setări la `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Modurile sunt definite în `plugin/modes/`. Pentru a vedea toate modurile disponibile local: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Moduri Disponibile + +| Mod | Descriere | +|------------|-------------------------| +| `code` | Mod implicit în engleză | +| `code--zh` | Mod în chineză simplificată | +| `code--ja` | Mod în japoneză | + +Modurile specifice limbii urmează tiparul `code--[lang]`, unde `[lang]` este codul de limbă ISO 639-1 (de ex. `zh` pentru chineză, `ja` pentru japoneză, `es` pentru spaniolă). + +> Notă: `code--zh` (chineză simplificată) este deja integrat — nu este necesară nicio instalare suplimentară sau actualizare a plugin-ului. + +#### După Schimbarea Modului + +Reporniți Claude Code pentru a aplica noua configurație a modului. --- ## Dezvoltare -Consultați **[Ghidul de Dezvoltare](https://docs.claude-mem.ai/development)** pentru instrucțiuni de construire, testare și flux de contribuție. +Consultați **[Ghidul de Dezvoltare](https://docs.claude-mem.ai/development)** pentru instrucțiuni de construire, testare și fluxul de contribuție. --- ## Depanare -Dacă întâmpinați probleme, descrieți problema lui Claude și abilitatea troubleshoot va diagnostica automat și va furniza soluții. +Dacă întâmpinați probleme, descrieți problema lui Claude, iar abilitatea troubleshoot va diagnostica automat și va furniza soluții. Consultați **[Ghidul de Depanare](https://docs.claude-mem.ai/troubleshooting)** pentru probleme comune și soluții. --- -## Rapoarte de Bug-uri +## Rapoarte de Erori -Creați rapoarte comprehensive de bug-uri cu generatorul automat: +Creați rapoarte de erori complete cu generatorul automat: ```bash cd ~/.claude/plugins/marketplaces/thedotmack @@ -269,32 +384,48 @@ Contribuțiile sunt binevenite! Vă rugăm: 4. Actualizați documentația 5. Trimiteți un Pull Request +Claude-Mem este lansat din trei ramuri: `main` (stabilă), `core-dev` și +`community-edge`. Doar `main` este publicată pe npm; celelalte sunt rulate din +sursă. Consultați [Ramuri de Lansare](https://docs.claude-mem.ai/branches) pentru +strategie și instrucțiuni de rulare locală. + Consultați [Ghidul de Dezvoltare](https://docs.claude-mem.ai/development) pentru fluxul de contribuție. --- -## License +## Licență -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem este licențiat sub Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Am ales Apache-2.0 pentru că memoria agentică durabilă ar trebui să fie ușor de integrat în +instrumente pentru dezvoltatori, agenți locali, servere MCP, sisteme enterprise, stive de robotică +și medii de rulare agentice de producție. -See the [LICENSE](LICENSE) file for full details. +Consultați fișierul [LICENSE](LICENSE) pentru detalii complete. Consultați [docs/license.md](docs/license.md) +și [docs/ip-boundary.md](docs/ip-boundary.md) pentru domeniul de aplicare al licenței și granița +open-source/comercială. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Notă despre Ragtime**: Directorul `ragtime/` este licențiat sub **Apache License 2.0**. Consultați [ragtime/LICENSE](ragtime/LICENSE) pentru detalii. --- - ## Suport - **Documentație**: [docs/](docs/) - **Probleme**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Cont Oficial X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Oficial**: [Alăturați-vă pe Discord](https://discord.com/invite/J4wttp9vDu) - **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Construit cu Claude Agent SDK** | **Alimentat de Claude Code** | **Realizat cu TypeScript** \ No newline at end of file +**Construit cu Claude Agent SDK** | **Funcționează cu Claude Code** | **Realizat cu TypeScript** + +--- + +### Ce Este cu CMEM? + +CMEM este un token creat de o terță parte, dar îmbrățișat oficial de creatorul Claude-Mem (Alex Newman, @thedotmack). Token-ul acționează ca un catalizator comunitar pentru creștere și ca un vehicul pentru a aduce CMEM la dezvoltatorii și lucrătorii din domeniul cunoașterii care au cea mai mare nevoie de el. + +CA Oficial BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md index 89e10b7d8..e3dfd242c 100644 --- a/docs/i18n/README.ru.md +++ b/docs/i18n/README.ru.md @@ -1,6 +1,5 @@ 🌐 Это автоматический перевод. Приветствуются исправления от сообщества! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Система сжатия постоянной памяти, созданная для Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Быстрый старт • @@ -101,28 +132,57 @@ ## Быстрый старт -Запустите новый сеанс Claude Code в терминале и введите следующие команды: +Установите одной командой: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Или установите для OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Или установите для Antigravity CLI ([руководство по настройке](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Или установите из маркетплейса плагинов внутри Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Перезапустите Claude Code. Контекст из предыдущих сеансов будет автоматически появляться в новых сеансах. +> **Примечание:** Claude-Mem также опубликован на npm, но `npm install -g claude-mem` устанавливает **только SDK/библиотеку** — это не регистрирует хуки плагина и не настраивает сервис worker. Всегда устанавливайте через `npx claude-mem install` или команды `/plugin`, указанные выше. + +### 🦞 OpenClaw Gateway + +Установите claude-mem как плагин постоянной памяти на шлюзах [OpenClaw](https://openclaw.ai) одной командой: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Установщик берёт на себя зависимости, настройку плагина, конфигурацию AI-провайдера, запуск worker и опциональные потоки наблюдений в реальном времени в Telegram, Discord, Slack и другие сервисы. Подробности см. в [Руководстве по интеграции OpenClaw](https://docs.claude-mem.ai/openclaw-integration). + **Ключевые возможности:** - 🧠 **Постоянная память** - Контекст сохраняется между сеансами - 📊 **Прогрессивное раскрытие** - Многоуровневое извлечение памяти с видимостью стоимости токенов - 🔍 **Поиск на основе навыков** - Запросы к истории проекта с помощью навыка mem-search -- 🖥️ **Веб-интерфейс просмотра** - Поток памяти в реальном времени на http://localhost:37777 +- 🖥️ **Веб-интерфейс просмотра** - Поток памяти в реальном времени по URL worker, выводимому при запуске - 💻 **Навык для Claude Desktop** - Поиск в памяти из разговоров Claude Desktop - 🔒 **Контроль конфиденциальности** - Используйте теги `` для исключения конфиденциального контента из хранилища - ⚙️ **Настройка контекста** - Детальный контроль того, какой контекст внедряется - 🤖 **Автоматическая работа** - Не требуется ручное вмешательство -- 🔗 **Цитирование** - Ссылки на прошлые наблюдения с помощью ID (доступ через http://localhost:37777/api/observation/{id} или просмотр всех в веб-интерфейсе на http://localhost:37777) -- 🧪 **Бета-канал** - Попробуйте экспериментальные функции, такие как режим Endless, переключая версии +- 🔗 **Цитирование** - Ссылки на прошлые наблюдения по ID через API worker или просмотр всех в веб-интерфейсе --- @@ -135,7 +195,6 @@ - **[Руководство по установке](https://docs.claude-mem.ai/installation)** - Быстрый старт и продвинутая установка - **[Руководство по использованию](https://docs.claude-mem.ai/usage/getting-started)** - Как Claude-Mem работает автоматически - **[Инструменты поиска](https://docs.claude-mem.ai/usage/search-tools)** - Запросы к истории проекта на естественном языке -- **[Бета-функции](https://docs.claude-mem.ai/beta-features)** - Попробуйте экспериментальные функции, такие как режим Endless ### Лучшие практики @@ -156,6 +215,7 @@ - **[Конфигурация](https://docs.claude-mem.ai/configuration)** - Переменные окружения и настройки - **[Разработка](https://docs.claude-mem.ai/development)** - Сборка, тестирование, участие в разработке +- **[Ветки релизов](https://docs.claude-mem.ai/branches)** - Поток веток stable, core-dev и community-edge - **[Устранение неполадок](https://docs.claude-mem.ai/troubleshooting)** - Распространенные проблемы и решения --- @@ -166,7 +226,7 @@ 1. **5 хуков жизненного цикла** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 скриптов хуков) 2. **Умная установка** - Проверка кешированных зависимостей (скрипт предварительного хука, не является хуком жизненного цикла) -3. **Сервис Worker** - HTTP API на порту 37777 с веб-интерфейсом просмотра и 10 конечными точками поиска, управляемый Bun +3. **Сервис Worker** - Локальный HTTP API с веб-интерфейсом просмотра и конечными точками поиска, управляемый Bun 4. **База данных SQLite** - Хранит сеансы, наблюдения, сводки 5. **Навык mem-search** - Запросы на естественном языке с прогрессивным раскрытием 6. **Векторная база данных Chroma** - Гибридный семантический + ключевой поиск для интеллектуального извлечения контекста @@ -175,46 +235,51 @@ --- -## Навык mem-search +## Инструменты поиска MCP -Claude-Mem предоставляет интеллектуальный поиск через навык mem-search, который автоматически вызывается, когда вы спрашиваете о прошлой работе: +Claude-Mem предоставляет интеллектуальный поиск памяти через **4 инструмента MCP**, следуя экономичному по токенам паттерну **3-уровневого рабочего процесса**: + +**3-уровневый рабочий процесс:** + +1. **`search`** - Получить компактный индекс с ID (~50-100 токенов/результат) +2. **`timeline`** - Получить хронологический контекст вокруг интересующих результатов +3. **`get_observations`** - Получить полные детали ТОЛЬКО для отфильтрованных ID (~500-1000 токенов/результат) **Как это работает:** -- Просто спросите естественно: *"Что мы делали в прошлом сеансе?"* или *"Мы исправляли этот баг раньше?"* -- Claude автоматически вызывает навык mem-search для поиска релевантного контекста +- Claude использует инструменты MCP для поиска в вашей памяти +- Начните с `search`, чтобы получить индекс результатов +- Используйте `timeline`, чтобы увидеть, что происходило вокруг конкретных наблюдений +- Используйте `get_observations`, чтобы получить полные детали для релевантных ID +- **Экономия токенов примерно в 10 раз** благодаря фильтрации перед получением деталей -**Доступные операции поиска:** +**Доступные инструменты MCP:** -1. **Поиск наблюдений** - Полнотекстовый поиск по наблюдениям -2. **Поиск сеансов** - Полнотекстовый поиск по сводкам сеансов -3. **Поиск запросов** - Поиск исходных пользовательских запросов -4. **По концепции** - Поиск по тегам концепций (discovery, problem-solution, pattern и т.д.) -5. **По файлу** - Поиск наблюдений, ссылающихся на конкретные файлы -6. **По типу** - Поиск по типу (decision, bugfix, feature, refactor, discovery, change) -7. **Недавний контекст** - Получение недавнего контекста сеанса для проекта -8. **Хронология** - Получение единой хронологии контекста вокруг определенного момента времени -9. **Хронология по запросу** - Поиск наблюдений и получение контекста хронологии вокруг наилучшего совпадения -10. **Справка по API** - Получение документации по API поиска +1. **`search`** - Поиск по индексу памяти с полнотекстовыми запросами, фильтрация по типу/дате/проекту +2. **`timeline`** - Получение хронологического контекста вокруг конкретного наблюдения или запроса +3. **`get_observations`** - Получение полных деталей наблюдений по ID (всегда группируйте несколько ID в один запрос) -**Примеры запросов на естественном языке:** +**Пример использования:** -``` -"Какие баги мы исправили в прошлом сеансе?" -"Как мы реализовали аутентификацию?" -"Какие изменения были внесены в worker-service.ts?" -"Покажи недавнюю работу над этим проектом" -"Что происходило, когда мы добавляли интерфейс просмотра?" +```typescript +// Шаг 1: Поиск по индексу +search(query="authentication bug", type="bugfix", limit=10) + +// Шаг 2: Просмотрите индекс, определите релевантные ID (например, #123, #456) + +// Шаг 3: Получите полные детали +get_observations(ids=[123, 456]) ``` Подробные примеры см. в [Руководстве по инструментам поиска](https://docs.claude-mem.ai/usage/search-tools). --- -## Бета-функции +## Ветки релизов -Claude-Mem предлагает **бета-канал** с экспериментальными функциями, такими как **режим Endless** (биомиметическая архитектура памяти для расширенных сеансов). Переключайтесь между стабильной и бета-версиями из веб-интерфейса на http://localhost:37777 → Settings. - -Подробности о режиме Endless и способах его опробовать см. в **[Документации по бета-функциям](https://docs.claude-mem.ai/beta-features)**. +Стабильные релизы выпускаются из `main` и публикуются в npm. `core-dev` и +`community-edge` — это ветки, запускаемые из исходного кода, для ранних исправлений +надежности и интеграций сообщества. См. **[Ветки релизов](https://docs.claude-mem.ai/branches)** +для описания потока веток и инструкций по запуску нестабильных версий. --- @@ -226,6 +291,17 @@ Claude-Mem предлагает **бета-канал** с эксперимен - **uv**: Менеджер пакетов Python для векторного поиска (автоматически устанавливается при отсутствии) - **SQLite 3**: Для постоянного хранения (встроенный) +--- +### Примечания по настройке для Windows + +Если вы видите ошибку вида: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Убедитесь, что Node.js и npm установлены и добавлены в ваш PATH. Загрузите последнюю версию установщика Node.js с https://nodejs.org и перезапустите терминал после установки. + --- ## Конфигурация @@ -234,6 +310,45 @@ Claude-Mem предлагает **бета-канал** с эксперимен Все доступные настройки и примеры см. в **[Руководстве по конфигурации](https://docs.claude-mem.ai/configuration)**. +### Настройка режима и языка + +Claude-Mem поддерживает несколько режимов рабочего процесса и языков через настройку `CLAUDE_MEM_MODE`. + +Эта опция управляет одновременно: +- Поведением рабочего процесса (например, code, chill, investigation) +- Языком, используемым в сгенерированных наблюдениях + +#### Как настроить + +Отредактируйте файл настроек по адресу `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Режимы определены в `plugin/modes/`. Чтобы увидеть все доступные режимы локально: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Доступные режимы + +| Режим | Описание | +|------------|-------------------------| +| `code` | Стандартный английский режим | +| `code--zh` | Режим упрощенного китайского | +| `code--ja` | Японский режим | + +Языковые режимы следуют шаблону `code--[lang]`, где `[lang]` — это код языка ISO 639-1 (например, `zh` для китайского, `ja` для японского, `es` для испанского). + +> Примечание: `code--zh` (упрощенный китайский) уже встроен — дополнительная установка или обновление плагина не требуются. + +#### После изменения режима + +Перезапустите Claude Code, чтобы применить новую конфигурацию режима. --- ## Разработка @@ -269,32 +384,48 @@ npm run bug-report 4. Обновите документацию 5. Отправьте Pull Request +Claude-Mem выпускается из трёх веток: `main` (стабильная), `core-dev` и +`community-edge`. Только `main` публикуется в npm; остальные запускаются из +исходного кода. См. [Ветки релизов](https://docs.claude-mem.ai/branches) для +описания стратегии и инструкций по локальному запуску. + Процесс участия см. в [Руководстве по разработке](https://docs.claude-mem.ai/development). --- -## License +## Лицензия -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem распространяется под лицензией Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Мы выбрали Apache-2.0, потому что устойчивая агентная память должна легко встраиваться +в инструменты разработчиков, локальных агентов, серверы MCP, корпоративные системы, робототехнические +стеки и производственные среды исполнения агентов. -See the [LICENSE](LICENSE) file for full details. +Полные детали см. в файле [LICENSE](LICENSE). См. также [docs/license.md](docs/license.md) +и [docs/ip-boundary.md](docs/ip-boundary.md) для описания области действия лицензии и +границы между открытым и коммерческим использованием. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Примечание о Ragtime**: Директория `ragtime/` лицензирована под **Apache License 2.0**. Подробности см. в [ragtime/LICENSE](ragtime/LICENSE). --- - ## Поддержка - **Документация**: [docs/](docs/) - **Проблемы**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Репозиторий**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Официальный аккаунт X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Официальный Discord**: [Присоединиться к Discord](https://discord.com/invite/J4wttp9vDu) - **Автор**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Создано с помощью Claude Agent SDK** | **Работает на Claude Code** | **Сделано на TypeScript** \ No newline at end of file +**Создано с помощью Claude Agent SDK** | **Работает на Claude Code** | **Сделано на TypeScript** + +--- + +### А что насчёт CMEM? + +CMEM — это токен, созданный третьей стороной, но официально признанный создателем Claude-Mem (Alex Newman, @thedotmack). Токен выступает в роли катализатора роста сообщества и средства для доставки CMEM разработчикам и специалистам умственного труда, которым он нужен больше всего. + +Официальный BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.sv.md b/docs/i18n/README.sv.md index 3d88b4ca7..9d2591922 100644 --- a/docs/i18n/README.sv.md +++ b/docs/i18n/README.sv.md @@ -1,6 +1,5 @@ 🌐 Detta är en automatiserad översättning. Bidrag från gemenskapen är välkomna! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

Persistent minneskomprimeringsystem byggt för Claude Code.

+

Persistent minneskomprimeringssystem byggt för Claude Code.

- License + License Version @@ -75,18 +79,45 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Snabbstart • Hur det fungerar • - Sökverktyg • + Sökverktyg • Dokumentation • Konfiguration • Felsökning • @@ -101,28 +132,57 @@ ## Snabbstart -Starta en ny Claude Code-session i terminalen och ange följande kommandon: +Installera med ett enda kommando: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Eller installera för OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Eller installera för Antigravity CLI ([installationsguide](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Eller installera från plugin-marknadsplatsen inuti Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Starta om Claude Code. Kontext från tidigare sessioner kommer automatiskt att visas i nya sessioner. +> **Obs:** Claude-Mem publiceras även på npm, men `npm install -g claude-mem` installerar **endast SDK:t/biblioteket** — det registrerar inte plugin-krokarna och konfigurerar inte worker-tjänsten. Installera alltid via `npx claude-mem install` eller `/plugin`-kommandona ovan. + +### 🦞 OpenClaw Gateway + +Installera claude-mem som en persistent minnesplugin på [OpenClaw](https://openclaw.ai)-gateways med ett enda kommando: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Installationsprogrammet hanterar beroenden, plugin-konfiguration, konfiguration av AI-leverantör, uppstart av worker samt valfria realtidsobservationsflöden till Telegram, Discord, Slack med flera. Se [OpenClaw-integrationsguiden](https://docs.claude-mem.ai/openclaw-integration) för mer information. + **Nyckelfunktioner:** - 🧠 **Persistent minne** - Kontext överlever mellan sessioner - 📊 **Progressiv visning** - Skiktad minneshämtning med synlighet för tokenkostnad -- 🔍 **Färdighetsbaserad sökning** - Sök i din projekthistorik med mem-search-färdigheten -- 🖥️ **Webbvy-gränssnitt** - Realtidsminnesström på http://localhost:37777 +- 🔍 **Färdighetsbaserad sökning** - Fråga i din projekthistorik med mem-search-färdigheten +- 🖥️ **Webbvy-gränssnitt** - Realtidsminnesström på worker-URL:en som skrivs ut vid start - 💻 **Claude Desktop-färdighet** - Sök i minnet från Claude Desktop-konversationer - 🔒 **Integritetskontroll** - Använd ``-taggar för att exkludera känsligt innehåll från lagring - ⚙️ **Kontextkonfiguration** - Detaljerad kontroll över vilken kontext som injiceras - 🤖 **Automatisk drift** - Ingen manuell hantering krävs -- 🔗 **Citeringar** - Referera till tidigare observationer med ID:n (tillgängliga via http://localhost:37777/api/observation/{id} eller visa alla i webbvyn på http://localhost:37777) -- 🧪 **Betakanal** - Testa experimentella funktioner som Endless Mode via versionsväxling +- 🔗 **Citeringar** - Referera till tidigare observationer med ID:n via worker-API:et eller visa alla i webbvyn --- @@ -135,11 +195,10 @@ Starta om Claude Code. Kontext från tidigare sessioner kommer automatiskt att v - **[Installationsguide](https://docs.claude-mem.ai/installation)** - Snabbstart och avancerad installation - **[Användarguide](https://docs.claude-mem.ai/usage/getting-started)** - Hur Claude-Mem fungerar automatiskt - **[Sökverktyg](https://docs.claude-mem.ai/usage/search-tools)** - Sök i din projekthistorik med naturligt språk -- **[Betafunktioner](https://docs.claude-mem.ai/beta-features)** - Testa experimentella funktioner som Endless Mode ### Bästa praxis -- **[Context Engineering](https://docs.claude-mem.ai/context-engineering)** - Optimeringsmetoder för AI-agentkontext +- **[Context Engineering](https://docs.claude-mem.ai/context-engineering)** - Optimeringsprinciper för AI-agentkontext - **[Progressiv visning](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofin bakom Claude-Mems kontextpriming-strategi ### Arkitektur @@ -156,6 +215,7 @@ Starta om Claude Code. Kontext från tidigare sessioner kommer automatiskt att v - **[Konfiguration](https://docs.claude-mem.ai/configuration)** - Miljövariabler och inställningar - **[Utveckling](https://docs.claude-mem.ai/development)** - Bygga, testa, bidra +- **[Release-grenar](https://docs.claude-mem.ai/branches)** - Flödet mellan stable-, core-dev- och community-edge-grenarna - **[Felsökning](https://docs.claude-mem.ai/troubleshooting)** - Vanliga problem och lösningar --- @@ -166,7 +226,7 @@ Starta om Claude Code. Kontext från tidigare sessioner kommer automatiskt att v 1. **5 livscykelkrokar** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-skript) 2. **Smart installation** - Cachad beroendekontrollant (pre-hook-skript, inte en livscykelkrok) -3. **Worker Service** - HTTP API på port 37777 med webbvy-gränssnitt och 10 sökändpunkter, hanterat av Bun +3. **Worker Service** - Lokalt HTTP API med webbvy-gränssnitt och sökändpunkter, hanterat av Bun 4. **SQLite-databas** - Lagrar sessioner, observationer, sammanfattningar 5. **mem-search-färdighet** - Naturligspråkssökningar med progressiv visning 6. **Chroma-vektordatabas** - Hybrid semantisk + nyckelordssökning för intelligent kontexthämtning @@ -175,46 +235,51 @@ Se [Arkitekturöversikt](https://docs.claude-mem.ai/architecture/overview) för --- -## mem-search-färdighet +## MCP-sökverktyg -Claude-Mem tillhandahåller intelligent sökning genom mem-search-färdigheten som automatiskt aktiveras när du frågar om tidigare arbete: +Claude-Mem tillhandahåller intelligent minnessökning genom **4 MCP-verktyg** som följer ett tokeneffektivt **3-lagers arbetsflödesmönster**: -**Hur det fungerar:** -- Fråga bara naturligt: *"Vad gjorde vi förra sessionen?"* eller *"Fixade vi den här buggen tidigare?"* -- Claude aktiverar automatiskt mem-search-färdigheten för att hitta relevant kontext +**Arbetsflödet med 3 lager:** -**Tillgängliga sökoperationer:** +1. **`search`** - Hämta ett kompakt index med ID:n (~50–100 tokens/resultat) +2. **`timeline`** - Hämta kronologisk kontext kring intressanta resultat +3. **`get_observations`** - Hämta fullständiga detaljer ENDAST för filtrerade ID:n (~500–1 000 tokens/resultat) -1. **Search Observations** - Fulltextsökning över observationer -2. **Search Sessions** - Fulltextsökning över sessionssammanfattningar -3. **Search Prompts** - Sök i råa användarförfrågningar -4. **By Concept** - Hitta efter koncepttaggar (discovery, problem-solution, pattern, etc.) -5. **By File** - Hitta observationer som refererar till specifika filer -6. **By Type** - Hitta efter typ (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Hämta senaste sessionskontext för ett projekt -8. **Timeline** - Få en enhetlig tidslinje av kontext kring en specifik tidpunkt -9. **Timeline by Query** - Sök efter observationer och få tidslinjekontext kring bästa matchning -10. **API Help** - Få API-dokumentation för sökning +**Så här fungerar det:** +- Claude använder MCP-verktyg för att söka i ditt minne +- Börja med `search` för att få ett index över resultat +- Använd `timeline` för att se vad som hände kring specifika observationer +- Använd `get_observations` för att hämta fullständiga detaljer för relevanta ID:n +- **~10x tokenbesparing** genom att filtrera innan detaljer hämtas -**Exempel på naturligspråkssökningar:** +**Tillgängliga MCP-verktyg:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +1. **`search`** - Sök i minnesindexet med fritextfrågor, filtrera efter typ/datum/projekt +2. **`timeline`** - Hämta kronologisk kontext kring en specifik observation eller fråga +3. **`get_observations`** - Hämta fullständiga observationsdetaljer efter ID:n (batcha alltid flera ID:n) + +**Exempel på användning:** + +```typescript +// Steg 1: Sök efter index +search(query="authentication bug", type="bugfix", limit=10) + +// Steg 2: Granska indexet, identifiera relevanta ID:n (t.ex. #123, #456) + +// Steg 3: Hämta fullständiga detaljer +get_observations(ids=[123, 456]) ``` Se [Sökverktygsguide](https://docs.claude-mem.ai/usage/search-tools) för detaljerade exempel. --- -## Betafunktioner +## Release-grenar -Claude-Mem erbjuder en **betakanal** med experimentella funktioner som **Endless Mode** (biomimetisk minnesarkitektur för utökade sessioner). Växla mellan stabila och betaversioner från webbvy-gränssnittet på http://localhost:37777 → Settings. - -Se **[Dokumentation för betafunktioner](https://docs.claude-mem.ai/beta-features)** för detaljer om Endless Mode och hur du testar det. +Stabila utgåvor levereras från `main` och publiceras till npm. `core-dev` och +`community-edge` är källkörda grenar för tidiga tillförlitlighetsfixar och +community-integrationer. Se **[Release-grenar](https://docs.claude-mem.ai/branches)** +för grenflödet och instruktioner för att köra icke-stabila versioner. --- @@ -226,14 +291,64 @@ Se **[Dokumentation för betafunktioner](https://docs.claude-mem.ai/beta-feature - **uv**: Python-pakethanterare för vektorsökning (installeras automatiskt om den saknas) - **SQLite 3**: För persistent lagring (ingår) +--- +### Anteckningar för installation på Windows + +Om du ser ett fel som: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Se till att Node.js och npm är installerade och tillagda i din PATH. Ladda ner den senaste Node.js-installationsfilen från https://nodejs.org och starta om terminalen efter installationen. + --- ## Konfiguration -Inställningar hanteras i `~/.claude-mem/settings.json` (skapas automatiskt med standardvärden vid första körning). Konfigurera AI-modell, worker-port, datakatalog, loggnivå och kontextinjektionsinställningar. +Inställningar hanteras i `~/.claude-mem/settings.json` (skapas automatiskt med standardvärden vid första körning). Konfigurera AI-modell, worker-port, datakatalog, loggnivå och inställningar för kontextinjektion. Se **[Konfigurationsguide](https://docs.claude-mem.ai/configuration)** för alla tillgängliga inställningar och exempel. +### Konfiguration av läge och språk + +Claude-Mem stöder flera arbetsflödeslägen och språk via inställningen `CLAUDE_MEM_MODE`. + +Detta alternativ styr både: +- Arbetsflödesbeteendet (t.ex. code, chill, investigation) +- Språket som används i genererade observationer + +#### Så konfigurerar du det + +Redigera din inställningsfil på `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Lägen definieras i `plugin/modes/`. För att se alla tillgängliga lägen lokalt: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Tillgängliga lägen + +| Läge | Beskrivning | +|------------|-------------------------| +| `code` | Standardläge på engelska | +| `code--zh` | Läge för förenklad kinesiska | +| `code--ja` | Läge för japanska | + +Språkspecifika lägen följer mönstret `code--[lang]` där `[lang]` är ISO 639-1-språkkoden (t.ex. `zh` för kinesiska, `ja` för japanska, `es` för spanska). + +> Obs: `code--zh` (förenklad kinesiska) ingår redan inbyggt — ingen ytterligare installation eller plugin-uppdatering krävs. + +#### Efter att du bytt läge + +Starta om Claude Code för att tillämpa den nya lägeskonfigurationen. --- ## Utveckling @@ -244,7 +359,7 @@ Se **[Utvecklingsguide](https://docs.claude-mem.ai/development)** för bygginstr ## Felsökning -Om du upplever problem, beskriv problemet för Claude och felsökningsfärdigheten kommer automatiskt att diagnostisera och tillhandahålla lösningar. +Om du upplever problem, beskriv problemet för Claude så kommer felsökningsfärdigheten automatiskt att diagnostisera och tillhandahålla lösningar. Se **[Felsökningsguide](https://docs.claude-mem.ai/troubleshooting)** för vanliga problem och lösningar. @@ -269,32 +384,48 @@ Bidrag är välkomna! Vänligen: 4. Uppdatera dokumentationen 5. Skicka in en Pull Request +Claude-Mem levereras från tre grenar: `main` (stabil), `core-dev` och +`community-edge`. Endast `main` publiceras till npm; de andra körs från +källkod. Se [Release-grenar](https://docs.claude-mem.ai/branches) för +strategin och instruktioner för lokal körning. + Se [Utvecklingsguide](https://docs.claude-mem.ai/development) för bidragsarbetsflöde. --- -## License +## Licens -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem är licensierat under Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Vi valde Apache-2.0 eftersom hållbart agentiskt minne bör vara enkelt att bädda in i +utvecklarverktyg, lokala agenter, MCP-servrar, företagssystem, robotikstackar +och produktionsagenter. -See the [LICENSE](LICENSE) file for full details. +Se filen [LICENSE](LICENSE) för fullständiga detaljer. Se [docs/license.md](docs/license.md) +och [docs/ip-boundary.md](docs/ip-boundary.md) för licensomfattning och gränsen +mellan öppen och kommersiell användning. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Anmärkning om Ragtime**: Katalogen `ragtime/` är licensierad under **Apache License 2.0**. Se [ragtime/LICENSE](ragtime/LICENSE) för detaljer. --- - ## Support - **Dokumentation**: [docs/](docs/) - **Problem**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Officiellt X-konto**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Officiell Discord**: [Gå med i Discord](https://discord.com/invite/J4wttp9vDu) - **Författare**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Byggd med Claude Agent SDK** | **Drivs av Claude Code** | **Skapad med TypeScript** \ No newline at end of file +**Byggd med Claude Agent SDK** | **Fungerar med Claude Code** | **Skapad med TypeScript** + +--- + +### Vad är CMEM? + +CMEM är en token skapad av tredje part men officiellt omfamnad av Claude-Mems skapare (Alex Newman, @thedotmack). Token fungerar som en katalysator för tillväxt inom gemenskapen och ett sätt att föra CMEM till de utvecklare och kunskapsarbetare som behöver det mest. + +Officiell BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.th.md b/docs/i18n/README.th.md index 5c3468c06..792d8da6b 100644 --- a/docs/i18n/README.th.md +++ b/docs/i18n/README.th.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

ระบบการบีบอัดหน่วยความจำถาวรที่สร้างขึ้นสำหรับ Claude Code

- License + License Version @@ -74,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

เริ่มต้นอย่างรวดเร็ว • @@ -93,35 +125,64 @@

- Claude-Mem รักษาบริบทข้ามเซสชันได้อย่างราบรื่นโดยการบันทึกผลการสังเกตจากการใช้เครื่องมือโดยอัตโนมัติ สร้างสรุปความหมาย และทำให้พร้อมใช้งานสำหรับเซสชันในอนาคต ทำให้ Claude สามารถรักษาความต่อเนื่องของความรู้เกี่ยวกับโปรเจกต์แม้หลังจากเซสชันสิ้นสุดหรือเชื่อมต่อใหม่ + Claude-Mem รักษาบริบทข้ามเซสชันได้อย่างราบรื่นโดยการบันทึกผลการสังเกตจากการใช้เครื่องมือโดยอัตโนมัติ สร้างสรุปความหมาย และทำให้พร้อมใช้งานสำหรับเซสชันในอนาคต สิ่งนี้ช่วยให้ Claude สามารถรักษาความต่อเนื่องของความรู้เกี่ยวกับโปรเจกต์ได้แม้หลังจากเซสชันสิ้นสุดหรือเชื่อมต่อใหม่

--- ## เริ่มต้นอย่างรวดเร็ว -เริ่มเซสชัน Claude Code ใหม่ในเทอร์มินัลและป้อนคำสั่งต่อไปนี้: +ติดตั้งด้วยคำสั่งเดียว: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +หรือติดตั้งสำหรับ OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +หรือติดตั้งสำหรับ Antigravity CLI ([คู่มือการตั้งค่า](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +หรือติดตั้งจาก plugin marketplace ภายใน Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` รีสตาร์ท Claude Code บริบทจากเซสชันก่อนหน้าจะปรากฏในเซสชันใหม่โดยอัตโนมัติ +> **หมายเหตุ:** Claude-Mem ยังถูกเผยแพร่บน npm ด้วย แต่ `npm install -g claude-mem` จะติดตั้งเฉพาะ **SDK/library เท่านั้น** — จะไม่ลงทะเบียน plugin hooks หรือตั้งค่า worker service ให้ ควรติดตั้งผ่าน `npx claude-mem install` หรือคำสั่ง `/plugin` ด้านบนเสมอ + +### 🦞 OpenClaw Gateway + +ติดตั้ง claude-mem เป็นปลั๊กอินหน่วยความจำถาวรบนเกตเวย์ [OpenClaw](https://openclaw.ai) ด้วยคำสั่งเดียว: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +ตัวติดตั้งจะจัดการ dependencies การตั้งค่าปลั๊กอิน การกำหนดค่า AI provider การเริ่มต้น worker และฟีดการสังเกตแบบเรียลไทม์ที่เป็นทางเลือกไปยัง Telegram, Discord, Slack และอื่นๆ ดู [คู่มือการผสานรวม OpenClaw](https://docs.claude-mem.ai/openclaw-integration) สำหรับรายละเอียด + **คุณสมบัติหลัก:** - 🧠 **หน่วยความจำถาวร** - บริบทยังคงอยู่ข้ามเซสชัน - 📊 **การเปิดเผยแบบก้าวหน้า** - การดึงหน่วยความจำแบบชั้นพร้อมการแสดงต้นทุนโทเค็น - 🔍 **การค้นหาตามทักษะ** - สืบค้นประวัติโปรเจกต์ของคุณด้วยทักษะ mem-search -- 🖥️ **Web Viewer UI** - สตรีมหน่วยความจำแบบเรียลไทม์ที่ http://localhost:37777 +- 🖥️ **Web Viewer UI** - สตรีมหน่วยความจำแบบเรียลไทม์ที่ URL ของ worker ซึ่งพิมพ์ออกมาตอนเริ่มต้น - 💻 **Claude Desktop Skill** - ค้นหาหน่วยความจำจากการสนทนา Claude Desktop - 🔒 **การควบคุมความเป็นส่วนตัว** - ใช้แท็ก `` เพื่อยกเว้นเนื้อหาที่ละเอียดอ่อนจากการจัดเก็บ - ⚙️ **การกำหนดค่าบริบท** - ควบคุมบริบทที่ถูกฉีดเข้ามาได้อย่างละเอียด - 🤖 **การทำงานอัตโนมัติ** - ไม่ต้องแทรกแซงด้วยตนเอง -- 🔗 **การอ้างอิง** - อ้างอิงการสังเกตในอดีตด้วย ID (เข้าถึงผ่าน http://localhost:37777/api/observation/{id} หรือดูทั้งหมดใน web viewer ที่ http://localhost:37777) -- 🧪 **Beta Channel** - ลองคุณสมบัติทดลองเช่น Endless Mode ผ่านการสลับเวอร์ชัน +- 🔗 **การอ้างอิง** - อ้างอิงการสังเกตในอดีตด้วย ID ผ่าน worker API หรือดูทั้งหมดใน web viewer --- @@ -134,7 +195,6 @@ - **[คู่มือการติดตั้ง](https://docs.claude-mem.ai/installation)** - เริ่มต้นอย่างรวดเร็วและการติดตั้งขั้นสูง - **[คู่มือการใช้งาน](https://docs.claude-mem.ai/usage/getting-started)** - วิธีที่ Claude-Mem ทำงานโดยอัตโนมัติ - **[เครื่องมือค้นหา](https://docs.claude-mem.ai/usage/search-tools)** - สืบค้นประวัติโปรเจกต์ของคุณด้วยภาษาธรรมชาติ -- **[คุณสมบัติ Beta](https://docs.claude-mem.ai/beta-features)** - ลองคุณสมบัติทดลองเช่น Endless Mode ### แนวปฏิบัติที่ดี @@ -155,6 +215,7 @@ - **[การกำหนดค่า](https://docs.claude-mem.ai/configuration)** - ตัวแปรสภาพแวดล้อมและการตั้งค่า - **[การพัฒนา](https://docs.claude-mem.ai/development)** - การสร้าง การทดสอบ การมีส่วนร่วม +- **[Release Branches](https://docs.claude-mem.ai/branches)** - ลำดับการไหลของ branch แบบ stable, core-dev และ community-edge - **[การแก้ไขปัญหา](https://docs.claude-mem.ai/troubleshooting)** - ปัญหาและการแก้ไขทั่วไป --- @@ -165,7 +226,7 @@ 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - ตัวตรวจสอบการพึ่งพาที่ถูกแคช (pre-hook script, ไม่ใช่ lifecycle hook) -3. **Worker Service** - HTTP API บนพอร์ต 37777 พร้อม web viewer UI และ 10 search endpoints, จัดการโดย Bun +3. **Worker Service** - HTTP API ในเครื่องพร้อม web viewer UI และ search endpoints จัดการโดย Bun 4. **SQLite Database** - จัดเก็บเซสชัน การสังเกต สรุป 5. **mem-search Skill** - คิวรีภาษาธรรมชาติพร้อมการเปิดเผยแบบก้าวหน้า 6. **Chroma Vector Database** - การค้นหาแบบไฮบริดทางความหมาย + คีย์เวิร์ดสำหรับการดึงบริบทอัจฉริยะ @@ -174,46 +235,51 @@ --- -## ทักษะ mem-search +## MCP Search Tools -Claude-Mem ให้บริการการค้นหาอัจฉริยะผ่านทักษะ mem-search ที่เรียกใช้อัตโนมัติเมื่อคุณถามเกี่ยวกับงานที่ผ่านมา: +Claude-Mem มอบการค้นหาหน่วยความจำอัจฉริยะผ่าน **MCP tools 4 ตัว** โดยใช้รูปแบบ **workflow 3 ชั้นที่ประหยัดโทเค็น**: + +**Workflow 3 ชั้น:** + +1. **`search`** - รับดัชนีแบบกระชับพร้อม ID (~50-100 โทเค็น/ผลลัพธ์) +2. **`timeline`** - รับบริบทตามลำดับเวลารอบผลลัพธ์ที่น่าสนใจ +3. **`get_observations`** - ดึงรายละเอียดฉบับเต็มเฉพาะสำหรับ ID ที่กรองแล้ว (~500-1,000 โทเค็น/ผลลัพธ์) **วิธีการทำงาน:** -- เพียงถามตามธรรมชาติ: *"เราทำอะไรในเซสชันที่แล้ว?"* หรือ *"เราแก้บั๊กนี้ไปแล้วหรือยัง?"* -- Claude เรียกใช้ทักษะ mem-search โดยอัตโนมัติเพื่อค้นหาบริบทที่เกี่ยวข้อง +- Claude ใช้ MCP tools ในการค้นหาหน่วยความจำของคุณ +- เริ่มด้วย `search` เพื่อรับดัชนีของผลลัพธ์ +- ใช้ `timeline` เพื่อดูว่าเกิดอะไรขึ้นรอบๆ การสังเกตเฉพาะ +- ใช้ `get_observations` เพื่อดึงรายละเอียดฉบับเต็มสำหรับ ID ที่เกี่ยวข้อง +- **ประหยัดโทเค็นได้ประมาณ 10 เท่า** โดยการกรองก่อนที่จะดึงรายละเอียด -**การดำเนินการค้นหาที่มี:** +**MCP Tools ที่มีให้ใช้งาน:** -1. **Search Observations** - การค้นหาข้อความเต็มข้ามการสังเกต -2. **Search Sessions** - การค้นหาข้อความเต็มข้ามสรุปเซสชัน -3. **Search Prompts** - ค้นหาคำขอผู้ใช้แบบดิบ -4. **By Concept** - ค้นหาตามแท็กแนวคิด (discovery, problem-solution, pattern, ฯลฯ) -5. **By File** - ค้นหาการสังเกตที่อ้างอิงไฟล์เฉพาะ -6. **By Type** - ค้นหาตามประเภท (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - รับบริบทเซสชันล่าสุดสำหรับโปรเจกต์ -8. **Timeline** - รับไทม์ไลน์รวมของบริบทรอบจุดเวลาเฉพาะ -9. **Timeline by Query** - ค้นหาการสังเกตและรับบริบทไทม์ไลน์รอบการจับคู่ที่ดีที่สุด -10. **API Help** - รับเอกสาร search API +1. **`search`** - ค้นหาดัชนีหน่วยความจำด้วยคิวรีข้อความเต็ม กรองตามประเภท/วันที่/โปรเจกต์ +2. **`timeline`** - รับบริบทตามลำดับเวลารอบการสังเกตหรือคิวรีเฉพาะ +3. **`get_observations`** - ดึงรายละเอียดการสังเกตฉบับเต็มด้วย ID (ควรรวม ID หลายตัวเป็นชุดเสมอ) -**ตัวอย่างคิวรีภาษาธรรมชาติ:** +**ตัวอย่างการใช้งาน:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// ขั้นตอนที่ 1: ค้นหาเพื่อรับดัชนี +search(query="authentication bug", type="bugfix", limit=10) + +// ขั้นตอนที่ 2: ตรวจสอบดัชนี ระบุ ID ที่เกี่ยวข้อง (เช่น #123, #456) + +// ขั้นตอนที่ 3: ดึงรายละเอียดฉบับเต็ม +get_observations(ids=[123, 456]) ``` ดู [คู่มือเครื่องมือค้นหา](https://docs.claude-mem.ai/usage/search-tools) สำหรับตัวอย่างโดยละเอียด --- -## คุณสมบัติ Beta +## Release Branches -Claude-Mem นำเสนอ **beta channel** พร้อมคุณสมบัติทดลองเช่น **Endless Mode** (สถาปัตยกรรมหน่วยความจำแบบชีวมิติสำหรับเซสชันที่ขยายออกไป) สลับระหว่างเวอร์ชันเสถียรและเบต้าจาก web viewer UI ที่ http://localhost:37777 → Settings - -ดู **[เอกสารคุณสมบัติ Beta](https://docs.claude-mem.ai/beta-features)** สำหรับรายละเอียดเกี่ยวกับ Endless Mode และวิธีการลอง +รุ่นเสถียร (Stable) จะถูกปล่อยจาก `main` และเผยแพร่ไปยัง npm ส่วน `core-dev` และ +`community-edge` เป็น branch ที่รันจาก source สำหรับการแก้ไขความน่าเชื่อถือในช่วงแรกและ +การผสานรวมของชุมชน ดู **[Release Branches](https://docs.claude-mem.ai/branches)** +สำหรับลำดับการไหลของ branch และคำแนะนำการรันเวอร์ชันที่ไม่เสถียร --- @@ -225,6 +291,17 @@ Claude-Mem นำเสนอ **beta channel** พร้อมคุณสมบ - **uv**: ตัวจัดการแพ็คเกจ Python สำหรับการค้นหาเวกเตอร์ (ติดตั้งอัตโนมัติหากไม่มี) - **SQLite 3**: สำหรับการจัดเก็บถาวร (รวมอยู่) +--- +### หมายเหตุการตั้งค่าสำหรับ Windows + +หากคุณเห็นข้อผิดพลาดคล้ายกับ: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +ตรวจสอบให้แน่ใจว่าได้ติดตั้ง Node.js และ npm แล้ว และเพิ่มลงใน PATH ของคุณ ดาวน์โหลดตัวติดตั้ง Node.js ล่าสุดจาก https://nodejs.org และรีสตาร์ทเทอร์มินัลของคุณหลังจากการติดตั้ง + --- ## การกำหนดค่า @@ -233,6 +310,45 @@ Claude-Mem นำเสนอ **beta channel** พร้อมคุณสมบ ดู **[คู่มือการกำหนดค่า](https://docs.claude-mem.ai/configuration)** สำหรับการตั้งค่าทั้งหมดที่มีและตัวอย่าง +### การกำหนดค่าโหมดและภาษา + +Claude-Mem รองรับโหมด workflow และภาษาหลายแบบผ่านการตั้งค่า `CLAUDE_MEM_MODE` + +ตัวเลือกนี้ควบคุมทั้งสองสิ่งนี้: +- พฤติกรรมของ workflow (เช่น code, chill, investigation) +- ภาษาที่ใช้ในการสังเกตที่สร้างขึ้น + +#### วิธีการกำหนดค่า + +แก้ไขไฟล์การตั้งค่าของคุณที่ `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +โหมดต่างๆ ถูกกำหนดไว้ใน `plugin/modes/` เพื่อดูโหมดทั้งหมดที่มีในเครื่อง: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### โหมดที่มีให้ใช้งาน + +| โหมด | คำอธิบาย | +|------------|-------------------------| +| `code` | โหมดภาษาอังกฤษเริ่มต้น | +| `code--zh` | โหมดภาษาจีนตัวย่อ | +| `code--ja` | โหมดภาษาญี่ปุ่น | + +โหมดเฉพาะภาษาปฏิบัติตามรูปแบบ `code--[lang]` โดยที่ `[lang]` คือรหัสภาษา ISO 639-1 (เช่น `zh` สำหรับภาษาจีน, `ja` สำหรับภาษาญี่ปุ่น, `es` สำหรับภาษาสเปน) + +> หมายเหตุ: `code--zh` (ภาษาจีนตัวย่อ) มีอยู่ในตัวแล้ว — ไม่จำเป็นต้องติดตั้งเพิ่มเติมหรืออัปเดตปลั๊กอิน + +#### หลังจากเปลี่ยนโหมด + +รีสตาร์ท Claude Code เพื่อใช้การกำหนดค่าโหมดใหม่ --- ## การพัฒนา @@ -268,32 +384,48 @@ npm run bug-report 4. อัปเดตเอกสาร 5. ส่ง Pull Request +Claude-Mem เผยแพร่จากสาม branch: `main` (stable), `core-dev`, และ +`community-edge` มีเพียง `main` เท่านั้นที่เผยแพร่ไปยัง npm ส่วนที่เหลือรันจาก +source ดู [Release Branches](https://docs.claude-mem.ai/branches) สำหรับ +กลยุทธ์และคำแนะนำการรันในเครื่อง + ดู [คู่มือการพัฒนา](https://docs.claude-mem.ai/development) สำหรับขั้นตอนการมีส่วนร่วม --- -## License +## ใบอนุญาต -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem อยู่ภายใต้ใบอนุญาต Apache License 2.0 -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +เราเลือก Apache-2.0 เพราะหน่วยความจำแบบเอเจนต์ถาวรควรฝังตัวได้ง่ายในเครื่องมือของนักพัฒนา +เอเจนต์ในเครื่อง เซิร์ฟเวอร์ MCP ระบบองค์กร สแตกหุ่นยนต์ +และ production agent harness -See the [LICENSE](LICENSE) file for full details. +ดูไฟล์ [LICENSE](LICENSE) สำหรับรายละเอียดฉบับเต็ม ดู [docs/license.md](docs/license.md) +และ [docs/ip-boundary.md](docs/ip-boundary.md) สำหรับขอบเขตของใบอนุญาตและ +ขอบเขตระหว่างโอเพนซอร์ส/เชิงพาณิชย์ -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**หมายเหตุเกี่ยวกับ Ragtime**: ไดเรกทอรี `ragtime/` อยู่ภายใต้ใบอนุญาต **Apache License 2.0** ดู [ragtime/LICENSE](ragtime/LICENSE) สำหรับรายละเอียด --- - ## การสนับสนุน - **เอกสาร**: [docs/](docs/) - **ปัญหา**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **บัญชี X อย่างเป็นทางการ**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord อย่างเป็นทางการ**: [เข้าร่วม Discord](https://discord.com/invite/J4wttp9vDu) - **ผู้เขียน**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**สร้างด้วย Claude Agent SDK** | **ขับเคลื่อนโดย Claude Code** | **สร้างด้วย TypeScript** \ No newline at end of file +**สร้างด้วย Claude Agent SDK** | **ใช้งานร่วมกับ Claude Code** | **สร้างด้วย TypeScript** + +--- + +### CMEM คืออะไร? + +CMEM เป็นโทเค็นที่สร้างขึ้นโดยบุคคลที่สาม แต่ได้รับการยอมรับอย่างเป็นทางการจากผู้สร้าง Claude-Mem (Alex Newman, @thedotmack) โทเค็นนี้ทำหน้าที่เป็นตัวเร่งของชุมชนสำหรับการเติบโตและเป็นช่องทางในการนำ CMEM ไปสู่นักพัฒนาและผู้ปฏิบัติงานด้านความรู้ที่ต้องการมันมากที่สุด + +Official BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.tl.md b/docs/i18n/README.tl.md index ad73dff34..af967b49c 100644 --- a/docs/i18n/README.tl.md +++ b/docs/i18n/README.tl.md @@ -1,6 +1,5 @@ 🌐 Ito ay isang awtomatikong pagsasalin. Malugod na tinatanggap ang mga pagwawasto mula sa komunidad! ----


@@ -11,12 +10,16 @@
+ + Vercel OSS Program +

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • + 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • @@ -51,7 +54,7 @@

- License + License Version @@ -76,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Mabilis na Pagsisimula • @@ -95,16 +125,34 @@

- Pinapanatili ng Claude-Mem ang konteksto sa pagitan ng mga session sa pamamagitan ng awtomatikong pagkuha ng mga obserbasyon sa paggamit ng mga tool, pagbuo ng mga semantikong buod, at paggawa nitong available sa mga susunod na session. Dahil dito, napapanatili ni Claude ang tuloy-tuloy na kaalaman tungkol sa mga proyekto kahit matapos o muling kumonekta ang mga session. + Walang putol na pinapanatili ng Claude-Mem ang konteksto sa pagitan ng mga session sa pamamagitan ng awtomatikong pagkuha ng mga obserbasyon sa paggamit ng mga tool, paglikha ng mga semantikong buod, at paggawa nitong available sa mga susunod na session. Dahil dito, napapanatili ni Claude ang tuloy-tuloy na kaalaman tungkol sa mga proyekto kahit matapos ang mga session o muling kumonekta ang mga ito.

--- ## Mabilis na Pagsisimula -Magsimula ng bagong Claude Code session sa terminal at ilagay ang mga sumusunod na command: +I-install gamit ang isang solong command: +```bash +npx claude-mem install ``` + +O i-install para sa OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +O i-install para sa Antigravity CLI ([gabay sa pag-setup](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +O i-install mula sa plugin marketplace sa loob ng Claude Code: + +```bash /plugin marketplace add thedotmack/claude-mem /plugin install claude-mem @@ -112,18 +160,29 @@ Magsimula ng bagong Claude Code session sa terminal at ilagay ang mga sumusunod I-restart ang Claude Code. Awtomatikong lalabas sa mga bagong session ang konteksto mula sa mga nakaraang session. +> **Tandaan:** Nakapublish din ang Claude-Mem sa npm, ngunit ang `npm install -g claude-mem` ay nag-iinstall lamang ng **SDK/library** — hindi nito niroregister ang plugin hooks o nagse-set up ng worker service. Palaging mag-install sa pamamagitan ng `npx claude-mem install` o ng mga `/plugin` command sa itaas. + +### 🦞 OpenClaw Gateway + +I-install ang claude-mem bilang isang persistent memory plugin sa mga [OpenClaw](https://openclaw.ai) gateway gamit ang isang solong command: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Hinahawakan ng installer ang mga dependencies, plugin setup, konpigurasyon ng AI provider, pagsisimula ng worker, at opsyonal na real-time na observation feeds patungong Telegram, Discord, Slack, at iba pa. Tingnan ang [Gabay sa Integrasyon ng OpenClaw](https://docs.claude-mem.ai/openclaw-integration) para sa detalye. + **Mga Pangunahing Tampok:** - 🧠 **Persistent Memory** - Nananatili ang konteksto sa pagitan ng mga session - 📊 **Progressive Disclosure** - Layered na pagkuha ng memory na may visibility ng token cost - 🔍 **Skill-Based Search** - I-query ang history ng proyekto gamit ang mem-search skill -- 🖥️ **Web Viewer UI** - Real-time memory stream sa http://localhost:37777 -- 💻 **Claude Desktop Skill** - Maghanap sa memory mula sa Claude Desktop conversations +- 🖥️ **Web Viewer UI** - Real-time memory stream sa worker URL na ipinapakita sa startup +- 💻 **Claude Desktop Skill** - Maghanap sa memory mula sa mga Claude Desktop conversation - 🔒 **Privacy Control** - Gamitin ang `` tags para hindi ma-store ang sensitibong nilalaman - ⚙️ **Context Configuration** - Mas pinong kontrol kung anong konteksto ang ini-inject - 🤖 **Automatic Operation** - Walang kailangang manual na intervention -- 🔗 **Citations** - I-refer ang mga lumang obserbasyon gamit ang IDs (i-access sa http://localhost:37777/api/observation/{id} o tingnan lahat sa web viewer sa http://localhost:37777) -- 🧪 **Beta Channel** - Subukan ang mga experimental feature tulad ng Endless Mode sa pamamagitan ng version switching +- 🔗 **Citations** - I-refer ang mga nakaraang obserbasyon gamit ang IDs sa pamamagitan ng worker API o tingnan lahat sa web viewer --- @@ -136,7 +195,6 @@ I-restart ang Claude Code. Awtomatikong lalabas sa mga bagong session ang kontek - **[Gabay sa Pag-install](https://docs.claude-mem.ai/installation)** - Mabilis na pagsisimula at advanced installation - **[Gabay sa Paggamit](https://docs.claude-mem.ai/usage/getting-started)** - Paano awtomatikong gumagana ang Claude-Mem - **[Mga Search Tool](https://docs.claude-mem.ai/usage/search-tools)** - I-query ang history ng proyekto gamit ang natural language -- **[Mga Beta Feature](https://docs.claude-mem.ai/beta-features)** - Subukan ang mga experimental feature tulad ng Endless Mode ### Best Practices @@ -156,7 +214,8 @@ I-restart ang Claude Code. Awtomatikong lalabas sa mga bagong session ang kontek ### Konpigurasyon at Pagbuo - **[Konpigurasyon](https://docs.claude-mem.ai/configuration)** - Environment variables at settings -- **[Pagbuo](https://docs.claude-mem.ai/development)** - Build, test, at contribution workflow +- **[Pagbuo](https://docs.claude-mem.ai/development)** - Pag-build, pag-test, at contribution workflow +- **[Release Branches](https://docs.claude-mem.ai/branches)** - Daloy ng stable, core-dev, at community-edge branches - **[Pag-troubleshoot](https://docs.claude-mem.ai/troubleshooting)** - Karaniwang isyu at solusyon --- @@ -167,7 +226,7 @@ I-restart ang Claude Code. Awtomatikong lalabas sa mga bagong session ang kontek 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - Cached dependency checker (pre-hook script, hindi lifecycle hook) -3. **Worker Service** - HTTP API sa port 37777 na may web viewer UI at 10 search endpoints, pinamamahalaan ng Bun +3. **Worker Service** - Lokal na HTTP API na may web viewer UI at search endpoints, pinamamahalaan ng Bun 4. **SQLite Database** - Nag-iimbak ng sessions, observations, summaries 5. **mem-search Skill** - Natural language queries na may progressive disclosure 6. **Chroma Vector Database** - Hybrid semantic + keyword search para sa matalinong pagkuha ng konteksto @@ -178,7 +237,7 @@ Tingnan ang [Architecture Overview](https://docs.claude-mem.ai/architecture/over ## Mga Search Tool ng MCP -Nagbibigay ang Claude-Mem ng intelligent memory search sa pamamagitan ng **5 MCP tools** na sumusunod sa token-efficient na **3-layer workflow pattern**: +Nagbibigay ang Claude-Mem ng intelligent memory search sa pamamagitan ng **4 MCP tools** na sumusunod sa token-efficient na **3-layer workflow pattern**: **Ang 3-Layer Workflow:** @@ -187,21 +246,17 @@ Nagbibigay ang Claude-Mem ng intelligent memory search sa pamamagitan ng **5 MCP 3. **`get_observations`** - Kunin ang full details PARA LANG sa na-filter na IDs (~500-1,000 tokens/result) **Paano Ito Gumagana:** - - Gumagamit si Claude ng MCP tools para maghanap sa iyong memory - Magsimula sa `search` para makakuha ng index ng results - Gamitin ang `timeline` para makita ang nangyari sa paligid ng mga partikular na observation - Gamitin ang `get_observations` para kunin ang full details ng mga relevant na IDs -- Gamitin ang `save_memory` para manual na mag-store ng importanteng impormasyon - **~10x tipid sa tokens** dahil nagfi-filter muna bago kunin ang full details **Available na MCP Tools:** -1. **`search`** - Hanapin ang memory index gamit ang full-text queries, may filters (type/date/project) -2. **`timeline`** - Kumuha ng chronological context sa paligid ng isang observation o query +1. **`search`** - Hanapin ang memory index gamit ang full-text queries, may mga filter (type/date/project) +2. **`timeline`** - Kumuha ng chronological context sa paligid ng isang partikular na observation o query 3. **`get_observations`** - Kumuha ng full observation details gamit ang IDs (laging i-batch ang maraming IDs) -4. **`save_memory`** - Manual na mag-save ng memory/observation para sa semantic search -5. **`__IMPORTANT`** - Workflow documentation (laging visible kay Claude) **Halimbawa ng Paggamit:** @@ -213,20 +268,18 @@ search(query="authentication bug", type="bugfix", limit=10) // Step 3: Fetch full details get_observations(ids=[123, 456]) - -// Save important information manually -save_memory(text="API requires auth header X-API-Key", title="API Auth") ``` Tingnan ang [Search Tools Guide](https://docs.claude-mem.ai/usage/search-tools) para sa mas detalyadong mga halimbawa. --- -## Mga Beta Feature +## Release Branches -May **beta channel** ang Claude-Mem na may mga experimental feature gaya ng **Endless Mode** (biomimetic memory architecture para sa mas mahahabang session). Magpalit sa pagitan ng stable at beta versions sa web viewer UI sa http://localhost:37777 → Settings. - -Tingnan ang **[Dokumentasyon ng Mga Beta Feature](https://docs.claude-mem.ai/beta-features)** para sa detalye ng Endless Mode at kung paano ito subukan. +Ang mga stable release ay nagmumula sa `main` at pinapublish sa npm. Ang `core-dev` +at `community-edge` ay mga source-run branch para sa maagang reliability fixes at +community integrations. Tingnan ang **[Release Branches](https://docs.claude-mem.ai/branches)** +para sa daloy ng branch at mga instruksyon sa pagpapatakbo ng non-stable version. --- @@ -236,10 +289,9 @@ Tingnan ang **[Dokumentasyon ng Mga Beta Feature](https://docs.claude-mem.ai/bet - **Claude Code**: Pinakabagong bersyon na may plugin support - **Bun**: JavaScript runtime at process manager (auto-installed kung wala) - **uv**: Python package manager para sa vector search (auto-installed kung wala) -- **SQLite 3**: Para sa persistent storage (kasama) +- **SQLite 3**: Para sa persistent storage (kasama na) --- - ### Mga Tala sa Windows Setup Kung makakita ka ng error gaya ng: @@ -248,7 +300,7 @@ Kung makakita ka ng error gaya ng: npm : The term 'npm' is not recognized as the name of a cmdlet ``` -Siguraduhing naka-install ang Node.js at npm at nakadagdag sa PATH. I-download ang pinakabagong Node.js installer mula sa https://nodejs.org at i-restart ang terminal matapos mag-install. +Siguraduhing naka-install ang Node.js at npm at nakadagdag ang mga ito sa PATH. I-download ang pinakabagong Node.js installer mula sa https://nodejs.org at i-restart ang terminal matapos mag-install. --- @@ -258,25 +310,64 @@ Pinamamahalaan ang settings sa `~/.claude-mem/settings.json` (auto-created na ma Tingnan ang **[Gabay sa Konpigurasyon](https://docs.claude-mem.ai/configuration)** para sa lahat ng available na settings at mga halimbawa. +### Konpigurasyon ng Mode at Wika + +Sinusuportahan ng Claude-Mem ang maraming workflow mode at wika sa pamamagitan ng setting na `CLAUDE_MEM_MODE`. + +Kinokontrol ng opsyong ito ang parehong: +- Ang workflow behavior (hal. code, chill, investigation) +- Ang wikang ginagamit sa mga nabuong observation + +#### Paano Mag-configure + +I-edit ang iyong settings file sa `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Nakadefine ang mga mode sa `plugin/modes/`. Para makita ang lahat ng available na mode nang lokal: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Mga Available na Mode + +| Mode | Paglalarawan | +|------------|-------------------------| +| `code` | Default na mode sa Ingles | +| `code--zh` | Mode sa Simplified Chinese | +| `code--ja` | Mode sa Japanese | + +Ang mga wika-specific na mode ay sumusunod sa pattern na `code--[lang]` kung saan ang `[lang]` ay ang ISO 639-1 na language code (hal., `zh` para sa Chinese, `ja` para sa Japanese, `es` para sa Spanish). + +> Tandaan: Ang `code--zh` (Simplified Chinese) ay built-in na — walang kailangang karagdagang installation o plugin update. + +#### Pagkatapos Baguhin ang Mode + +I-restart ang Claude Code para maipatupad ang bagong konpigurasyon ng mode. --- ## Pagbuo -Tingnan ang **[Gabay nang pagbuo](https://docs.claude-mem.ai/development)** para sa pag build instructions, testing, at contribution workflow. +Tingnan ang **[Gabay sa Pagbuo](https://docs.claude-mem.ai/development)** para sa mga instruksyon sa pag-build, pag-test, at contribution workflow. --- ## Pag-troubleshoot -Kung may issue, ilarawan ang problema kay Claude at awtomatikong magdi-diagnose at magbibigay ng mga ayos ang troubleshoot skill. +Kung may naranasan kang isyu, ilarawan ang problema kay Claude at awtomatikong magda-diagnose at magbibigay ng mga ayos ang troubleshoot skill. Tingnan ang **[Troubleshooting Guide](https://docs.claude-mem.ai/troubleshooting)** para sa mga karaniwang isyu at solusyon. --- -## Bug Reports +## Mga Ulat ng Bug -Gumawa ng kumpletong bug reports gamit ang automated generator: +Gumawa ng kumpletong mga bug report gamit ang automated generator: ```bash cd ~/.claude/plugins/marketplaces/thedotmack @@ -289,36 +380,52 @@ Malugod na tinatanggap ang mga kontribusyon! Pakisunod: 1. I-fork ang repository 2. Gumawa ng feature branch -3. Gawin ang mga pagbabago kasama ang tests +3. Gawin ang mga pagbabago kasama ang mga test 4. I-update ang dokumentasyon 5. Mag-submit ng Pull Request -Tingnan ang [Gabay nang pagbuo](https://docs.claude-mem.ai/development) para sa contribution workflow. +Nagmumula ang Claude-Mem sa tatlong branch: `main` (stable), `core-dev`, at +`community-edge`. Tanging ang `main` lamang ang pinapublish sa npm; ang iba ay +pinapatakbo mula sa source. Tingnan ang [Release Branches](https://docs.claude-mem.ai/branches) para sa +estratehiya at mga instruksyon sa lokal na pagpapatakbo. + +Tingnan ang [Gabay sa Pagbuo](https://docs.claude-mem.ai/development) para sa contribution workflow. --- -## License +## Lisensya -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Ang Claude-Mem ay lisensyado sa ilalim ng Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Pinili namin ang Apache-2.0 dahil ang matibay na agentic memory ay dapat madaling +i-embed sa mga developer tool, local agents, MCP servers, enterprise systems, +robotics stacks, at production agent harnesses. -See the [LICENSE](LICENSE) file for full details. +Tingnan ang [LICENSE](LICENSE) file para sa buong detalye. Tingnan ang [docs/license.md](docs/license.md) +at [docs/ip-boundary.md](docs/ip-boundary.md) para sa saklaw ng lisensya at ang +hangganan ng open/commercial. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Tala tungkol sa Ragtime**: Ang direktoryong `ragtime/` ay lisensyado sa ilalim ng **Apache License 2.0**. Tingnan ang [ragtime/LICENSE](ragtime/LICENSE) para sa detalye. --- - ## Suporta - **Dokumentasyon**: [docs/](docs/) - **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) -- **Author**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) +- **Opisyal na X Account**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Opisyal na Discord**: [Sumali sa Discord](https://discord.com/invite/J4wttp9vDu) +- **May-akda**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Built with Claude Agent SDK** | **Works with Claude Code** | **Made with TypeScript** +**Ginawa gamit ang Claude Agent SDK** | **Gumagana sa Claude Code** | **Ginawa gamit ang TypeScript** + +--- + +### Ano ang CMEM? + +Ang CMEM ay isang token na ginawa ng isang 3rd party ngunit opisyal na tinanggap ng lumikha ng Claude-Mem (Alex Newman, @thedotmack). Ang token ay kumikilos bilang isang katalista ng komunidad para sa paglago at isang daluyan para dalhin ang CMEM sa mga developer at knowledge worker na pinakanangangailangan nito. + +Opisyal na BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.tr.md b/docs/i18n/README.tr.md index b9f4d6ca4..385932b80 100644 --- a/docs/i18n/README.tr.md +++ b/docs/i18n/README.tr.md @@ -10,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code için geliştirilmiş kalıcı bellek sıkıştırma sistemi.

- License + License Version @@ -74,22 +79,49 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

- Hızlı Başlangıç • - Nasıl Çalışır • - Arama Araçları • - Dokümantasyon • - Yapılandırma • - Sorun Giderme • - Lisans + Hızlı Başlangıç • + Nasıl Çalışır • + Arama Araçları • + Dokümantasyon • + Yapılandırma • + Sorun Giderme • + Lisans

@@ -98,34 +130,63 @@ --- -## Hızlı Başlangıç +## Quick Start -Terminal üzerinden yeni bir Claude Code oturumu başlatın ve aşağıdaki komutları girin: +Tek bir komutla kurun: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Ya da OpenCode için kurun: + +```bash +npx claude-mem install --ide opencode +``` + +Ya da Antigravity CLI için kurun ([kurulum kılavuzu](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Ya da Claude Code içindeki plugin pazaryerinden kurun: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak yeni oturumlarda görünecektir. +> **Not:** Claude-Mem npm'de de yayımlanmıştır, ancak `npm install -g claude-mem` yalnızca **SDK/kütüphaneyi** kurar — plugin hook'larını kaydetmez veya worker servisini kurmaz. Her zaman `npx claude-mem install` veya yukarıdaki `/plugin` komutlarıyla kurun. + +### 🦞 OpenClaw Gateway + +Claude-mem'i tek bir komutla [OpenClaw](https://openclaw.ai) gateway'lerine kalıcı bellek eklentisi olarak kurun: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Kurulum programı bağımlılıkları, plugin kurulumunu, AI sağlayıcı yapılandırmasını, worker başlatmayı ve Telegram, Discord, Slack ve daha fazlasına isteğe bağlı gerçek zamanlı gözlem akışlarını yönetir. Detaylar için [OpenClaw Entegrasyon Kılavuzu](https://docs.claude-mem.ai/openclaw-integration) bölümüne bakın. + **Temel Özellikler:** - 🧠 **Kalıcı Bellek** - Bağlam oturumlar arası hayatta kalır - 📊 **Aşamalı Açıklama** - Token maliyeti görünürlüğü ile katmanlı bellek erişimi - 🔍 **Beceri Tabanlı Arama** - mem-search becerisi ile proje geçmişinizi sorgulayın -- 🖥️ **Web Görüntüleyici Arayüzü** - http://localhost:37777 adresinde gerçek zamanlı bellek akışı +- 🖥️ **Web Görüntüleyici Arayüzü** - Başlangıçta yazdırılan worker URL'sinde gerçek zamanlı bellek akışı - 💻 **Claude Desktop Becerisi** - Claude Desktop konuşmalarından bellek araması yapın - 🔒 **Gizlilik Kontrolü** - Hassas içeriği depolamadan hariç tutmak için `` etiketlerini kullanın - ⚙️ **Bağlam Yapılandırması** - Hangi bağlamın enjekte edileceği üzerinde detaylı kontrol - 🤖 **Otomatik Çalışma** - Manuel müdahale gerektirmez -- 🔗 **Alıntılar** - ID'lerle geçmiş gözlemlere referans verin (http://localhost:37777/api/observation/{id} üzerinden erişin veya http://localhost:37777 adresindeki web görüntüleyicide tümünü görüntüleyin) -- 🧪 **Beta Kanalı** - Sürüm değiştirme yoluyla Endless Mode gibi deneysel özellikleri deneyin +- 🔗 **Alıntılar** - Worker API üzerinden ID'lerle geçmiş gözlemlere referans verin veya tümünü web görüntüleyicide görüntüleyin --- -## Dokümantasyon +## Documentation 📚 **[Tam Dokümantasyonu Görüntüle](https://docs.claude-mem.ai/)** - Resmi web sitesinde göz atın @@ -134,7 +195,6 @@ Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak - **[Kurulum Kılavuzu](https://docs.claude-mem.ai/installation)** - Hızlı başlangıç ve gelişmiş kurulum - **[Kullanım Kılavuzu](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem otomatik olarak nasıl çalışır - **[Arama Araçları](https://docs.claude-mem.ai/usage/search-tools)** - Doğal dil ile proje geçmişinizi sorgulayın -- **[Beta Özellikleri](https://docs.claude-mem.ai/beta-features)** - Endless Mode gibi deneysel özellikleri deneyin ### En İyi Uygulamalar @@ -155,17 +215,18 @@ Claude Code'u yeniden başlatın. Önceki oturumlardaki bağlam otomatik olarak - **[Yapılandırma](https://docs.claude-mem.ai/configuration)** - Ortam değişkenleri ve ayarlar - **[Geliştirme](https://docs.claude-mem.ai/development)** - Derleme, test etme, katkıda bulunma +- **[Sürüm Dalları](https://docs.claude-mem.ai/branches)** - Stable, core-dev ve community-edge dal akışı - **[Sorun Giderme](https://docs.claude-mem.ai/troubleshooting)** - Yaygın sorunlar ve çözümler --- -## Nasıl Çalışır +## How It Works **Temel Bileşenler:** 1. **5 Yaşam Döngüsü Hook'u** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook betiği) 2. **Akıllı Kurulum** - Önbelleğe alınmış bağımlılık kontrolcüsü (ön-hook betiği, yaşam döngüsü hook'u değil) -3. **Worker Servisi** - Web görüntüleyici arayüzü ve 10 arama uç noktası ile 37777 portunda HTTP API, Bun tarafından yönetilir +3. **Worker Servisi** - Web görüntüleyici arayüzü ve arama uç noktaları ile yerel HTTP API, Bun tarafından yönetilir 4. **SQLite Veritabanı** - Oturumları, gözlemleri, özetleri saklar 5. **mem-search Becerisi** - Aşamalı açıklama ile doğal dil sorguları 6. **Chroma Vektör Veritabanı** - Akıllı bağlam erişimi için hibrit anlamsal + anahtar kelime arama @@ -174,50 +235,55 @@ Detaylar için [Mimari Genel Bakış](https://docs.claude-mem.ai/architecture/ov --- -## mem-search Becerisi +## MCP Search Tools -Claude-Mem, geçmiş çalışmalarınız hakkında sorduğunuzda otomatik olarak devreye giren mem-search becerisi aracılığıyla akıllı arama sağlar: +Claude-Mem, token açısından verimli bir **3 katmanlı iş akışı düzeni**ni takip eden **4 MCP aracı** aracılığıyla akıllı bellek araması sağlar: + +**3 Katmanlı İş Akışı:** + +1. **`search`** - ID'lerle kompakt bir indeks alın (~50-100 token/sonuç) +2. **`timeline`** - İlgi çekici sonuçların çevresindeki kronolojik bağlamı alın +3. **`get_observations`** - Yalnızca filtrelenmiş ID'ler için tam detayları getirin (~500-1.000 token/sonuç) **Nasıl Çalışır:** -- Sadece doğal bir şekilde sorun: *"Geçen oturumda ne yaptık?"* veya *"Bu hatayı daha önce düzelttik mi?"* -- Claude, ilgili bağlamı bulmak için otomatik olarak mem-search becerisini çağırır +- Claude, belleğinizi aramak için MCP araçlarını kullanır +- Sonuçların bir indeksini almak için `search` ile başlayın +- Belirli gözlemlerin çevresinde neler olduğunu görmek için `timeline` kullanın +- İlgili ID'ler için tam detayları getirmek üzere `get_observations` kullanın +- Detayları getirmeden önce filtreleme yaparak **~10 kat token tasarrufu** sağlanır -**Mevcut Arama İşlemleri:** +**Mevcut MCP Araçları:** -1. **Search Observations** - Gözlemler arasında tam metin arama -2. **Search Sessions** - Oturum özetleri arasında tam metin arama -3. **Search Prompts** - Ham kullanıcı isteklerinde arama -4. **By Concept** - Kavram etiketlerine göre bul (discovery, problem-solution, pattern, vb.) -5. **By File** - Belirli dosyalara referans veren gözlemleri bul -6. **By Type** - Türe göre bul (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Bir proje için yakın zamanlı oturum bağlamını al -8. **Timeline** - Belirli bir zaman noktası etrafındaki birleşik bağlam zaman çizelgesini al -9. **Timeline by Query** - Gözlemleri ara ve en iyi eşleşme etrafındaki zaman çizelgesi bağlamını al -10. **API Help** - Arama API dokümantasyonunu al +1. **`search`** - Tam metin sorgularıyla bellek indeksini arayın, türe/tarihe/projeye göre filtreleyin +2. **`timeline`** - Belirli bir gözlem veya sorgu etrafındaki kronolojik bağlamı alın +3. **`get_observations`** - ID'lere göre tam gözlem detaylarını getirin (her zaman birden fazla ID'yi toplu olarak işleyin) -**Örnek Doğal Dil Sorguları:** +**Örnek Kullanım:** -``` -"Geçen oturumda hangi hataları düzelttik?" -"Kimlik doğrulamayı nasıl uyguladık?" -"worker-service.ts dosyasında hangi değişiklikler yapıldı?" -"Bu projedeki son çalışmaları göster" -"Görüntüleyici arayüzünü eklediğimizde ne oluyordu?" +```typescript +// Adım 1: İndeks için arama yapın +search(query="authentication bug", type="bugfix", limit=10) + +// Adım 2: İndeksi inceleyin, ilgili ID'leri belirleyin (örn. #123, #456) + +// Adım 3: Tam detayları getirin +get_observations(ids=[123, 456]) ``` Detaylı örnekler için [Arama Araçları Kılavuzu](https://docs.claude-mem.ai/usage/search-tools) bölümüne bakın. --- -## Beta Özellikleri +## Release Branches -Claude-Mem, **Endless Mode** (genişletilmiş oturumlar için biyomimetik bellek mimarisi) gibi deneysel özellikler içeren bir **beta kanalı** sunar. http://localhost:37777 → Settings adresindeki web görüntüleyici arayüzünden kararlı ve beta sürümleri arasında geçiş yapın. - -Endless Mode hakkında detaylar ve nasıl deneyeceğiniz için **[Beta Özellikleri Dokümantasyonu](https://docs.claude-mem.ai/beta-features)** bölümüne bakın. +Kararlı sürümler `main` dalından yayımlanır ve npm'e gönderilir. `core-dev` ve +`community-edge`, erken güvenilirlik düzeltmeleri ve topluluk entegrasyonları için +kaynaktan çalıştırılan dallardır. Dal akışı ve kararlı olmayan çalıştırma talimatları +için **[Sürüm Dalları](https://docs.claude-mem.ai/branches)** bölümüne bakın. --- -## Sistem Gereksinimleri +## System Requirements - **Node.js**: 20.0.0 veya üzeri - **Claude Code**: Plugin desteği olan en son sürüm @@ -226,22 +292,72 @@ Endless Mode hakkında detaylar ve nasıl deneyeceğiniz için **[Beta Özellikl - **SQLite 3**: Kalıcı depolama için (dahildir) --- +### Windows Kurulum Notları -## Yapılandırma +Aşağıdaki gibi bir hata görürseniz: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Node.js ve npm'in kurulu olduğundan ve PATH'inize eklendiğinden emin olun. https://nodejs.org adresinden en son Node.js kurulum dosyasını indirin ve kurulumdan sonra terminalinizi yeniden başlatın. + +--- + +## Configuration Ayarlar `~/.claude-mem/settings.json` dosyasında yönetilir (ilk çalıştırmada varsayılanlarla otomatik oluşturulur). AI modelini, worker portunu, veri dizinini, log seviyesini ve bağlam enjeksiyon ayarlarını yapılandırın. Tüm mevcut ayarlar ve örnekler için **[Yapılandırma Kılavuzu](https://docs.claude-mem.ai/configuration)** bölümüne bakın. +### Mod ve Dil Yapılandırması + +Claude-Mem, `CLAUDE_MEM_MODE` ayarı aracılığıyla birden fazla iş akışı modunu ve dili destekler. + +Bu seçenek şunları kontrol eder: +- İş akışı davranışını (örn. code, chill, investigation) +- Oluşturulan gözlemlerde kullanılan dili + +#### Nasıl Yapılandırılır + +`~/.claude-mem/settings.json` konumundaki ayarlar dosyanızı düzenleyin: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Modlar `plugin/modes/` içinde tanımlanır. Mevcut tüm modları yerel olarak görmek için: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Mevcut Modlar + +| Mod | Açıklama | +|------------|-------------------------| +| `code` | Varsayılan İngilizce mod | +| `code--zh` | Basitleştirilmiş Çince mod | +| `code--ja` | Japonca mod | + +Dile özgü modlar `code--[dil]` düzenini takip eder; burada `[dil]`, ISO 639-1 dil kodudur (örn. Çince için `zh`, Japonca için `ja`, İspanyolca için `es`). + +> Not: `code--zh` (Basitleştirilmiş Çince) zaten dahil edilmiştir — ek bir kurulum veya plugin güncellemesi gerekmez. + +#### Mod Değiştirdikten Sonra + +Yeni mod yapılandırmasını uygulamak için Claude Code'u yeniden başlatın. --- -## Geliştirme +## Development Derleme talimatları, test etme ve katkı iş akışı için **[Geliştirme Kılavuzu](https://docs.claude-mem.ai/development)** bölümüne bakın. --- -## Sorun Giderme +## Troubleshooting Sorunlarla karşılaşırsanız, sorunu Claude'a açıklayın ve troubleshoot becerisi otomatik olarak teşhis edip düzeltmeleri sağlayacaktır. @@ -249,7 +365,7 @@ Yaygın sorunlar ve çözümler için **[Sorun Giderme Kılavuzu](https://docs.c --- -## Hata Raporları +## Bug Reports Otomatik oluşturucu ile kapsamlı hata raporları oluşturun: @@ -258,7 +374,7 @@ cd ~/.claude/plugins/marketplaces/thedotmack npm run bug-report ``` -## Katkıda Bulunma +## Contributing Katkılar memnuniyetle karşılanır! Lütfen: @@ -268,32 +384,48 @@ Katkılar memnuniyetle karşılanır! Lütfen: 4. Dokümantasyonu güncelleyin 5. Pull Request gönderin +Claude-Mem üç daldan yayımlanır: `main` (kararlı), `core-dev` ve +`community-edge`. Yalnızca `main` npm'e yayımlanır; diğerleri kaynaktan +çalıştırılır. Strateji ve yerel çalıştırma talimatları için +[Sürüm Dalları](https://docs.claude-mem.ai/branches) bölümüne bakın. + Katkı iş akışı için [Geliştirme Kılavuzu](https://docs.claude-mem.ai/development) bölümüne bakın. --- ## License -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem, Apache License 2.0 lisansı altında lisanslanmıştır. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Apache-2.0'ı seçtik çünkü kalıcı ajan belleğinin geliştirici araçlarına, yerel +ajanlara, MCP sunucularına, kurumsal sistemlere, robotik yığınlarına ve üretim +ajan altyapılarına kolayca gömülebilir olması gerekiyor. -See the [LICENSE](LICENSE) file for full details. +Tüm detaylar için [LICENSE](LICENSE) dosyasına bakın. Lisanslama kapsamı ve +açık/ticari sınır için [docs/license.md](docs/license.md) ve +[docs/ip-boundary.md](docs/ip-boundary.md) bölümlerine bakın. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtime ile ilgili not**: `ragtime/` dizini **Apache License 2.0** altında lisanslanmıştır. Detaylar için [ragtime/LICENSE](ragtime/LICENSE) bölümüne bakın. --- - -## Destek +## Support - **Dokümantasyon**: [docs/](docs/) - **Sorunlar**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Depo**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Resmi X Hesabı**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Resmi Discord**: [Discord'a Katıl](https://discord.com/invite/J4wttp9vDu) - **Yazar**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Claude Agent SDK ile geliştirilmiştir** | **Claude Code ile desteklenmektedir** | **TypeScript ile yapılmıştır** \ No newline at end of file +**Claude Agent SDK ile geliştirilmiştir** | **Claude Code ile çalışır** | **TypeScript ile yapılmıştır** + +--- + +### CMEM Ne Demek? + +CMEM, 3. bir taraf tarafından oluşturulan ancak Claude-Mem'in yaratıcısı (Alex Newman, @thedotmack) tarafından resmi olarak benimsenen bir token'dır. Bu token, büyüme için bir topluluk katalizörü ve CMEM'i en çok ihtiyaç duyan geliştiricilere ve bilgi çalışanlarına ulaştırmak için bir araç olarak işlev görür. + +Resmi BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.uk.md b/docs/i18n/README.uk.md index 7bf50cd88..d4522ba4a 100644 --- a/docs/i18n/README.uk.md +++ b/docs/i18n/README.uk.md @@ -1,6 +1,5 @@ 🌐 Це автоматичний переклад. Вітаються виправлення від спільноти! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Система стиснення постійної пам'яті, створена для Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Швидкий старт • @@ -101,28 +132,57 @@ ## Швидкий старт -Розпочніть нову сесію Claude Code у терміналі та введіть наступні команди: +Встановіть однією командою: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Або встановіть для OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Або встановіть для Antigravity CLI ([посібник із налаштування](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Або встановіть з маркетплейсу плагінів прямо в Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Перезапустіть Claude Code. Контекст з попередніх сесій автоматично з'явиться в нових сесіях. +> **Примітка:** Claude-Mem також опубліковано в npm, але `npm install -g claude-mem` встановлює **лише SDK/бібліотеку** — він не реєструє хуки плагіна і не налаштовує службу воркера. Завжди встановлюйте через `npx claude-mem install` або команди `/plugin`, наведені вище. + +### 🦞 OpenClaw Gateway + +Встановіть claude-mem як плагін постійної пам'яті на шлюзах [OpenClaw](https://openclaw.ai) однією командою: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Інсталятор обробляє залежності, налаштування плагіна, конфігурацію AI-провайдера, запуск воркера та опціональні потоки спостережень у реальному часі до Telegram, Discord, Slack та інших. Дивіться [Посібник з інтеграції OpenClaw](https://docs.claude-mem.ai/openclaw-integration) для деталей. + **Ключові можливості:** - 🧠 **Постійна пам'ять** - Контекст зберігається між сесіями - 📊 **Прогресивне розкриття** - Багаторівневе отримання пам'яті з видимістю вартості токенів - 🔍 **Пошук на основі навичок** - Запитуйте історію свого проєкту за допомогою навички mem-search -- 🖥️ **Веб-інтерфейс перегляду** - Потік пам'яті в реальному часі на http://localhost:37777 +- 🖥️ **Веб-інтерфейс перегляду** - Потік пам'яті в реальному часі за URL-адресою воркера, яка виводиться під час запуску - 💻 **Навичка Claude Desktop** - Шукайте в пам'яті з розмов Claude Desktop - 🔒 **Контроль конфіденційності** - Використовуйте теги `` для виключення чутливого вмісту зі зберігання - ⚙️ **Конфігурація контексту** - Детальний контроль над тим, який контекст впроваджується - 🤖 **Автоматична робота** - Не потребує ручного втручання -- 🔗 **Цитування** - Посилайтеся на минулі спостереження за ідентифікаторами (доступ через http://localhost:37777/api/observation/{id} або перегляд усіх у веб-переглядачі на http://localhost:37777) -- 🧪 **Бета-канал** - Спробуйте експериментальні функції, як-от режим Endless Mode, через перемикання версій +- 🔗 **Цитування** - Посилайтеся на минулі спостереження за ідентифікаторами через API воркера або переглядайте всі у веб-переглядачі --- @@ -135,7 +195,6 @@ - **[Посібник з встановлення](https://docs.claude-mem.ai/installation)** - Швидкий старт і розширене встановлення - **[Посібник з використання](https://docs.claude-mem.ai/usage/getting-started)** - Як Claude-Mem працює автоматично - **[Інструменти пошуку](https://docs.claude-mem.ai/usage/search-tools)** - Запитуйте історію свого проєкту природною мовою -- **[Бета-функції](https://docs.claude-mem.ai/beta-features)** - Спробуйте експериментальні функції, як-от режим Endless Mode ### Найкращі практики @@ -156,6 +215,7 @@ - **[Конфігурація](https://docs.claude-mem.ai/configuration)** - Змінні середовища та налаштування - **[Розробка](https://docs.claude-mem.ai/development)** - Збірка, тестування, внесок +- **[Гілки релізів](https://docs.claude-mem.ai/branches)** - Потік гілок stable, core-dev та community-edge - **[Усунення несправностей](https://docs.claude-mem.ai/troubleshooting)** - Поширені проблеми та рішення --- @@ -166,7 +226,7 @@ 1. **5 хуків життєвого циклу** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 скриптів хуків) 2. **Розумне встановлення** - Кешована перевірка залежностей (скрипт перед хуком, не хук життєвого циклу) -3. **Сервіс воркера** - HTTP API на порту 37777 з веб-інтерфейсом перегляду та 10 кінцевими точками пошуку, керується Bun +3. **Сервіс воркера** - Локальний HTTP API з веб-інтерфейсом перегляду та кінцевими точками пошуку, керується Bun 4. **База даних SQLite** - Зберігає сесії, спостереження, резюме 5. **Навичка mem-search** - Запити природною мовою з прогресивним розкриттям 6. **Векторна база даних Chroma** - Гібридний семантичний + ключовий пошук для інтелектуального отримання контексту @@ -175,46 +235,51 @@ --- -## Навичка mem-search +## Інструменти пошуку MCP -Claude-Mem надає інтелектуальний пошук через навичку mem-search, яка автоматично викликається, коли ви запитуєте про минулу роботу: +Claude-Mem надає інтелектуальний пошук пам'яті через **4 інструменти MCP**, що дотримуються економного щодо токенів шаблону **3-рівневого робочого процесу**: + +**3-рівневий робочий процес:** + +1. **`search`** - Отримати компактний індекс з ідентифікаторами (~50-100 токенів/результат) +2. **`timeline`** - Отримати хронологічний контекст навколо цікавих результатів +3. **`get_observations`** - Завантажити повні деталі ЛИШЕ для відфільтрованих ідентифікаторів (~500-1000 токенів/результат) **Як це працює:** -- Просто запитайте природно: *"Що ми робили в минулій сесії?"* або *"Ми виправляли цю помилку раніше?"* -- Claude автоматично викликає навичку mem-search для пошуку релевантного контексту +- Claude використовує інструменти MCP для пошуку у вашій пам'яті +- Почніть з `search`, щоб отримати індекс результатів +- Використовуйте `timeline`, щоб побачити, що відбувалося навколо конкретних спостережень +- Використовуйте `get_observations`, щоб завантажити повні деталі для релевантних ідентифікаторів +- **~10-кратна економія токенів** завдяки фільтрації перед завантаженням деталей -**Доступні операції пошуку:** +**Доступні інструменти MCP:** -1. **Пошук спостережень** - Повнотекстовий пошук у спостереженнях -2. **Пошук сесій** - Повнотекстовий пошук у резюме сесій -3. **Пошук запитів** - Пошук необроблених запитів користувачів -4. **За концепцією** - Знайти за тегами концепцій (discovery, problem-solution, pattern тощо) -5. **За файлом** - Знайти спостереження, що посилаються на конкретні файли -6. **За типом** - Знайти за типом (decision, bugfix, feature, refactor, discovery, change) -7. **Останній контекст** - Отримати останній контекст сесії для проєкту -8. **Часова шкала** - Отримати єдину часову шкалу контексту навколо конкретного моменту часу -9. **Часова шкала за запитом** - Шукати спостереження та отримувати контекст часової шкали навколо найкращого збігу -10. **Довідка API** - Отримати документацію API пошуку +1. **`search`** - Пошук в індексі пам'яті за повнотекстовими запитами, фільтрація за типом/датою/проєктом +2. **`timeline`** - Отримати хронологічний контекст навколо конкретного спостереження або запиту +3. **`get_observations`** - Завантажити повні деталі спостережень за ідентифікаторами (завжди групуйте кілька ідентифікаторів) -**Приклади запитів природною мовою:** +**Приклад використання:** -``` -"Які помилки ми виправили в минулій сесії?" -"Як ми реалізували автентифікацію?" -"Які зміни були внесені в worker-service.ts?" -"Покажи мені останню роботу над цим проєктом" -"Що відбувалося, коли ми додали інтерфейс перегляду?" +```typescript +// Крок 1: Пошук індексу +search(query="authentication bug", type="bugfix", limit=10) + +// Крок 2: Перегляньте індекс, визначте релевантні ідентифікатори (наприклад, #123, #456) + +// Крок 3: Завантажте повні деталі +get_observations(ids=[123, 456]) ``` Дивіться [Посібник з інструментів пошуку](https://docs.claude-mem.ai/usage/search-tools) для детальних прикладів. --- -## Бета-функції +## Гілки релізів -Claude-Mem пропонує **бета-канал** з експериментальними функціями, як-от **режим Endless Mode** (біоміметична архітектура пам'яті для тривалих сесій). Перемикайтеся між стабільною та бета-версіями з веб-інтерфейсу перегляду на http://localhost:37777 → Налаштування. - -Дивіться **[Документацію бета-функцій](https://docs.claude-mem.ai/beta-features)** для деталей про режим Endless Mode та як його спробувати. +Стабільні релізи випускаються з `main` і публікуються в npm. `core-dev` та +`community-edge` — це гілки, що запускаються з вихідного коду, для ранніх виправлень надійності та +інтеграцій зі спільнотою. Дивіться **[Гілки релізів](https://docs.claude-mem.ai/branches)** +для потоку гілок та інструкцій із запуску нестабільних версій. --- @@ -226,6 +291,17 @@ Claude-Mem пропонує **бета-канал** з експеримента - **uv**: Менеджер пакетів Python для векторного пошуку (автоматично встановлюється, якщо відсутній) - **SQLite 3**: Для постійного зберігання (у комплекті) +--- +### Примітки щодо налаштування у Windows + +Якщо ви бачите помилку на кшталт: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Переконайтеся, що Node.js та npm встановлені та додані до вашого PATH. Завантажте останній інсталятор Node.js з https://nodejs.org та перезапустіть термінал після встановлення. + --- ## Конфігурація @@ -234,6 +310,45 @@ Claude-Mem пропонує **бета-канал** з експеримента Дивіться **[Посібник з конфігурації](https://docs.claude-mem.ai/configuration)** для всіх доступних налаштувань та прикладів. +### Конфігурація режиму та мови + +Claude-Mem підтримує кілька режимів робочого процесу та мов через налаштування `CLAUDE_MEM_MODE`. + +Цей параметр контролює: +- Поведінку робочого процесу (наприклад, code, chill, investigation) +- Мову, що використовується у створених спостереженнях + +#### Як налаштувати + +Відредагуйте файл налаштувань за адресою `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Режими визначені в `plugin/modes/`. Щоб переглянути всі доступні режими локально: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Доступні режими + +| Режим | Опис | +|------------|-------------------------| +| `code` | Стандартний англомовний режим | +| `code--zh` | Режим спрощеної китайської | +| `code--ja` | Японський режим | + +Мовні режими дотримуються шаблону `code--[lang]`, де `[lang]` — це код мови ISO 639-1 (наприклад, `zh` для китайської, `ja` для японської, `es` для іспанської). + +> Примітка: `code--zh` (спрощена китайська) вже вбудований — додаткове встановлення чи оновлення плагіна не потрібне. + +#### Після зміни режиму + +Перезапустіть Claude Code, щоб застосувати нову конфігурацію режиму. --- ## Розробка @@ -269,32 +384,48 @@ npm run bug-report 4. Оновіть документацію 5. Надішліть Pull Request +Claude-Mem випускається з трьох гілок: `main` (стабільна), `core-dev` та +`community-edge`. Лише `main` публікується в npm; інші запускаються з +вихідного коду. Дивіться [Гілки релізів](https://docs.claude-mem.ai/branches) щодо +стратегії та інструкцій із локального запуску. + Дивіться [Посібник з розробки](https://docs.claude-mem.ai/development) для робочого процесу внеску. --- -## License +## Ліцензія -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem ліцензовано за ліцензією Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Ми обрали Apache-2.0, оскільки довговічна агентна пам'ять має легко вбудовуватися в +інструменти розробника, локальних агентів, MCP-сервери, корпоративні системи, робототехнічні +стеки та виробничі агентні системи. -See the [LICENSE](LICENSE) file for full details. +Дивіться файл [LICENSE](LICENSE) для повних деталей. Дивіться [docs/license.md](docs/license.md) +та [docs/ip-boundary.md](docs/ip-boundary.md) щодо обсягу ліцензування та +межі між відкритим і комерційним використанням. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Примітка щодо Ragtime**: Каталог `ragtime/` ліцензовано за **Apache License 2.0**. Дивіться [ragtime/LICENSE](ragtime/LICENSE) для деталей. --- - ## Підтримка - **Документація**: [docs/](docs/) - **Проблеми**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Репозиторій**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Офіційний акаунт X**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Офіційний Discord**: [Приєднатися до Discord](https://discord.com/invite/J4wttp9vDu) - **Автор**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Створено за допомогою Claude Agent SDK** | **Працює на Claude Code** | **Зроблено з TypeScript** \ No newline at end of file +**Створено за допомогою Claude Agent SDK** | **Працює на Claude Code** | **Зроблено з TypeScript** + +--- + +### А як щодо CMEM? + +CMEM — це токен, створений третьою стороною, але офіційно підтриманий творцем Claude-Mem (Alex Newman, @thedotmack). Токен виступає як каталізатор зростання спільноти та засіб для донесення CMEM до розробників і працівників розумової праці, яким він найбільше потрібен. + +Офіційна CA у мережі BASE: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.ur.md b/docs/i18n/README.ur.md index 93931dc13..fcbaf90ac 100644 --- a/docs/i18n/README.ur.md +++ b/docs/i18n/README.ur.md @@ -1,7 +1,5 @@ -

🌐 یہ ایک خودکار ترجمہ ہے۔ کمیونٹی کی اصلاحات کا خیر مقدم ہے! ----


@@ -12,45 +10,51 @@
+ + Vercel OSS Program +

-

- 🇨🇳 中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk +

+ 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Claude Code کے لیے بنایا گیا مستقل میموری کمپریشن سسٹم۔

- License + License Version @@ -75,87 +79,143 @@
+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +
+

- - - Claude-Mem Preview - - + تیز رفتار شروعات • + یہ کیسے کام کرتا ہے • + تلاش کے اوزار • + دستاویزات • + ترتیبات • + مسائل کی تشخیص • + لائسنس

- تیز رفتار شروعات • - یہ کیسے کام کرتا ہے • - تلاش کے اوزار • - دستاویزات • - ترتیبات • - مسائل کی تشخیص • - لائسنس -

- -

- Claude-Mem خودکار طور پر ٹول کے استعمال کے بعد کے مشاہدات کو ریکارڈ کرتا ہے، سیمانٹک خلاصے تیار کرتا ہے اور انہیں مستقبل کے سیشنز میں دستیاب کرتا ہے تاکہ آپ سیشن میں براہ راست تناسب محفوظ رہے۔ یہ Claude کو سیشن ختم ہونے یا دوبارہ جڑنے کے بعد بھی منصوبے کے بارے میں معلومات کی مسلسلیت برقرار رکھنے کے قابل بناتا ہے۔ + Claude-Mem سیشنز کے درمیان تناسب کو بغیر کسی رکاوٹ کے محفوظ رکھتا ہے، خودکار طور پر ٹول کے استعمال کے مشاہدات کو ریکارڈ کرتے ہوئے، سیمانٹک خلاصے تیار کرتے ہوئے اور انہیں مستقبل کے سیشنز کے لیے دستیاب کرتے ہوئے۔ یہ Claude کو سیشن ختم ہونے یا دوبارہ جڑنے کے بعد بھی منصوبوں کے بارے میں معلومات کی مسلسلیت برقرار رکھنے کے قابل بناتا ہے۔

--- ## تیز رفتار شروعات -ٹرمنل میں نیا Claude Code سیشن شروع کریں اور ہیں کمانڈز درج کریں: +ایک کمانڈ کے ساتھ انسٹال کریں: -``` -> /plugin marketplace add thedotmack/claude-mem - -> /plugin install claude-mem +```bash +npx claude-mem install ``` -Claude Code کو دوبارہ شروع کریں۔ سابقہ سیشن کا تناسب خودکار طور پر نئے سیشن میں موجود ہوگا۔ +یا OpenCode کے لیے انسٹال کریں: + +```bash +npx claude-mem install --ide opencode +``` + +یا Antigravity CLI کے لیے انسٹال کریں ([سیٹ اپ گائیڈ](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +یا Claude Code کے اندر پلگ ان مارکیٹ پلیس سے انسٹال کریں: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem +``` + +Claude Code کو دوبارہ شروع کریں۔ سابقہ سیشنز کا تناسب خودکار طور پر نئے سیشنز میں ظاہر ہوگا۔ + +> **نوٹ:** Claude-Mem npm پر بھی شائع کیا گیا ہے، لیکن `npm install -g claude-mem` صرف **SDK/لائبریری** انسٹال کرتا ہے — یہ پلگ ان ہکس کو رجسٹر نہیں کرتا اور نہ ہی ورکر سروس سیٹ اپ کرتا ہے۔ ہمیشہ `npx claude-mem install` یا اوپر دیے گئے `/plugin` کمانڈز کے ذریعے ہی انسٹال کریں۔ + +### 🦞 OpenClaw گیٹ وے + +[OpenClaw](https://openclaw.ai) گیٹ ویز پر ایک ہی کمانڈ کے ساتھ claude-mem کو مستقل میموری پلگ ان کے طور پر انسٹال کریں: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +انسٹالر منحصرات، پلگ ان سیٹ اپ، AI پرووائیڈر کنفیگریشن، ورکر اسٹارٹ اپ، اور Telegram، Discord، Slack وغیرہ کو اختیاری حقیقی وقت مشاہدہ فیڈز کا خیال رکھتا ہے۔ تفصیلات کے لیے [OpenClaw انٹیگریشن گائیڈ](https://docs.claude-mem.ai/openclaw-integration) دیکھیں۔ **اہم خصوصیات:** -- 🧠 **مستقل میموری** - تناسب سیشن کے دوران برقرار رہتا ہے -- 📊 **بتدریج ظہور** - لیئرڈ میموری کی بازیافت ٹوکن کی لاگت کی نمائندگی کے ساتھ -- 🔍 **کمکردہ تلاش** - mem-search مہارت کے ساتھ اپنے منصوبے کی تاریخ میں تلاش کریں -- 🖥️ **ویب ویور یو آئی** - http://localhost:37777 پر حقیقی وقت میموری اسٹریم +- 🧠 **مستقل میموری** - تناسب سیشنز کے دوران برقرار رہتا ہے +- 📊 **بتدریج ظہور** - ٹوکن لاگت کی نمائندگی کے ساتھ لیئرڈ میموری کی بازیافت +- 🔍 **مہارت پر مبنی تلاش** - mem-search مہارت کے ساتھ اپنے منصوبے کی تاریخ میں سوال کریں +- 🖥️ **ویب ویور یو آئی** - اسٹارٹ اپ پر پرنٹ ہونے والے ورکر URL پر حقیقی وقت میموری اسٹریم - 💻 **Claude Desktop مہارت** - Claude Desktop بات چیت سے میموری تلاش کریں -- 🔒 **رازداری کے کنٹرولز** - حساس مواد کو ذخیرہ سے خارج کرنے کے لیے `` ٹیگ استعمال کریں +- 🔒 **رازداری کنٹرول** - حساس مواد کو ذخیرہ سے خارج کرنے کے لیے `` ٹیگز استعمال کریں - ⚙️ **تناسب کی ترتیبات** - کون سا تناسب انجیکٹ کیا جائے اس پر باریک کنٹرول - 🤖 **خودکار آپریشن** - کسی دستی مداخلت کی ضرورت نہیں -- 🔗 **حوالہ** - ID کے ذریعے سابقہ مشاہدات کا حوالہ دیں (http://localhost:37777/api/observation/{id} کے ذریعے رسائی حاصل کریں یا تمام کو http://localhost:37777 پر ویب ویور میں دیکھیں) -- 🧪 **بیٹا چینل** - ورژن تبدیل کرنے کے ذریعے Endless Mode جیسی تجرباتی خصوصیات آزمائیں +- 🔗 **حوالہ جات** - ورکر API کے ذریعے IDs کے ساتھ سابقہ مشاہدات کا حوالہ دیں یا سب کو ویب ویور میں دیکھیں --- ## دستاویزات -📚 **[مکمل دستاویزات دیکھیں](docs/)** - GitHub پر markdown ڈاکس کو براؤز کریں +📚 **[مکمل دستاویزات دیکھیں](https://docs.claude-mem.ai/)** - سرکاری ویب سائٹ پر براؤز کریں ### شروعات کرنا - **[انسٹالیشن گائیڈ](https://docs.claude-mem.ai/installation)** - تیز رفتار شروعات اور اعلیٰ درجے کی انسٹالیشن - **[استعمال گائیڈ](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem خودکار طور پر کیسے کام کرتا ہے -- **[تلاش کے اوزار](https://docs.claude-mem.ai/usage/search-tools)** - قدرتی زبان کے ساتھ اپنے منصوبے کی تاریخ میں تلاش کریں -- **[بیٹا خصوصیات](https://docs.claude-mem.ai/beta-features)** - Endless Mode جیسی تجرباتی خصوصیات آزمائیں +- **[تلاش کے اوزار](https://docs.claude-mem.ai/usage/search-tools)** - قدرتی زبان کے ساتھ اپنے منصوبے کی تاریخ میں سوال کریں ### بہترین طریقہ کار -- **[تناسب انجینیئرنگ](https://docs.claude-mem.ai/context-engineering)** - AI ایجنٹ کے تناسب کی اہمیت کے اصول -- **[بتدریج ظہور](https://docs.claude-mem.ai/progressive-disclosure)** - Claude-Mem کے تناسب کی تیاری کی حکمت عملی کے پیچھے فلسفہ +- **[تناسب انجینیئرنگ](https://docs.claude-mem.ai/context-engineering)** - AI ایجنٹ تناسب کی اصلاح کے اصول +- **[بتدریج ظہور](https://docs.claude-mem.ai/progressive-disclosure)** - Claude-Mem کی تناسب پرائمنگ حکمت عملی کے پیچھے فلسفہ ### تعمیر -- **[جائزہ](https://docs.claude-mem.ai/architecture/overview)** - نظام کے اجزاء اور ڈیٹا کے بہاؤ +- **[جائزہ](https://docs.claude-mem.ai/architecture/overview)** - نظام کے اجزاء اور ڈیٹا کا بہاؤ - **[تعمیر کا ارتقاء](https://docs.claude-mem.ai/architecture-evolution)** - v3 سے v5 تک کا سفر - **[ہکس تعمیر](https://docs.claude-mem.ai/hooks-architecture)** - Claude-Mem لائف سائیکل ہکس کا استعمال کیسے کرتا ہے - **[ہکس حوالہ](https://docs.claude-mem.ai/architecture/hooks)** - 7 ہک اسکرپٹس کی تشریح - **[ورکر سروس](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API اور Bun انتظام - **[ڈیٹا بیس](https://docs.claude-mem.ai/architecture/database)** - SQLite اسکیما اور FTS5 تلاش -- **[تلاش تعمیر](https://docs.claude-mem.ai/architecture/search-architecture)** - Chroma ویکٹر ڈیٹا بیس کے ساتھ ہائبرڈ تلاش +- **[تلاش کی تعمیر](https://docs.claude-mem.ai/architecture/search-architecture)** - Chroma ویکٹر ڈیٹا بیس کے ساتھ ہائبرڈ تلاش ### ترتیبات اور ترقی - **[ترتیبات](https://docs.claude-mem.ai/configuration)** - ماحول کے متغیرات اور سیٹنگز - **[ترقی](https://docs.claude-mem.ai/development)** - تعمیر، جانچ، حصہ داری +- **[ریلیز برانچز](https://docs.claude-mem.ai/branches)** - Stable، core-dev، اور community-edge برانچ کا بہاؤ - **[مسائل کی تشخیص](https://docs.claude-mem.ai/troubleshooting)** - عام مسائل اور حل --- @@ -166,10 +226,10 @@ Claude Code کو دوبارہ شروع کریں۔ سابقہ سیشن کا تن 1. **5 لائف سائیکل ہکس** - SessionStart، UserPromptSubmit، PostToolUse، Stop، SessionEnd (6 ہک اسکرپٹس) 2. **سمارٹ انسٹالیشن** - کیش شدہ منحصرات چیکر (پری ہک اسکرپٹ، لائف سائیکل ہک نہیں) -3. **ورکر سروس** - ویب ویور UI اور 10 تلاش کے endpoints کے ساتھ پورٹ 37777 پر HTTP API، Bun کے ذریعے برتاؤ -4. **SQLite ڈیٹا بیس** - سیشنز، مشاہدات، خلاصہ ذخیرہ کرتا ہے +3. **ورکر سروس** - ویب ویور UI اور تلاش کے endpoints کے ساتھ لوکل HTTP API، Bun کے ذریعے منظم +4. **SQLite ڈیٹا بیس** - سیشنز، مشاہدات، خلاصے ذخیرہ کرتا ہے 5. **mem-search مہارت** - بتدریج ظہور کے ساتھ قدرتی زبان کے سوالات -6. **Chroma ویکٹر ڈیٹا بیس** - ہائبرڈ سیمانٹک + کلیدی لفظ تلاش ذہین تناسب کی بازیافت کے لیے +6. **Chroma ویکٹر ڈیٹا بیس** - ذہین تناسب کی بازیافت کے لیے ہائبرڈ سیمانٹک + کلیدی لفظ تلاش تفصیلات کے لیے [تعمیر کا جائزہ](https://docs.claude-mem.ai/architecture/overview) دیکھیں۔ @@ -188,16 +248,15 @@ Claude-Mem ٹوکن-موثر **3-لیئر ورک فلو پیٹرن** کی پیر **یہ کیسے کام کرتا ہے:** - Claude آپ کی میموری میں تلاش کے لیے MCP اوزار استعمال کرتا ہے - نتائج کا انڈیکس حاصل کرنے کے لیے `search` سے شروع کریں -- مخصوص مشاہدات کے ارد گرد کیا ہو رہا تھا دیکھنے کے لیے `timeline` استعمال کریں +- مخصوص مشاہدات کے ارد گرد کیا ہو رہا تھا یہ دیکھنے کے لیے `timeline` استعمال کریں - متعلقہ IDs کے لیے مکمل تفصیلات حاصل کرنے کے لیے `get_observations` استعمال کریں -- تفصیلات حاصل کرنے سے پہلے فلٹرنگ کے ذریعے **~10x ٹوکن کی بچت** +- تفصیلات حاصل کرنے سے پہلے فلٹرنگ کے ذریعے **~10 گنا ٹوکن کی بچت** **دستیاب MCP اوزار:** -1. **`search`** - مکمل متن کی تلاش کے سوالات کے ساتھ میموری انڈیکس تلاش کریں، قسم/تاریخ/منصوبے کے لحاظ سے فلٹر کریں -2. **`timeline`** - مخصوص مشاہدہ یا سوال کے ارد گرد زمانی تناسب حاصل کریں +1. **`search`** - مکمل متن کے سوالات کے ساتھ میموری انڈیکس تلاش کریں، قسم/تاریخ/منصوبے کے لحاظ سے فلٹر کریں +2. **`timeline`** - مخصوص مشاہدے یا سوال کے ارد گرد زمانی تناسب حاصل کریں 3. **`get_observations`** - IDs کے ذریعے مکمل مشاہدہ تفصیلات حاصل کریں (ہمیشہ متعدد IDs کو بیچ کریں) -4. **`__IMPORTANT`** - ورک فلو دستاویزات (ہمیشہ Claude کو نظر آتی ہے) **استعمال کی مثال:** @@ -215,11 +274,11 @@ get_observations(ids=[123, 456]) --- -## بیٹا خصوصیات +## ریلیز برانچز -Claude-Mem ایک **بیٹا چینل** فراہم کرتا ہے جس میں **Endless Mode** جیسی تجرباتی خصوصیات ہیں (بڑھی ہوئی سیشنز کے لیے حیاتی نقل میموری کی تعمیر)۔ http://localhost:37777 → Settings میں ویب ویور UI سے مستحکم اور بیٹا ورژن کے درمیان سوئچ کریں۔ - -Endless Mode اور اسے کیسے آزمائیں اس کے بارے میں تفصیلات کے لیے **[بیٹا خصوصیات دستاویزات](https://docs.claude-mem.ai/beta-features)** دیکھیں۔ +مستحکم ریلیزز `main` سے شپ ہوتی ہیں اور npm پر شائع کی جاتی ہیں۔ `core-dev` اور +`community-edge` ابتدائی اعتماد کی اصلاحات اور کمیونٹی انٹیگریشنز کے لیے سورس سے چلائی جانے والی برانچز ہیں۔ برانچ کے بہاؤ اور غیر مستحکم رن ہدایات کے لیے **[ریلیز برانچز](https://docs.claude-mem.ai/branches)** +دیکھیں۔ --- @@ -231,19 +290,69 @@ Endless Mode اور اسے کیسے آزمائیں اس کے بارے میں ت - **uv**: ویکٹر تلاش کے لیے Python پیکج مینیجر (غیر موجود ہو تو خودکار طور پر انسٹال ہوگا) - **SQLite 3**: مستقل اسٹوریج کے لیے (بنڈل شدہ) +--- +### Windows سیٹ اپ نوٹس + +اگر آپ کو ایسی خرابی نظر آئے: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +یقینی بنائیں کہ Node.js اور npm انسٹال ہیں اور آپ کے PATH میں شامل ہیں۔ https://nodejs.org سے جدید ترین Node.js انسٹالر ڈاؤن لوڈ کریں اور انسٹالیشن کے بعد اپنا ٹرمینل دوبارہ شروع کریں۔ + --- ## ترتیبات -سیٹنگز `~/.claude-mem/settings.json` میں منظم ہیں (پہلی رن میں ڈیفالٹ کے ساتھ خودکار طور پر بنائی جاتی ہے)۔ AI ماڈل، ورکر پورٹ، ڈیٹا ڈائریکٹری، لاگ لیول اور تناسب انجیکشن سیٹنگز کو ترتیب دیں۔ +سیٹنگز `~/.claude-mem/settings.json` میں منظم کی جاتی ہیں (پہلی رن پر ڈیفالٹس کے ساتھ خودکار طور پر بنائی جاتی ہیں)۔ AI ماڈل، ورکر پورٹ، ڈیٹا ڈائریکٹری، لاگ لیول، اور تناسب انجیکشن سیٹنگز کو ترتیب دیں۔ تمام دستیاب سیٹنگز اور مثالوں کے لیے **[ترتیبات گائیڈ](https://docs.claude-mem.ai/configuration)** دیکھیں۔ +### موڈ اور زبان کی ترتیب + +Claude-Mem `CLAUDE_MEM_MODE` سیٹنگ کے ذریعے متعدد ورک فلو موڈز اور زبانوں کی حمایت کرتا ہے۔ + +یہ آپشن دونوں کو کنٹرول کرتا ہے: +- ورک فلو کا رویہ (مثلاً code، chill، investigation) +- تیار کردہ مشاہدات میں استعمال ہونے والی زبان + +#### ترتیب کیسے دیں + +اپنی سیٹنگز فائل `~/.claude-mem/settings.json` میں ترمیم کریں: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +موڈز `plugin/modes/` میں متعین کیے گئے ہیں۔ تمام دستیاب موڈز لوکل طور پر دیکھنے کے لیے: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### دستیاب موڈز + +| موڈ | تفصیل | +|------------|-------------------------| +| `code` | ڈیفالٹ انگریزی موڈ | +| `code--zh` | آسان چینی موڈ | +| `code--ja` | جاپانی موڈ | + +زبان کے مخصوص موڈز پیٹرن `code--[lang]` کی پیروی کرتے ہیں جہاں `[lang]` ISO 639-1 زبان کا کوڈ ہے (مثلاً، چینی کے لیے `zh`، جاپانی کے لیے `ja`، ہسپانوی کے لیے `es`)۔ + +> نوٹ: `code--zh` (آسان چینی) پہلے سے ہی بلٹ-اِن ہے — کسی اضافی انسٹالیشن یا پلگ ان اپڈیٹ کی ضرورت نہیں ہے۔ + +#### موڈ تبدیل کرنے کے بعد + +نئی موڈ کنفیگریشن لاگو کرنے کے لیے Claude Code کو دوبارہ شروع کریں۔ --- ## ترقی -تعمیر کی ہدایات، جانچ اور حصہ داری کے کام کے بہاؤ کے لیے **[ترقی گائیڈ](https://docs.claude-mem.ai/development)** دیکھیں۔ +تعمیر کی ہدایات، جانچ، اور حصہ داری کے کام کے بہاؤ کے لیے **[ترقی گائیڈ](https://docs.claude-mem.ai/development)** دیکھیں۔ --- @@ -274,34 +383,47 @@ npm run bug-report 4. دستاویزات کو اپڈیٹ کریں 5. ایک Pull Request جمع کریں +Claude-Mem تین برانچز سے شپ ہوتا ہے: `main` (مستحکم)، `core-dev`، اور +`community-edge`۔ صرف `main` ہی npm پر شائع کیا جاتا ہے؛ باقی سورس سے +چلائی جاتی ہیں۔ حکمت عملی اور لوکل رن ہدایات کے لیے [ریلیز برانچز](https://docs.claude-mem.ai/branches) دیکھیں۔ + حصہ داری کے کام کے بہاؤ کے لیے [ترقی گائیڈ](https://docs.claude-mem.ai/development) دیکھیں۔ --- -## License +## لائسنس -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem کو Apache License 2.0 کے تحت لائسنس دیا گیا ہے۔ -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +ہم نے Apache-2.0 کا انتخاب کیا کیونکہ دیرپا ایجنٹک میموری کو ڈویلپر ٹولز، لوکل ایجنٹس، +MCP سرورز، انٹرپرائز نظاموں، روبوٹکس اسٹیکس، اور پروڈکشن ایجنٹ ہارنسز میں +شامل کرنا آسان ہونا چاہیے۔ -See the [LICENSE](LICENSE) file for full details. +مکمل تفصیلات کے لیے [LICENSE](LICENSE) فائل دیکھیں۔ لائسنسنگ کے دائرہ کار اور +اوپن/کمرشل باؤنڈری کے لیے [docs/license.md](docs/license.md) +اور [docs/ip-boundary.md](docs/ip-boundary.md) دیکھیں۔ -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Ragtime پر نوٹ**: `ragtime/` ڈائریکٹری کو **Apache License 2.0** کے تحت لائسنس دیا گیا ہے۔ تفصیلات کے لیے [ragtime/LICENSE](ragtime/LICENSE) دیکھیں۔ --- - ## معاونت - **دستاویزات**: [docs/](docs/) - **مسائل**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **رپوزیٹری**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **سرکاری X اکاؤنٹ**: [@Claude_Memory](https://x.com/Claude_Memory) +- **سرکاری Discord**: [Discord میں شامل ہوں](https://discord.com/invite/J4wttp9vDu) - **مصنف**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- **Claude Agent SDK کے ساتھ بنایا گیا** | **Claude Code کے ذریعے طاقت ور** | **TypeScript کے ساتھ بنایا گیا** -
+--- + +### CMEM کے بارے میں کیا خیال ہے؟ + +CMEM ایک ٹوکن ہے جو ایک تھرڈ پارٹی کی جانب سے بنایا گیا ہے لیکن Claude-Mem کے تخلیق کار (Alex Newman، @thedotmack) کی جانب سے سرکاری طور پر قبول کیا گیا ہے۔ یہ ٹوکن ترقی کے لیے ایک کمیونٹی محرک اور CMEM کو ان ڈویلپرز اور نالج ورکرز تک پہنچانے کا ایک ذریعہ ہے جنہیں اس کی سب سے زیادہ ضرورت ہے۔ + +سرکاری BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.vi.md b/docs/i18n/README.vi.md index 7854c85e6..e1c6177b3 100644 --- a/docs/i18n/README.vi.md +++ b/docs/i18n/README.vi.md @@ -1,6 +1,5 @@ 🌐 Đây là bản dịch tự động. Chúng tôi hoan nghênh các đóng góp từ cộng đồng! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

Hệ thống nén bộ nhớ liên tục được xây dựng cho Claude Code.

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

Bắt Đầu Nhanh • @@ -101,28 +132,57 @@ ## Bắt Đầu Nhanh -Bắt đầu một phiên Claude Code mới trong terminal và nhập các lệnh sau: +Cài đặt chỉ với một lệnh duy nhất: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +Hoặc cài đặt cho OpenCode: + +```bash +npx claude-mem install --ide opencode +``` + +Hoặc cài đặt cho Antigravity CLI ([hướng dẫn cài đặt](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +Hoặc cài đặt từ chợ plugin ngay trong Claude Code: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` Khởi động lại Claude Code. Ngữ cảnh từ các phiên trước sẽ tự động xuất hiện trong các phiên mới. +> **Lưu ý:** Claude-Mem cũng được phát hành trên npm, nhưng `npm install -g claude-mem` chỉ cài đặt **SDK/thư viện** — nó không đăng ký các hook của plugin hay thiết lập dịch vụ worker. Hãy luôn cài đặt qua `npx claude-mem install` hoặc các lệnh `/plugin` ở trên. + +### 🦞 OpenClaw Gateway + +Cài đặt claude-mem như một plugin bộ nhớ liên tục trên các gateway [OpenClaw](https://openclaw.ai) chỉ với một lệnh duy nhất: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +Trình cài đặt xử lý các phần phụ thuộc, thiết lập plugin, cấu hình nhà cung cấp AI, khởi động worker, và tùy chọn gửi luồng quan sát thời gian thực đến Telegram, Discord, Slack, và nhiều hơn nữa. Xem [Hướng Dẫn Tích Hợp OpenClaw](https://docs.claude-mem.ai/openclaw-integration) để biết chi tiết. + **Tính Năng Chính:** - 🧠 **Bộ Nhớ Liên Tục** - Ngữ cảnh được lưu giữ qua các phiên làm việc - 📊 **Tiết Lộ Tuần Tự** - Truy xuất bộ nhớ theo lớp với khả năng hiển thị chi phí token - 🔍 **Tìm Kiếm Theo Kỹ Năng** - Truy vấn lịch sử dự án với kỹ năng mem-search -- 🖥️ **Giao Diện Web Viewer** - Luồng bộ nhớ thời gian thực tại http://localhost:37777 +- 🖥️ **Giao Diện Web Viewer** - Luồng bộ nhớ thời gian thực tại URL worker được in ra khi khởi động - 💻 **Kỹ Năng Claude Desktop** - Tìm kiếm bộ nhớ từ các cuộc trò chuyện Claude Desktop - 🔒 **Kiểm Soát Quyền Riêng Tư** - Sử dụng thẻ `` để loại trừ nội dung nhạy cảm khỏi lưu trữ - ⚙️ **Cấu Hình Ngữ Cảnh** - Kiểm soát chi tiết về ngữ cảnh được chèn vào - 🤖 **Hoạt Động Tự Động** - Không cần can thiệp thủ công -- 🔗 **Trích Dẫn** - Tham chiếu các quan sát trong quá khứ với ID (truy cập qua http://localhost:37777/api/observation/{id} hoặc xem tất cả trong web viewer tại http://localhost:37777) -- 🧪 **Kênh Beta** - Dùng thử các tính năng thử nghiệm như Endless Mode thông qua chuyển đổi phiên bản +- 🔗 **Trích Dẫn** - Tham chiếu các quan sát trong quá khứ với ID thông qua API worker hoặc xem tất cả trong web viewer --- @@ -135,7 +195,6 @@ Khởi động lại Claude Code. Ngữ cảnh từ các phiên trước sẽ t - **[Hướng Dẫn Cài Đặt](https://docs.claude-mem.ai/installation)** - Bắt đầu nhanh & cài đặt nâng cao - **[Hướng Dẫn Sử Dụng](https://docs.claude-mem.ai/usage/getting-started)** - Cách Claude-Mem hoạt động tự động - **[Công Cụ Tìm Kiếm](https://docs.claude-mem.ai/usage/search-tools)** - Truy vấn lịch sử dự án bằng ngôn ngữ tự nhiên -- **[Tính Năng Beta](https://docs.claude-mem.ai/beta-features)** - Dùng thử các tính năng thử nghiệm như Endless Mode ### Thực Hành Tốt Nhất @@ -156,6 +215,7 @@ Khởi động lại Claude Code. Ngữ cảnh từ các phiên trước sẽ t - **[Cấu Hình](https://docs.claude-mem.ai/configuration)** - Biến môi trường & cài đặt - **[Phát Triển](https://docs.claude-mem.ai/development)** - Xây dựng, kiểm thử, đóng góp +- **[Nhánh Phát Hành](https://docs.claude-mem.ai/branches)** - Luồng các nhánh stable, core-dev, và community-edge - **[Khắc Phục Sự Cố](https://docs.claude-mem.ai/troubleshooting)** - Các vấn đề thường gặp & giải pháp --- @@ -166,7 +226,7 @@ Khởi động lại Claude Code. Ngữ cảnh từ các phiên trước sẽ t 1. **5 Lifecycle Hooks** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook scripts) 2. **Smart Install** - Công cụ kiểm tra phụ thuộc được cache (pre-hook script, không phải lifecycle hook) -3. **Worker Service** - HTTP API trên cổng 37777 với giao diện web viewer và 10 điểm cuối tìm kiếm, được quản lý bởi Bun +3. **Worker Service** - HTTP API cục bộ với giao diện web viewer và các điểm cuối tìm kiếm, được quản lý bởi Bun 4. **SQLite Database** - Lưu trữ các phiên, quan sát, tóm tắt 5. **mem-search Skill** - Truy vấn ngôn ngữ tự nhiên với tiết lộ tuần tự 6. **Chroma Vector Database** - Tìm kiếm kết hợp ngữ nghĩa + từ khóa để truy xuất ngữ cảnh thông minh @@ -175,46 +235,51 @@ Xem [Tổng Quan Kiến Trúc](https://docs.claude-mem.ai/architecture/overview) --- -## mem-search Skill +## Công Cụ Tìm Kiếm MCP -Claude-Mem cung cấp tìm kiếm thông minh thông qua kỹ năng mem-search tự động kích hoạt khi bạn hỏi về công việc trước đây: +Claude-Mem cung cấp tìm kiếm bộ nhớ thông minh thông qua **4 công cụ MCP** theo một **mô hình quy trình 3 lớp** tối ưu về token: + +**Quy Trình 3 Lớp:** + +1. **`search`** - Lấy chỉ mục gọn nhẹ kèm ID (~50-100 token/kết quả) +2. **`timeline`** - Lấy ngữ cảnh theo trình tự thời gian xung quanh các kết quả đáng chú ý +3. **`get_observations`** - Chỉ lấy thông tin chi tiết đầy đủ cho các ID đã lọc (~500-1.000 token/kết quả) **Cách Hoạt Động:** -- Chỉ cần hỏi một cách tự nhiên: *"Chúng ta đã làm gì trong phiên trước?"* hoặc *"Chúng ta đã sửa lỗi này trước đây chưa?"* -- Claude tự động gọi kỹ năng mem-search để tìm ngữ cảnh liên quan +- Claude sử dụng các công cụ MCP để tìm kiếm bộ nhớ của bạn +- Bắt đầu với `search` để lấy chỉ mục kết quả +- Sử dụng `timeline` để xem những gì đã xảy ra xung quanh các quan sát cụ thể +- Sử dụng `get_observations` để lấy thông tin chi tiết đầy đủ cho các ID liên quan +- **Tiết kiệm ~10 lần số token** bằng cách lọc trước khi lấy chi tiết -**Các Thao Tác Tìm Kiếm Có Sẵn:** +**Các Công Cụ MCP Có Sẵn:** -1. **Search Observations** - Tìm kiếm toàn văn trên các quan sát -2. **Search Sessions** - Tìm kiếm toàn văn trên các tóm tắt phiên -3. **Search Prompts** - Tìm kiếm các yêu cầu người dùng thô -4. **By Concept** - Tìm theo thẻ khái niệm (discovery, problem-solution, pattern, v.v.) -5. **By File** - Tìm các quan sát tham chiếu đến các tệp cụ thể -6. **By Type** - Tìm theo loại (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Lấy ngữ cảnh phiên gần đây cho một dự án -8. **Timeline** - Lấy dòng thời gian thống nhất của ngữ cảnh xung quanh một thời điểm cụ thể -9. **Timeline by Query** - Tìm kiếm các quan sát và lấy ngữ cảnh dòng thời gian xung quanh kết quả khớp tốt nhất -10. **API Help** - Lấy tài liệu API tìm kiếm +1. **`search`** - Tìm kiếm chỉ mục bộ nhớ với truy vấn toàn văn, lọc theo loại/ngày/dự án +2. **`timeline`** - Lấy ngữ cảnh theo trình tự thời gian xung quanh một quan sát hoặc truy vấn cụ thể +3. **`get_observations`** - Lấy thông tin chi tiết quan sát đầy đủ theo ID (luôn nhóm nhiều ID lại) -**Ví Dụ Truy Vấn Ngôn Ngữ Tự Nhiên:** +**Ví Dụ Sử Dụng:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// Bước 1: Tìm kiếm để lấy chỉ mục +search(query="authentication bug", type="bugfix", limit=10) + +// Bước 2: Xem xét chỉ mục, xác định các ID liên quan (ví dụ: #123, #456) + +// Bước 3: Lấy thông tin chi tiết đầy đủ +get_observations(ids=[123, 456]) ``` Xem [Hướng Dẫn Công Cụ Tìm Kiếm](https://docs.claude-mem.ai/usage/search-tools) để biết các ví dụ chi tiết. --- -## Tính Năng Beta +## Nhánh Phát Hành -Claude-Mem cung cấp **kênh beta** với các tính năng thử nghiệm như **Endless Mode** (kiến trúc bộ nhớ sinh học mô phỏng cho các phiên mở rộng). Chuyển đổi giữa các phiên bản ổn định và beta từ giao diện web viewer tại http://localhost:37777 → Settings. - -Xem **[Tài Liệu Tính Năng Beta](https://docs.claude-mem.ai/beta-features)** để biết chi tiết về Endless Mode và cách dùng thử. +Các bản phát hành ổn định được xây dựng từ `main` và phát hành lên npm. `core-dev` và +`community-edge` là các nhánh chạy trực tiếp từ mã nguồn dành cho các bản sửa lỗi độ tin cậy +sớm và các tích hợp cộng đồng. Xem **[Nhánh Phát Hành](https://docs.claude-mem.ai/branches)** +để biết luồng nhánh và hướng dẫn chạy phiên bản không ổn định. --- @@ -226,6 +291,17 @@ Xem **[Tài Liệu Tính Năng Beta](https://docs.claude-mem.ai/beta-features)** - **uv**: Trình quản lý gói Python cho tìm kiếm vector (tự động cài đặt nếu thiếu) - **SQLite 3**: Cho lưu trữ liên tục (đi kèm) +--- +### Lưu Ý Cài Đặt Trên Windows + +Nếu bạn gặp lỗi như: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +Hãy đảm bảo rằng Node.js và npm đã được cài đặt và thêm vào PATH của bạn. Tải trình cài đặt Node.js mới nhất từ https://nodejs.org và khởi động lại terminal sau khi cài đặt. + --- ## Cấu Hình @@ -234,6 +310,45 @@ Cài đặt được quản lý trong `~/.claude-mem/settings.json` (tự độn Xem **[Hướng Dẫn Cấu Hình](https://docs.claude-mem.ai/configuration)** để biết tất cả các cài đặt và ví dụ có sẵn. +### Cấu Hình Chế Độ & Ngôn Ngữ + +Claude-Mem hỗ trợ nhiều chế độ làm việc và ngôn ngữ thông qua cài đặt `CLAUDE_MEM_MODE`. + +Tùy chọn này kiểm soát cả: +- Hành vi quy trình làm việc (ví dụ: code, chill, investigation) +- Ngôn ngữ được sử dụng trong các quan sát được tạo ra + +#### Cách Cấu Hình + +Chỉnh sửa tệp cài đặt của bạn tại `~/.claude-mem/settings.json`: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +Các chế độ được định nghĩa trong `plugin/modes/`. Để xem tất cả các chế độ có sẵn cục bộ: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### Các Chế Độ Có Sẵn + +| Chế Độ | Mô Tả | +|------------|-------------------------| +| `code` | Chế độ tiếng Anh mặc định | +| `code--zh` | Chế độ tiếng Trung giản thể | +| `code--ja` | Chế độ tiếng Nhật | + +Các chế độ theo ngôn ngữ cụ thể tuân theo mẫu `code--[lang]` trong đó `[lang]` là mã ngôn ngữ ISO 639-1 (ví dụ: `zh` cho tiếng Trung, `ja` cho tiếng Nhật, `es` cho tiếng Tây Ban Nha). + +> Lưu ý: `code--zh` (tiếng Trung giản thể) đã được tích hợp sẵn — không cần cài đặt thêm hay cập nhật plugin. + +#### Sau Khi Thay Đổi Chế Độ + +Khởi động lại Claude Code để áp dụng cấu hình chế độ mới. --- ## Phát Triển @@ -269,32 +384,48 @@ Chúng tôi hoan nghênh các đóng góp! Vui lòng: 4. Cập nhật tài liệu 5. Gửi Pull Request +Claude-Mem được phát hành từ ba nhánh: `main` (ổn định), `core-dev`, và +`community-edge`. Chỉ `main` được phát hành lên npm; các nhánh còn lại được chạy từ +mã nguồn. Xem [Nhánh Phát Hành](https://docs.claude-mem.ai/branches) để biết +chiến lược và hướng dẫn chạy cục bộ. + Xem [Hướng Dẫn Phát Triển](https://docs.claude-mem.ai/development) để biết quy trình đóng góp. --- -## License +## Giấy Phép -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem được cấp phép theo Apache License 2.0. -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +Chúng tôi chọn Apache-2.0 vì bộ nhớ agentic bền vững nên dễ dàng được tích hợp vào +các công cụ dành cho nhà phát triển, các agent cục bộ, máy chủ MCP, hệ thống doanh nghiệp, +các nền tảng robot, và các bộ khung agent sản xuất. -See the [LICENSE](LICENSE) file for full details. +Xem tệp [LICENSE](LICENSE) để biết đầy đủ chi tiết. Xem [docs/license.md](docs/license.md) +và [docs/ip-boundary.md](docs/ip-boundary.md) để biết phạm vi cấp phép và ranh giới +mở/thương mại. -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**Lưu ý về Ragtime**: Thư mục `ragtime/` được cấp phép theo **Apache License 2.0**. Xem [ragtime/LICENSE](ragtime/LICENSE) để biết chi tiết. --- - ## Hỗ Trợ - **Tài Liệu**: [docs/](docs/) - **Vấn Đề**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **Repository**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **Tài Khoản X Chính Thức**: [@Claude_Memory](https://x.com/Claude_Memory) +- **Discord Chính Thức**: [Tham gia Discord](https://discord.com/invite/J4wttp9vDu) - **Tác Giả**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**Được Xây Dựng với Claude Agent SDK** | **Được Hỗ Trợ bởi Claude Code** | **Được Tạo với TypeScript** \ No newline at end of file +**Được Xây Dựng với Claude Agent SDK** | **Hoạt Động cùng Claude Code** | **Được Tạo với TypeScript** + +--- + +### Còn CMEM Thì Sao? + +CMEM là một token được tạo ra bởi bên thứ ba nhưng được đón nhận chính thức bởi người sáng tạo ra Claude-Mem (Alex Newman, @thedotmack). Token này đóng vai trò là chất xúc tác cộng đồng cho sự phát triển và là phương tiện đưa CMEM đến với các nhà phát triển và người lao động tri thức cần nó nhất. + +Official BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.zh-tw.md b/docs/i18n/README.zh-tw.md index 9b43719d9..4e38abcda 100644 --- a/docs/i18n/README.zh-tw.md +++ b/docs/i18n/README.zh-tw.md @@ -1,6 +1,5 @@ 🌐 這是自動翻譯。歡迎社群貢獻修正！ ----


@@ -11,45 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

-

為 Claude Code 打造的持久記憶壓縮系統

+

為 Claude Code 打造的持久記憶壓縮系統。

- License + License Version @@ -74,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

快速開始 • @@ -100,41 +132,69 @@ ## 快速開始 -在終端機中開啟新的 Claude Code 工作階段，並輸入以下指令： +使用單一指令安裝： +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +或為 OpenCode 安裝： + +```bash +npx claude-mem install --ide opencode +``` + +或為 Antigravity CLI 安裝（[設定指南](https://docs.claude-mem.ai/antigravity-cli/setup)）： + +```bash +npx claude-mem install --ide antigravity +``` + +或在 Claude Code 內從外掛市集安裝： + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` 重新啟動 Claude Code。先前工作階段的脈絡將自動出現在新的工作階段中。 +> **注意：** Claude-Mem 也發布於 npm，但 `npm install -g claude-mem` 僅安裝 **SDK/函式庫**——它不會註冊外掛掛鉤或設定 Worker 服務。請務必透過 `npx claude-mem install` 或上述 `/plugin` 指令安裝。 + +### 🦞 OpenClaw Gateway + +只需一個指令，即可在 [OpenClaw](https://openclaw.ai) 閘道上安裝 claude-mem 作為持久記憶外掛： + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +安裝程式會處理相依性、外掛設定、AI 提供者設定、Worker 啟動，以及選用的即時觀察推播至 Telegram、Discord、Slack 等平台。詳情請參閱 [OpenClaw 整合指南](https://docs.claude-mem.ai/openclaw-integration)。 + **主要功能：** - 🧠 **持久記憶** - 脈絡跨工作階段保留 - 📊 **漸進式揭露** - 具有 Token 成本可見性的分層記憶擷取 - 🔍 **技能式搜尋** - 使用 mem-search 技能查詢專案歷史 -- 🖥️ **網頁檢視介面** - 在 http://localhost:37777 即時檢視記憶串流 +- 🖥️ **網頁檢視介面** - 在啟動時顯示的 Worker URL 即時檢視記憶串流 - 💻 **Claude Desktop 技能** - 從 Claude Desktop 對話中搜尋記憶 - 🔒 **隱私控制** - 使用 `` 標籤排除敏感內容的儲存 - ⚙️ **脈絡設定** - 精細控制注入哪些脈絡 - 🤖 **自動運作** - 無需手動介入 -- 🔗 **引用** - 使用 ID 參考過去的觀察（透過 http://localhost:37777/api/observation/{id} 存取，或在 http://localhost:37777 的網頁檢視器中檢視全部） -- 🧪 **Beta 通道** - 透過版本切換試用 Endless Mode 等實驗性功能 +- 🔗 **引用** - 透過 Worker API 使用 ID 參考過去的觀察，或在網頁檢視器中檢視全部 --- ## 文件 -📚 **[檢視完整文件](docs/)** - 在 GitHub 上瀏覽 Markdown 文件 +📚 **[檢視完整文件](https://docs.claude-mem.ai/)** - 於官方網站瀏覽 ### 入門指南 - **[安裝指南](https://docs.claude-mem.ai/installation)** - 快速開始與進階安裝 - **[使用指南](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem 如何自動運作 - **[搜尋工具](https://docs.claude-mem.ai/usage/search-tools)** - 使用自然語言查詢專案歷史 -- **[Beta 功能](https://docs.claude-mem.ai/beta-features)** - 試用 Endless Mode 等實驗性功能 ### 最佳實務 @@ -155,6 +215,7 @@ - **[設定](https://docs.claude-mem.ai/configuration)** - 環境變數與設定 - **[開發](https://docs.claude-mem.ai/development)** - 建置、測試、貢獻 +- **[發布分支](https://docs.claude-mem.ai/branches)** - Stable、core-dev 與 community-edge 分支流程 - **[疑難排解](https://docs.claude-mem.ai/troubleshooting)** - 常見問題與解決方案 --- @@ -165,7 +226,7 @@ 1. **5 個生命週期掛鉤** - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd（6 個掛鉤腳本） 2. **智慧安裝** - 快取的相依性檢查器（pre-hook 腳本，非生命週期掛鉤） -3. **Worker 服務** - 連接埠 37777 上的 HTTP API，含網頁檢視介面與 10 個搜尋端點，由 Bun 管理 +3. **Worker 服務** - 具備網頁檢視介面與搜尋端點的本機 HTTP API，由 Bun 管理 4. **SQLite 資料庫** - 儲存工作階段、觀察、摘要 5. **mem-search 技能** - 具有漸進式揭露的自然語言查詢 6. **Chroma 向量資料庫** - 用於智慧脈絡擷取的混合語意 + 關鍵字搜尋 @@ -185,7 +246,6 @@ Claude-Mem 透過遵循 Token 高效的 **3 層工作流程模式**，以 **4 3. **`get_observations`** - 僅為過濾後的 ID 擷取完整詳情（每筆結果約 500-1,000 tokens） **運作方式：** - - Claude 使用 MCP 工具搜尋您的記憶 - 從 `search` 開始取得結果索引 - 使用 `timeline` 檢視特定觀察周圍發生的事情 @@ -196,18 +256,17 @@ Claude-Mem 透過遵循 Token 高效的 **3 層工作流程模式**，以 **4 1. **`search`** - 使用全文查詢搜尋記憶索引，依類型/日期/專案過濾 2. **`timeline`** - 取得特定觀察或查詢周圍的時間脈絡 -3. **`get_observations`** - 依 ID 擷取完整觀察詳情（批次處理多個 ID） -4. **`__IMPORTANT`** - 工作流程文件（Claude 永遠可見） +3. **`get_observations`** - 依 ID 擷取完整觀察詳情（務必批次處理多個 ID） **使用範例：** ```typescript -// 步驟 1：搜尋索引 +// Step 1: Search for index search(query="authentication bug", type="bugfix", limit=10) -// 步驟 2：檢閱索引，識別相關 ID（例如 #123、#456） +// Step 2: Review index, identify relevant IDs (e.g., #123, #456) -// 步驟 3：擷取完整詳情 +// Step 3: Fetch full details get_observations(ids=[123, 456]) ``` @@ -215,11 +274,11 @@ get_observations(ids=[123, 456]) --- -## Beta 功能 +## 發布分支 -Claude-Mem 提供具有實驗性功能的 **Beta 通道**，例如 **Endless Mode**（用於延長工作階段的仿生記憶架構）。在 http://localhost:37777 → Settings 的網頁檢視介面中切換穩定版與 Beta 版。 - -有關 Endless Mode 與如何試用的詳情，請參閱 **[Beta 功能文件](https://docs.claude-mem.ai/beta-features)**。 +穩定版發布來自 `main` 分支並發布至 npm。`core-dev` 與 +`community-edge` 是用於早期可靠性修復與社群整合的原始碼執行分支。分支流程與非穩定版執行說明請參閱 +**[發布分支](https://docs.claude-mem.ai/branches)**。 --- @@ -231,6 +290,17 @@ Claude-Mem 提供具有實驗性功能的 **Beta 通道**，例如 **Endless Mod - **uv**：用於向量搜尋的 Python 套件管理員（如缺少將自動安裝） - **SQLite 3**：用於持久儲存（已內建） +--- +### Windows 設定注意事項 + +若您看到如下錯誤訊息： + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +請確認 Node.js 和 npm 已安裝並加入您的 PATH。請從 https://nodejs.org 下載最新版 Node.js 安裝程式，並在安裝後重新啟動終端機。 + --- ## 設定 @@ -239,6 +309,45 @@ Claude-Mem 提供具有實驗性功能的 **Beta 通道**，例如 **Endless Mod 所有可用設定與範例請參閱 **[設定指南](https://docs.claude-mem.ai/configuration)**。 +### 模式與語言設定 + +Claude-Mem 透過 `CLAUDE_MEM_MODE` 設定支援多種工作流程模式與語言。 + +此選項控制以下兩者： +- 工作流程行為（例如 code、chill、investigation） +- 產生觀察時使用的語言 + +#### 如何設定 + +編輯您位於 `~/.claude-mem/settings.json` 的設定檔： + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +模式定義於 `plugin/modes/` 中。若要在本機檢視所有可用模式： + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### 可用模式 + +| 模式 | 說明 | +|------------|-------------------------| +| `code` | 預設英文模式 | +| `code--zh` | 簡體中文模式 | +| `code--ja` | 日文模式 | + +特定語言模式遵循 `code--[lang]` 的模式，其中 `[lang]` 為 ISO 639-1 語言代碼（例如中文為 `zh`、日文為 `ja`、西班牙文為 `es`）。 + +> 注意：`code--zh`（簡體中文）已內建——無需額外安裝或更新外掛。 + +#### 變更模式後 + +重新啟動 Claude Code 以套用新的模式設定。 --- ## 開發 @@ -274,25 +383,29 @@ npm run bug-report 4. 更新文件 5. 提交 Pull Request +Claude-Mem 從三個分支發布：`main`（穩定版）、`core-dev` 與 +`community-edge`。僅 `main` 會發布至 npm；其他分支則從原始碼執行。策略與本機執行說明請參閱 +[發布分支](https://docs.claude-mem.ai/branches)。 + 貢獻工作流程請參閱[開發指南](https://docs.claude-mem.ai/development)。 --- -## License +## 授權條款 -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem 採用 Apache License 2.0 授權。 -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +我們選擇 Apache-2.0 是因為持久的代理記憶應該易於嵌入至 +開發工具、本機代理、MCP 伺服器、企業系統、機器人技術堆疊， +以及生產環境代理框架中。 -See the [LICENSE](LICENSE) file for full details. +完整詳情請參閱 [LICENSE](LICENSE) 檔案。授權範圍與開源／商業界線 +請參閱 [docs/license.md](docs/license.md) 與 [docs/ip-boundary.md](docs/ip-boundary.md)。 -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**關於 Ragtime 的說明**：`ragtime/` 目錄採用 **Apache License 2.0** 授權。詳情請參閱 [ragtime/LICENSE](ragtime/LICENSE)。 --- - ## 支援 - **文件**：[docs/](docs/) @@ -305,3 +418,11 @@ Apache-2.0 allows broad use, modification, distribution, and commercial use, sub --- **使用 Claude Agent SDK 建置** | **由 Claude Code 驅動** | **以 TypeScript 開發** + +--- + +### CMEM 是什麼？ + +CMEM 是由第三方創建的代幣，但獲得 Claude-Mem 創作者（Alex Newman，@thedotmack）的正式支持。該代幣作為社群成長的催化劑，也是將 CMEM 帶給最需要它的開發者與知識工作者的媒介。 + +官方 BASE 合約地址：0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/README.zh.md b/docs/i18n/README.zh.md index 61d967fce..03b153d0a 100644 --- a/docs/i18n/README.zh.md +++ b/docs/i18n/README.zh.md @@ -1,6 +1,5 @@ 🌐 这是自动翻译。欢迎社区修正! ----


@@ -11,46 +10,51 @@
+ + Vercel OSS Program +

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇧🇷 Português • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk + 🇨🇳 中文 • + 🇹🇼 繁體中文 • + 🇯🇵 日本語 • + 🇵🇹 Português • + 🇧🇷 Português • + 🇰🇷 한국어 • + 🇪🇸 Español • + 🇩🇪 Deutsch • + 🇫🇷 Français • + 🇮🇱 עברית • + 🇸🇦 العربية • + 🇷🇺 Русский • + 🇵🇱 Polski • + 🇨🇿 Čeština • + 🇳🇱 Nederlands • + 🇹🇷 Türkçe • + 🇺🇦 Українська • + 🇻🇳 Tiếng Việt • + 🇵🇭 Tagalog • + 🇮🇩 Indonesia • + 🇹🇭 ไทย • + 🇮🇳 हिन्दी • + 🇧🇩 বাংলা • + 🇵🇰 اردو • + 🇷🇴 Română • + 🇸🇪 Svenska • + 🇮🇹 Italiano • + 🇬🇷 Ελληνικά • + 🇭🇺 Magyar • + 🇫🇮 Suomi • + 🇩🇰 Dansk • + 🇳🇴 Norsk

为 Claude Code 构建的持久化内存压缩系统。

- License + License Version @@ -75,13 +79,40 @@
-

- - - Claude-Mem Preview - - -

+ + + + + +
+ + + Claude-Mem Preview + + + + + + + + Star History Chart + + +

快速开始 • @@ -94,35 +125,64 @@

- Claude-Mem 通过自动捕获工具使用观察、生成语义摘要并使其可用于未来会话,无缝保留跨会话的上下文。这使 Claude 能够在会话结束或重新连接后仍保持对项目的知识连续性。 + Claude-Mem 通过自动捕获工具使用观察、生成语义摘要并使其可用于未来会话,无缝保留跨会话的上下文。这使 Claude 能够在会话结束或重新连接后,依然保持对项目知识的连续性。

--- ## 快速开始 -在终端中启动新的 Claude Code 会话并输入以下命令: +使用一条命令即可安装: +```bash +npx claude-mem install ``` -> /plugin marketplace add thedotmack/claude-mem -> /plugin install claude-mem +或为 OpenCode 安装: + +```bash +npx claude-mem install --ide opencode +``` + +或为 Antigravity CLI 安装([设置指南](https://docs.claude-mem.ai/antigravity-cli/setup)): + +```bash +npx claude-mem install --ide antigravity +``` + +或在 Claude Code 内部从插件市场安装: + +```bash +/plugin marketplace add thedotmack/claude-mem + +/plugin install claude-mem ``` 重启 Claude Code。来自先前会话的上下文将自动出现在新会话中。 +> **注意:** Claude-Mem 也已发布到 npm,但 `npm install -g claude-mem` 仅安装 **SDK/库本身** —— 它不会注册插件钩子,也不会设置 worker 服务。请始终通过 `npx claude-mem install` 或上述 `/plugin` 命令进行安装。 + +### 🦞 OpenClaw Gateway + +只需一条命令,即可在 [OpenClaw](https://openclaw.ai) 网关上将 claude-mem 安装为持久化内存插件: + +```bash +curl -fsSL https://install.cmem.ai/openclaw.sh | bash +``` + +该安装程序会处理依赖项、插件设置、AI 提供商配置、worker 启动,以及可选的向 Telegram、Discord、Slack 等平台的实时观察推送。详情请参阅 [OpenClaw 集成指南](https://docs.claude-mem.ai/openclaw-integration)。 + **核心特性:** - 🧠 **持久化内存** - 上下文跨会话保留 - 📊 **渐进式披露** - 分层内存检索,具有令牌成本可见性 - 🔍 **基于技能的搜索** - 使用 mem-search 技能查询项目历史 -- 🖥️ **Web 查看器界面** - 在 http://localhost:37777 实时查看内存流 +- 🖥️ **Web 查看器界面** - 在启动时打印的 worker URL 上实时查看内存流 - 💻 **Claude Desktop 技能** - 从 Claude Desktop 对话中搜索内存 - 🔒 **隐私控制** - 使用 `` 标签排除敏感内容的存储 - ⚙️ **上下文配置** - 精细控制注入的上下文内容 - 🤖 **自动操作** - 无需手动干预 -- 🔗 **引用** - 使用 ID 引用过去的观察(通过 http://localhost:37777/api/observation/{id} 访问,或在 http://localhost:37777 的 Web 查看器中查看全部) -- 🧪 **测试版渠道** - 通过版本切换尝试实验性功能,如无尽模式 +- 🔗 **引用** - 通过 worker API 使用 ID 引用过去的观察,或在 Web 查看器中查看全部 --- @@ -135,7 +195,6 @@ - **[安装指南](https://docs.claude-mem.ai/installation)** - 快速开始与高级安装 - **[使用指南](https://docs.claude-mem.ai/usage/getting-started)** - Claude-Mem 如何自动工作 - **[搜索工具](https://docs.claude-mem.ai/usage/search-tools)** - 使用自然语言查询项目历史 -- **[测试版功能](https://docs.claude-mem.ai/beta-features)** - 尝试实验性功能,如无尽模式 ### 最佳实践 @@ -156,6 +215,7 @@ - **[配置](https://docs.claude-mem.ai/configuration)** - 环境变量与设置 - **[开发](https://docs.claude-mem.ai/development)** - 构建、测试、贡献 +- **[发布分支](https://docs.claude-mem.ai/branches)** - Stable、core-dev 和 community-edge 分支流程 - **[故障排除](https://docs.claude-mem.ai/troubleshooting)** - 常见问题与解决方案 --- @@ -166,7 +226,7 @@ 1. **5 个生命周期钩子** - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd(6 个钩子脚本) 2. **智能安装** - 缓存依赖检查器(预钩子脚本,不是生命周期钩子) -3. **Worker 服务** - 在端口 37777 上的 HTTP API,带有 Web 查看器界面和 10 个搜索端点,由 Bun 管理 +3. **Worker 服务** - 本地 HTTP API,带有 Web 查看器界面和搜索端点,由 Bun 管理 4. **SQLite 数据库** - 存储会话、观察、摘要 5. **mem-search 技能** - 具有渐进式披露的自然语言查询 6. **Chroma 向量数据库** - 混合语义 + 关键词搜索,实现智能上下文检索 @@ -175,46 +235,50 @@ --- -## mem-search 技能 +## MCP 搜索工具 -Claude-Mem 通过 mem-search 技能提供智能搜索,当您询问过去的工作时会自动调用: +Claude-Mem 通过 **4 个 MCP 工具**提供智能内存搜索,遵循一种省令牌的**三层工作流模式**: + +**三层工作流:** + +1. **`search`** - 获取带有 ID 的紧凑索引(约 50-100 个令牌/结果) +2. **`timeline`** - 获取感兴趣结果周围的时间顺序上下文 +3. **`get_observations`** - 仅为筛选出的 ID 获取完整详情(约 500-1,000 个令牌/结果) **工作方式:** -- 只需自然提问:*"上次会话我们做了什么?"* 或 *"我们之前修复过这个 bug 吗?"* -- Claude 自动调用 mem-search 技能查找相关上下文 +- Claude 使用 MCP 工具搜索您的内存 +- 首先使用 `search` 获取结果索引 +- 使用 `timeline` 查看特定观察周围发生的情况 +- 使用 `get_observations` 为相关 ID 获取完整详情 +- 通过在获取详情前进行筛选,**节省约 10 倍的令牌** -**可用搜索操作:** +**可用的 MCP 工具:** -1. **搜索观察** - 跨观察的全文搜索 -2. **搜索会话** - 跨会话摘要的全文搜索 -3. **搜索提示** - 搜索原始用户请求 -4. **按概念搜索** - 按概念标签查找(发现、问题-解决方案、模式等) -5. **按文件搜索** - 查找引用特定文件的观察 -6. **按类型搜索** - 按类型查找(决策、bug修复、功能、重构、发现、更改) -7. **最近上下文** - 获取项目的最近会话上下文 -8. **时间线** - 获取特定时间点周围的统一上下文时间线 -9. **按查询的时间线** - 搜索观察并获取最佳匹配周围的时间线上下文 -10. **API 帮助** - 获取搜索 API 文档 +1. **`search`** - 使用全文查询搜索内存索引,按类型/日期/项目筛选 +2. **`timeline`** - 获取特定观察或查询周围的时间顺序上下文 +3. **`get_observations`** - 按 ID 获取完整观察详情(始终批量处理多个 ID) -**自然语言查询示例:** +**使用示例:** -``` -"What bugs did we fix last session?" -"How did we implement authentication?" -"What changes were made to worker-service.ts?" -"Show me recent work on this project" -"What was happening when we added the viewer UI?" +```typescript +// 步骤 1:搜索索引 +search(query="authentication bug", type="bugfix", limit=10) + +// 步骤 2:查看索引,识别相关 ID(例如 #123、#456) + +// 步骤 3:获取完整详情 +get_observations(ids=[123, 456]) ``` 详见[搜索工具指南](https://docs.claude-mem.ai/usage/search-tools)的详细示例。 --- -## 测试版功能 +## 发布分支 -Claude-Mem 提供**测试版渠道**,包含实验性功能,如**无尽模式**(用于扩展会话的仿生记忆架构)。从 Web 查看器界面 http://localhost:37777 → 设置 切换稳定版和测试版。 - -详见 **[测试版功能文档](https://docs.claude-mem.ai/beta-features)** 了解无尽模式的详细信息和试用方法。 +稳定版发布自 `main` 分支,并发布到 npm。`core-dev` 和 +`community-edge` 是用于早期可靠性修复和社区集成的源码运行分支。请参阅 +**[发布分支](https://docs.claude-mem.ai/branches)** 了解分支流程和非稳定版运行说明。 --- @@ -226,6 +290,17 @@ Claude-Mem 提供**测试版渠道**,包含实验性功能,如**无尽模式**( - **uv**: 用于向量搜索的 Python 包管理器(如缺失会自动安装) - **SQLite 3**: 用于持久化存储(已内置) +--- +### Windows 设置说明 + +如果您看到类似以下的错误: + +```powershell +npm : The term 'npm' is not recognized as the name of a cmdlet +``` + +请确保 Node.js 和 npm 已安装并已添加到您的 PATH 中。请从 https://nodejs.org 下载最新的 Node.js 安装程序,并在安装后重启终端。 + --- ## 配置 @@ -234,6 +309,45 @@ Claude-Mem 提供**测试版渠道**,包含实验性功能,如**无尽模式**( 详见 **[配置指南](https://docs.claude-mem.ai/configuration)** 了解所有可用设置和示例。 +### 模式与语言配置 + +Claude-Mem 通过 `CLAUDE_MEM_MODE` 设置支持多种工作流模式和语言。 + +此选项同时控制: +- 工作流行为(例如 code、chill、investigation) +- 生成观察时所使用的语言 + +#### 配置方法 + +编辑位于 `~/.claude-mem/settings.json` 的设置文件: + +```json +{ + "CLAUDE_MEM_MODE": "code--zh" +} +``` + +模式定义在 `plugin/modes/` 中。要在本地查看所有可用模式: + +```bash +ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/ +``` + +#### 可用模式 + +| 模式 | 描述 | +|------------|-------------------------| +| `code` | 默认英文模式 | +| `code--zh` | 简体中文模式 | +| `code--ja` | 日文模式 | + +特定语言模式遵循 `code--[lang]` 的模式,其中 `[lang]` 是 ISO 639-1 语言代码(例如中文为 `zh`,日语为 `ja`,西班牙语为 `es`)。 + +> 注意:`code--zh`(简体中文)已内置 —— 无需额外安装或更新插件。 + +#### 更改模式后 + +重启 Claude Code 以应用新的模式配置。 --- ## 开发 @@ -269,34 +383,46 @@ npm run bug-report 4. 更新文档 5. 提交 Pull Request +Claude-Mem 从三个分支发布:`main`(稳定版)、`core-dev` 和 +`community-edge`。只有 `main` 会发布到 npm;其他分支从源码运行。请参阅 +[发布分支](https://docs.claude-mem.ai/branches) 了解相关策略和本地运行说明。 + 详见[开发指南](https://docs.claude-mem.ai/development)了解贡献工作流程。 --- -## License +## 许可证 -This project is licensed under the **Apache License 2.0** (Apache-2.0). +Claude-Mem 根据 Apache License 2.0 授权。 -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. +我们选择 Apache-2.0 是因为持久化的代理内存应该易于嵌入到 +开发者工具、本地代理、MCP 服务器、企业系统、机器人技术栈, +以及生产环境的代理运行框架中。 -See the [LICENSE](LICENSE) file for full details. +完整详情请参阅 [LICENSE](LICENSE) 文件。授权范围及开源/商业边界 +请参阅 [docs/license.md](docs/license.md) 和 [docs/ip-boundary.md](docs/ip-boundary.md)。 -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. +**关于 Ragtime 的说明**:`ragtime/` 目录根据 **Apache License 2.0** 授权。详情请参阅 [ragtime/LICENSE](ragtime/LICENSE)。 --- - ## 支持 - **文档**: [docs/](docs/) - **问题反馈**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) - **仓库**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) +- **官方 X 账号**: [@Claude_Memory](https://x.com/Claude_Memory) +- **官方 Discord**: [加入 Discord](https://discord.com/invite/J4wttp9vDu) - **作者**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) --- -**使用 Claude Agent SDK 构建** | **由 Claude Code 驱动** | **使用 TypeScript 制作** +**使用 Claude Agent SDK 构建** | **兼容 Claude Code** | **使用 TypeScript 制作** --- + +### CMEM 是什么? + +CMEM 是由第三方创建、但获得 Claude-Mem 创建者(Alex Newman,@thedotmack)正式认可的代币。该代币作为社区增长的催化剂,以及将 CMEM 带给最需要它的开发者和知识工作者的载体。 + +官方 BASE 合约地址:0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3 \ No newline at end of file diff --git a/docs/i18n/pt.md b/docs/i18n/pt.md deleted file mode 100644 index 8232be520..000000000 --- a/docs/i18n/pt.md +++ /dev/null @@ -1,301 +0,0 @@ -🌐 Esta é uma tradução manual por mig4ng. Correções da comunidade são bem-vindas! - ---- -

-
- - - - - Claude-Mem - - -
-

- -

- 🇨🇳 中文 • - 🇹🇼 繁體中文 • - 🇯🇵 日本語 • - 🇵🇹 Português • - 🇧🇷 Português (Brasil) • - 🇰🇷 한국어 • - 🇪🇸 Español • - 🇩🇪 Deutsch • - 🇫🇷 Français - 🇮🇱 עברית • - 🇸🇦 العربية • - 🇷🇺 Русский • - 🇵🇱 Polski • - 🇨🇿 Čeština • - 🇳🇱 Nederlands • - 🇹🇷 Türkçe • - 🇺🇦 Українська • - 🇻🇳 Tiếng Việt • - 🇮🇩 Indonesia • - 🇹🇭 ไทย • - 🇮🇳 हिन्दी • - 🇧🇩 বাংলা • - 🇵🇰 اردو • - 🇷🇴 Română • - 🇸🇪 Svenska • - 🇮🇹 Italiano • - 🇬🇷 Ελληνικά • - 🇭🇺 Magyar • - 🇫🇮 Suomi • - 🇩🇰 Dansk • - 🇳🇴 Norsk -

- -

Sistema de compressão de memória persistente construído para Claude Code.

- -

- - License - - - Version - - - Node - - - Mentioned in Awesome Claude Code - -

- -

- - - - - thedotmack/claude-mem | Trendshift - - -

- -
- -

- - - Claude-Mem Preview - - -

- -

- Início Rápido • - Como Funciona • - Ferramentas de Procura • - Documentação • - Configuração • - Solução de Problemas • - Licença -

- -

- Claude-Mem preserva o contexto perfeitamente entre sessões, capturando automaticamente observações de uso de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isso permite que Claude mantenha a continuidade do conhecimento sobre projetos mesmo após o término ou reconexão de sessões. -

- ---- - -## Início Rápido - -Inicie uma nova sessão do Claude Code no terminal e digite os seguintes comandos: - -``` -> /plugin marketplace add thedotmack/claude-mem - -> /plugin install claude-mem -``` - -Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticamente em novas sessões. - -**Principais Recursos:** - -- 🧠 **Memória Persistente** - O contexto sobrevive entre sessões -- 📊 **Divulgação Progressiva** - Recuperação de memória em camadas com visibilidade de custo de tokens -- 🔍 **Procura Baseada em Skill** - Consulte seu histórico de projeto com a skill mem-search -- 🖥️ **Interface Web de Visualização** - Fluxo de memória em tempo real em http://localhost:37777 -- 💻 **Skill para Claude Desktop** - Busque memória em conversas do Claude Desktop -- 🔒 **Controle de Privacidade** - Use tags `` para excluir conteúdo sensível do armazenamento -- ⚙️ **Configuração de Contexto** - Controle refinado sobre qual contexto é injetado -- 🤖 **Operação Automática** - Nenhuma intervenção manual necessária -- 🔗 **Citações** - Referencie observações passadas com IDs (acesse via http://localhost:37777/api/observation/{id} ou visualize todas no visualizador web em http://localhost:37777) -- 🧪 **Canal Beta** - Experimente recursos experimentais como o Endless Mode através da troca de versões - ---- - -## Documentação - -📚 **[Ver Documentação Completa](https://docs.claude-mem.ai/)** - Navegar no site oficial - -### Começando - -- **[Guia de Instalação](https://docs.claude-mem.ai/installation)** - Início rápido e instalação avançada -- **[Guia de Uso](https://docs.claude-mem.ai/usage/getting-started)** - Como Claude-Mem funciona automaticamente -- **[Ferramentas de Procura](https://docs.claude-mem.ai/usage/search-tools)** - Consulte seu histórico de projeto com linguagem natural -- **[Recursos Beta](https://docs.claude-mem.ai/beta-features)** - Experimente recursos experimentais como o Endless Mode - -### Melhores Práticas - -- **[Engenharia de Contexto](https://docs.claude-mem.ai/context-engineering)** - Princípios de otimização de contexto para agentes de IA -- **[Divulgação Progressiva](https://docs.claude-mem.ai/progressive-disclosure)** - Filosofia por trás da estratégia de preparação de contexto do Claude-Mem - -### Arquitetura - -- **[Visão Geral](https://docs.claude-mem.ai/architecture/overview)** - Componentes do sistema e fluxo de dados -- **[Evolução da Arquitetura](https://docs.claude-mem.ai/architecture-evolution)** - A jornada da v3 à v5 -- **[Arquitetura de Hooks](https://docs.claude-mem.ai/hooks-architecture)** - Como Claude-Mem usa hooks de ciclo de vida -- **[Referência de Hooks](https://docs.claude-mem.ai/architecture/hooks)** - 7 scripts de hook explicados -- **[Serviço Worker](https://docs.claude-mem.ai/architecture/worker-service)** - API HTTP e gerenciamento do Bun -- **[Banco de Dados](https://docs.claude-mem.ai/architecture/database)** - Schema SQLite e Procura FTS5 -- **[Arquitetura de Procura](https://docs.claude-mem.ai/architecture/search-architecture)** - Procura híbrida com banco de dados vetorial Chroma - -### Configuração e Desenvolvimento - -- **[Configuração](https://docs.claude-mem.ai/configuration)** - Variáveis de ambiente e configurações -- **[Desenvolvimento](https://docs.claude-mem.ai/development)** - Build, testes e contribuição -- **[Solução de Problemas](https://docs.claude-mem.ai/troubleshooting)** - Problemas comuns e soluções - ---- - -## Como Funciona - -**Componentes Principais:** - -1. **5 Hooks de Ciclo de Vida** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook) -2. **Instalação Inteligente** - Verificador de dependências em cache (script pré-hook, não um hook de ciclo de vida) -3. **Serviço Worker** - API HTTP na porta 37777 com interface de visualização web e 10 endpoints de Procura, gerenciado pelo Bun -4. **Banco de Dados SQLite** - Armazena sessões, observações, resumos -5. **Skill mem-search** - Consultas em linguagem natural com divulgação progressiva -6. **Banco de Dados Vetorial Chroma** - Procura híbrida semântica + palavra-chave para recuperação inteligente de contexto - -Veja [Visão Geral da Arquitetura](https://docs.claude-mem.ai/architecture/overview) para detalhes. - ---- - -## Skill mem-search - -Claude-Mem fornece Procura inteligente através da skill mem-search que se auto-invoca quando você pergunta sobre trabalhos anteriores: - -**Como Funciona:** -- Pergunte naturalmente: *"O que fizemos na última sessão?"* ou *"Já corrigimos esse bug antes?"* -- Claude invoca automaticamente a skill mem-search para encontrar contexto relevante - -**Operações de Procura Disponíveis:** - -1. **Search Observations** - Procura de texto completo em observações -2. **Search Sessions** - Procura de texto completo em resumos de sessão -3. **Search Prompts** - Procura em solicitações brutas do usuário -4. **By Concept** - Encontre por tags de conceito (discovery, problem-solution, pattern, etc.) -5. **By File** - Encontre observações que referenciam arquivos específicos -6. **By Type** - Encontre por tipo (decision, bugfix, feature, refactor, discovery, change) -7. **Recent Context** - Obtenha contexto de sessão recente para um projeto -8. **Timeline** - Obtenha linha do tempo unificada de contexto em torno de um ponto específico no tempo -9. **Timeline by Query** - Busque observações e obtenha contexto de linha do tempo em torno da melhor correspondência -10. **API Help** - Obtenha documentação da API de Procura - -**Exemplos de Consultas em Linguagem Natural:** - -``` -"Quais bugs corrigimos na última sessão?" -"Como implementamos a autenticação?" -"Quais mudanças foram feitas em worker-service.ts?" -"Mostre-me trabalhos recentes neste projeto" -"O que estava acontecendo quando adicionamos a interface de visualização?" -``` - -Veja [Guia de Ferramentas de Procura](https://docs.claude-mem.ai/usage/search-tools) para exemplos detalhados. - ---- - -## Recursos Beta - -Claude-Mem oferece um **canal beta** com recursos experimentais como **Endless Mode** (arquitetura de memória biomimética para sessões estendidas). Alterne entre versões estável e beta pela interface de visualização web em http://localhost:37777 → Settings. - -Veja **[Documentação de Recursos Beta](https://docs.claude-mem.ai/beta-features)** para detalhes sobre o Endless Mode e como experimentá-lo. - ---- - -## Requisitos do Sistema - -- **Node.js**: 20.0.0 ou superior -- **Claude Code**: Versão mais recente com suporte a plugins -- **Bun**: Runtime JavaScript e gerenciador de processos (instalado automaticamente se ausente) -- **uv**: Gerenciador de pacotes Python para Procura vetorial (instalado automaticamente se ausente) -- **SQLite 3**: Para armazenamento persistente (incluído) - ---- - -## Configuração - -As configurações são gerenciadas em `~/.claude-mem/settings.json` (criado automaticamente com valores padrão na primeira execução). Configure modelo de IA, porta do worker, diretório de dados, nível de log e configurações de injeção de contexto. - -Veja o **[Guia de Configuração](https://docs.claude-mem.ai/configuration)** para todas as configurações disponíveis e exemplos. - ---- - -## Desenvolvimento - -Veja o **[Guia de Desenvolvimento](https://docs.claude-mem.ai/development)** para instruções de build, testes e fluxo de contribuição. - ---- - -## Solução de Problemas - -Se você estiver enfrentando problemas, descreva o problema para Claude e a skill troubleshoot diagnosticará automaticamente e fornecerá correções. - -Veja o **[Guia de Solução de Problemas](https://docs.claude-mem.ai/troubleshooting)** para problemas comuns e soluções. - ---- - -## Relatos de Bug - -Crie relatos de bug abrangentes com o gerador automatizado: - -```bash -cd ~/.claude/plugins/marketplaces/thedotmack -npm run bug-report -``` - -## Contribuindo - -Contribuições são bem-vindas! Por favor: - -1. Faça um fork do repositório -2. Crie uma branch de feature -3. Faça suas alterações com testes -4. Atualize a documentação -5. Envie um Pull Request - -Veja [Guia de Desenvolvimento](https://docs.claude-mem.ai/development) para o fluxo de contribuição. - ---- - -## License - -This project is licensed under the **Apache License 2.0** (Apache-2.0). - -Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved. - -See the [LICENSE](LICENSE) file for full details. - -Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms. - -**Ragtime note**: The ragtime/ directory is licensed under the **Apache License 2.0**. See [ragtime/LICENSE](ragtime/LICENSE) for details. - ---- - - -## Suporte - -- **Documentação**: [docs/](docs/) -- **Issues**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) -- **Repositório**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) -- **Autor**: Alex Newman ([@thedotmack](https://github.com/thedotmack)) - ---- - -**Construído com Claude Agent SDK** | **Desenvolvido por Claude Code** | **Feito com TypeScript** | **Editado por mig4ng** diff --git a/docs/public/antigravity-cli/setup.mdx b/docs/public/antigravity-cli/setup.mdx index d4fa62fa9..f33618ce3 100644 --- a/docs/public/antigravity-cli/setup.mdx +++ b/docs/public/antigravity-cli/setup.mdx @@ -110,7 +110,7 @@ cat ~/.gemini/antigravity/mcp_config.json | grep claude-mem cat ~/.gemini/config/mcp_config.json | grep claude-mem ``` -Open http://localhost:37777 to see the memory viewer. +Open the worker URL printed on startup to see the memory viewer. ### Step 4: Start using Antigravity CLI @@ -184,7 +184,7 @@ npx claude-mem restart ### No context appearing at session start -1. Ensure the worker is running (check http://localhost:37777) +1. Ensure the worker is running (`npm run worker:status`) 2. You need at least one previous session with observations for context to appear 3. Check your AI provider is configured in `~/.claude-mem/settings.json` diff --git a/docs/public/architecture/hooks.mdx b/docs/public/architecture/hooks.mdx index b2258d593..aa69c8051 100644 --- a/docs/public/architecture/hooks.mdx +++ b/docs/public/architecture/hooks.mdx @@ -32,7 +32,7 @@ graph TB HOOKS --> HOOK_HANDLERS end - HOOK_HANDLERS -->|"HTTP
(fire-and-forget
2s timeout)"| HTTP[Worker HTTP API
Port 37777] + HOOK_HANDLERS -->|"HTTP
(fire-and-forget
2s timeout)"| HTTP[Worker HTTP API
Configured port] subgraph WORKER["Worker Process (separate Node.js)"] direction TB @@ -111,13 +111,16 @@ graph LR **Implementation Examples:** ```typescript +const workerPort = process.env.CLAUDE_MEM_WORKER_PORT ?? "" +const workerBaseUrl = `http://127.0.0.1:${workerPort}` + // VS Code Extension - SessionStart Hook export async function activate(context: vscode.ExtensionContext) { const sessionId = generateSessionId() const project = workspace.name || 'default' // Fetch context from worker - const response = await fetch(`http://localhost:37777/api/context/inject?project=${project}`) + const response = await fetch(`${workerBaseUrl}/api/context/inject?project=${project}`) const context = await response.text() // Inject into chat or UI panel @@ -126,7 +129,7 @@ export async function activate(context: vscode.ExtensionContext) { // VS Code Extension - UserPromptSubmit Hook const command = vscode.commands.registerCommand('extension.command', async (prompt) => { - await fetch('http://localhost:37777/sessions/init', { + await fetch(`${workerBaseUrl}/sessions/init`, { method: 'POST', body: JSON.stringify({ sessionId, project, userPrompt: prompt }) }) @@ -134,7 +137,7 @@ const command = vscode.commands.registerCommand('extension.command', async (prom // VS Code Extension - PostToolUse Hook (middleware pattern) workspace.onDidSaveTextDocument(async (document) => { - await fetch('http://localhost:37777/api/sessions/observations', { + await fetch(`${workerBaseUrl}/api/sessions/observations`, { method: 'POST', body: JSON.stringify({ claudeSessionId: sessionId, @@ -155,7 +158,7 @@ graph TB A["Extension: Tool Use Event"] --> B{"Skip List?
(TodoWrite, AskUserQuestion, etc.)"} B -->|"Skip"| X["Discard"] B -->|"Keep"| C["Strip Privacy Tags
<private>...</private>"] - C --> D["HTTP POST to Worker
Port 37777"] + C --> D["HTTP POST to Worker
Configured port"] D --> E["2s timeout
fire-and-forget"] E --> F["Extension continues
(non-blocking)"] @@ -304,7 +307,7 @@ sequenceDiagram **Processing**: 1. Wait for worker to be available (health check, max 10 seconds) -2. Call: `GET http://127.0.0.1:37777/api/context/inject?project={project}` +2. Call: `GET http://127.0.0.1:/api/context/inject?project={project}` 3. Return formatted context as `additionalContext` in `hookSpecificOutput` **Output** (via stdout): @@ -402,7 +405,7 @@ if (!cleanedPrompt || cleanedPrompt.trim() === '') { db.saveUserPrompt(session_id, promptNumber, cleanedPrompt) // 7. Initialize session via worker HTTP -POST http://127.0.0.1:37777/sessions/{sessionDbId}/init +POST http://127.0.0.1:/sessions/{sessionDbId}/init Body: { project, userPrompt, promptNumber } ``` @@ -497,7 +500,7 @@ if (SKIP_TOOLS[tool_name]) return await ensureWorkerRunning() // 3. Send to worker (fire-and-forget HTTP) -POST http://127.0.0.1:37777/api/sessions/observations +POST http://127.0.0.1:/api/sessions/observations Body: { claudeSessionId: session_id, tool_name, @@ -592,7 +595,7 @@ const lines = fs.readFileSync(transcript_path, 'utf-8').split('\n') await ensureWorkerRunning() // 3. Send summarization request (fire-and-forget HTTP) -POST http://127.0.0.1:37777/api/sessions/summarize +POST http://127.0.0.1:/api/sessions/summarize Body: { claudeSessionId: session_id, last_user_message: string, @@ -601,7 +604,7 @@ Body: { Timeout: 2000ms // 4. Stop processing spinner -POST http://127.0.0.1:37777/api/processing +POST http://127.0.0.1:/api/processing Body: { isProcessing: false } ``` @@ -671,7 +674,7 @@ sequenceDiagram ```typescript // Send session complete (fire-and-forget HTTP) -POST http://127.0.0.1:37777/api/sessions/complete +POST http://127.0.0.1:/api/sessions/complete Body: { claudeSessionId: session_id, reason: string // 'exit' | 'clear' | 'logout' | 'prompt_input_exit' | 'other' @@ -902,7 +905,7 @@ For developers implementing this pattern on other platforms: - [ ] Indices for common queries ### Worker Service -- [ ] HTTP server on configurable port (default 37777) +- [ ] HTTP server on configured worker port - [ ] Bun runtime for process management - [ ] 3 core services: SessionManager, SDKAgent, DatabaseManager diff --git a/docs/public/architecture/overview.mdx b/docs/public/architecture/overview.mdx index 4ef33364b..01b3b5be3 100644 --- a/docs/public/architecture/overview.mdx +++ b/docs/public/architecture/overview.mdx @@ -190,7 +190,7 @@ Skill-based search with progressive disclosure providing 10 search operations: See [Search Architecture](/architecture/search-architecture) for technical details and examples. ### 5. Viewer UI -React + TypeScript web interface served by the worker on its configured port (default `http://127.0.0.1:`) featuring: +React + TypeScript web interface served by the worker on its configured `CLAUDE_MEM_WORKER_PORT` featuring: - Real-time memory stream via Server-Sent Events - Infinite scroll pagination with automatic deduplication - Project filtering and settings persistence diff --git a/docs/public/architecture/search-architecture.mdx b/docs/public/architecture/search-architecture.mdx index 96024170b..524089acb 100644 --- a/docs/public/architecture/search-architecture.mdx +++ b/docs/public/architecture/search-architecture.mdx @@ -14,7 +14,7 @@ Claude-mem uses an **MCP-based search architecture** that provides intelligent m **Key Components**: 1. **MCP Tools** (4 tools) - `search`, `timeline`, `get_observations`, `__IMPORTANT` 2. **MCP Server** (`plugin/scripts/mcp-server.cjs`) - Thin wrapper over HTTP API -3. **HTTP API Endpoints** - Fast search operations on Worker Service (port 37777) +3. **HTTP API Endpoints** - Fast search operations on the configured Worker Service port 4. **Worker Service** - Express.js server with FTS5 full-text search 5. **SQLite Database** - Persistent storage with FTS5 virtual tables 6. **Chroma Vector DB** - Semantic search with hybrid retrieval @@ -56,7 +56,9 @@ MCP server receives tool call via JSON-RPC over stdio: MCP server translates to HTTP request: ```typescript -const url = `http://localhost:37777/api/search?query=authentication%20bug&type=bugfix&limit=10`; +const workerPort = process.env.CLAUDE_MEM_WORKER_PORT ?? ""; +const workerBaseUrl = `http://127.0.0.1:${workerPort}`; +const url = `${workerBaseUrl}/api/search?query=authentication%20bug&type=bugfix&limit=10`; const response = await fetch(url); ``` @@ -221,7 +223,9 @@ NEVER fetch full details without filtering first. 10x token savings. searchParams.append(key, String(value)); } - const url = `http://localhost:37777${endpoint}?${searchParams}`; + const workerPort = process.env.CLAUDE_MEM_WORKER_PORT ?? ""; + const workerBaseUrl = `http://127.0.0.1:${workerPort}`; + const url = `${workerBaseUrl}${endpoint}?${searchParams}`; const response = await fetch(url); return await response.json(); } @@ -232,7 +236,7 @@ NEVER fetch full details without filtering first. 10x token savings. **Location:** `src/services/worker-service.ts` -**Port:** 37777 +**Port:** Configured worker port. The default is per-user (`37700 + (uid % 100)`) and can be overridden with `CLAUDE_MEM_WORKER_PORT`. **Search Endpoints:** ```typescript @@ -400,7 +404,7 @@ function escapeFTS5Query(query: string): string { ### MCP Protocol Security - Stdio transport (no network exposure) -- Local-only HTTP API (localhost:37777) +- Local-only HTTP API on the configured worker port - No authentication needed (local development only) ## Performance @@ -460,13 +464,19 @@ function escapeFTS5Query(query: string): string { ## Troubleshooting +For direct API checks, set the worker port first: + +```bash +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +``` + ### MCP Server Not Connected **Symptoms:** Tools not appearing in Claude **Solution:** 1. Check MCP server path in configuration -2. Verify worker service is running: `curl http://localhost:37777/api/health` +2. Verify worker service is running: `curl http://127.0.0.1:$WORKER_PORT/api/health` 3. Restart Claude Desktop/Code ### Worker Service Not Running @@ -485,9 +495,9 @@ npm run worker:logs # View logs **Symptoms:** search() returns no results **Troubleshooting:** -1. Test API directly: `curl "http://localhost:37777/api/search?query=test"` +1. Test API directly: `curl "http://127.0.0.1:$WORKER_PORT/api/search?query=test"` 2. Check database: `ls ~/.claude-mem/claude-mem.db` -3. Verify observations exist: `curl "http://localhost:37777/api/health"` +3. Verify observations exist: `curl "http://127.0.0.1:$WORKER_PORT/api/health"` ## Next Steps diff --git a/docs/public/beta-features.mdx b/docs/public/beta-features.mdx deleted file mode 100644 index b6cbcb5ce..000000000 --- a/docs/public/beta-features.mdx +++ /dev/null @@ -1,151 +0,0 @@ ---- -title: "Beta Features" -description: "Try experimental features like Endless Mode before they're released" ---- - -# Beta Features - - -**Endless Mode is experimental and not included in the stable release.** You must manually switch to the beta branch to try it. The efficiency projections below are based on theoretical modeling, not production measurements. Expect slower performance than standard mode and potential bugs. - - -Claude-Mem offers a beta channel for users who want to try experimental features before they're released to the stable channel. - -## Version Channel Switching - -You can switch between stable and beta versions directly from the web viewer UI (the worker prints its URL on startup; default `http://127.0.0.1:`). - -### How to Access - -1. Open the Claude-Mem viewer (the worker prints its URL on startup) -2. Click the **Settings** gear icon in the top-right -3. Find the **Version Channel** section -4. Click **Try Beta (Endless Mode)** to switch to beta, or **Switch to Stable** to return - -### What Happens When You Switch - -When switching versions: - -1. **Local changes are discarded** - Any modifications in the plugin directory are reset -2. **Git fetch and checkout** - The installed plugin switches to the target branch -3. **Dependencies reinstall** - `npm install` runs to ensure correct dependencies -4. **Worker restarts automatically** - The background service restarts with the new version - -**Your memory data is always preserved.** The database at `~/.claude-mem/claude-mem.db` is not affected by version switching. All your observations, sessions, and summaries remain intact. - -### Version Indicators - -The Version Channel section shows your current status: - -- **Stable** (green badge) - You're running the production release -- **Beta** (orange badge) - You're running the beta with experimental features - -You'll also see the exact branch name (e.g., `main` for stable, `beta/7.0` for beta). - -## Endless Mode (Beta) - -The flagship experimental feature in beta is **Endless Mode** - a biomimetic memory architecture that dramatically extends how long Claude can maintain context in a session. - -### The Problem Endless Mode Solves - -In standard Claude Code sessions: - -- Tool outputs (file reads, bash output, search results) accumulate in the context window -- Each tool can add 1-10k+ tokens to the context -- After ~50 tool uses, the context window fills up (~200k tokens) -- You're forced to start a new session, losing conversational continuity - -Worse, Claude **re-synthesizes all previous tool outputs** on every response. This is O(N²) complexity - quadratically growing both in tokens and compute. - -### How Endless Mode Works - -Endless Mode applies a biomimetic memory architecture inspired by how human memory works: - -**Two-Tier Memory System:** - -``` -Working Memory (Context Window): - → Compressed observations only (~500 tokens each) - → Fast, efficient, manageable - -Archive Memory (Transcript File): - → Full tool outputs preserved on disk - → Perfect recall, searchable -``` - -**The Key Innovation**: After each tool use, Endless Mode: -1. Waits for the worker to generate a compressed observation (blocking) -2. Transforms the transcript file on disk -3. Replaces the full tool output with the compressed observation -4. Claude resumes with the compressed context - -This transforms O(N²) scaling into O(N) - linear instead of quadratic. - -### Projected Results - -Based on theoretical modeling (not production measurements): - -- **Token savings**: Significant reduction in context window usage -- **Efficiency gain**: More tool uses before context exhaustion -- **Quality preservation**: Observations cache the synthesis result, so no information is lost - -### Important Caveats - -Endless Mode is experimental and has significant limitations: - -- **Not in stable release** - You must manually switch to the beta branch to use this feature -- **Still in development** - May have bugs, breaking changes, or incomplete functionality -- **Slower than standard mode** - Blocking observation generation adds latency to each tool use -- **Theoretical projections** - The efficiency claims above are based on simulations, not real-world production data -- **Requires working database** - Observations must save successfully for transformation -- **New architecture** - Less battle-tested than standard mode - -### When to Use Beta - -Consider switching to beta if you: - -- Frequently hit context window limits -- Work on long, complex sessions with many tool uses -- Want to help test and provide feedback on new features -- Are comfortable with experimental software - -### When to Stay on Stable - -Stay on stable if you: - -- Need maximum reliability for critical work -- Prefer battle-tested, production-ready features -- Don't frequently hit context limits -- Want the smoothest, fastest experience - -## Checking for Updates - -While on beta (or stable), you can check for updates: - -1. Open Settings in the viewer -2. In the Version Channel section, click **Check for Updates** -3. The plugin will pull the latest changes and restart - -## Switching Back - -If you encounter issues on beta: - -1. Open Settings in the viewer -2. Click **Switch to Stable** -3. Wait for the worker to restart - -Your memory data is preserved, and you'll be back on the stable release. - -## Providing Feedback - -If you encounter bugs or have feedback about beta features: - -- Open an issue at [GitHub Issues](https://github.com/thedotmack/claude-mem/issues) -- Include your branch (`beta/7.0` etc.) in the report -- Describe what you expected vs. what happened - -## Next Steps - -- [Configuration](configuration) - Customize other Claude-Mem settings -- [Troubleshooting](troubleshooting) - Common issues and solutions -- [Architecture Overview](architecture/overview) - Understand how Claude-Mem works diff --git a/docs/public/branches.mdx b/docs/public/branches.mdx new file mode 100644 index 000000000..9787bbcc6 --- /dev/null +++ b/docs/public/branches.mdx @@ -0,0 +1,88 @@ +--- +title: "Release Branches" +description: "The branches Claude-Mem ships from, what is published, and how to run non-stable lines" +--- + +# Release Branches + +Claude-Mem has three long-lived runtime branches. Only `main` is published to npm today. + +| Line | Branch | Who it is for | Published to npm? | +|------|--------|---------------|-------------------| +| Stable | `main` | Everyone. This is the `npx claude-mem` install. | Yes | +| Core Dev | `core-dev` | Maintainer and testers who want reliability fixes early. | No, run from source | +| Community Edge | `community-edge` | Integrated community work before it is hardened. | No, run from source | + +## How Changes Flow + +Work moves toward stable: + +```text +community-edge -> core-dev -> main +``` + +New work enters as a PR to `core-dev` or `community-edge`, not directly to +`main`. Stable advances when hardened `core-dev` work is promoted into `main`. + +Docs-only work can be staged on `updates/docs` and merged to `main` when ready. +That branch is not a runtime release line. + +## Install Stable + +The normal installer always uses the published stable line: + +```bash +npx claude-mem install +``` + +You can also pin an npm-published stable version: + +```bash +npx claude-mem@VERSION install +``` + +## Run a Non-Stable Branch + +`core-dev` and `community-edge` are source-run lines. To test one: + +```bash +git clone https://github.com/thedotmack/claude-mem.git +cd claude-mem +git checkout core-dev # or: community-edge +npm install +npm run build-and-sync +``` + +`build-and-sync` builds the checked-out branch, syncs it into your local Claude +Code plugin marketplace, and restarts the worker. + +To return to stable: + +```bash +git checkout main +npm run build-and-sync +``` + +Or reinstall the published package: + +```bash +npx claude-mem@latest install +``` + +## Published Versions + +GitHub releases and npm releases are separate: + +- A GitHub release/tag makes the source archive visible on GitHub. +- An npm publish is what makes `npx claude-mem@` resolve. +- `latest` points at the current stable npm publish. + +If npm channel tags are added later, they should use npm dist-tags such as +`core-dev` and `community-edge`. Until then, non-stable branches are run from +source. + +## Maintainer Release Rule + +Production releases happen from `main` only. The release flow updates the version +manifests, builds generated artifacts, pushes a git tag, hands npm publishing to +the maintainer, creates the GitHub release, then regenerates `CHANGELOG.md`. diff --git a/docs/public/configuration.mdx b/docs/public/configuration.mdx index f94eea647..0a0a65f2f 100644 --- a/docs/public/configuration.mdx +++ b/docs/public/configuration.mdx @@ -181,28 +181,6 @@ Search operations are provided via: - **HTTP API**: 10 endpoints on the worker service port (per-user, default `37700 + (uid % 100)`; see `~/.claude-mem/settings.json`) - **Auto-Invocation**: Claude recognizes natural language queries about past work -## Version Channel - -Claude-Mem supports switching between stable and beta versions via the web viewer UI. - -### Accessing Version Channel - -1. Open the viewer at the worker URL (default `http://127.0.0.1:`; the active port is the value of `CLAUDE_MEM_WORKER_PORT` in `~/.claude-mem/settings.json`) -2. Click the Settings gear icon -3. Find the **Version Channel** section - -### Switching Versions - -- **Try Beta**: Click "Try Beta (Endless Mode)" to switch to the beta branch with experimental features -- **Switch to Stable**: Click "Switch to Stable" to return to the production release -- **Check for Updates**: Pull the latest changes for your current branch - -**Your memory data is preserved** when switching versions. Only the plugin code changes. - - -Endless Mode is experimental and slower than standard mode. See [Beta Features](beta-features) for full details and important limitations. - - ## Worker Service Management Worker service is managed by Bun as a background process. The worker auto-starts on first session and runs continuously in the background. @@ -223,7 +201,7 @@ Claude-Mem injects past observations into each new session, giving Claude awaren ### Context Settings Modal -Access the settings modal from the web viewer (the worker prints its URL on startup; default is `http://127.0.0.1:`): +Access the settings modal from the web viewer. The worker prints its URL on startup; the port comes from `CLAUDE_MEM_WORKER_PORT`. 1. Click the **gear icon** in the header 2. Adjust settings in the right panel diff --git a/docs/public/cursor/gemini-setup.mdx b/docs/public/cursor/gemini-setup.mdx index 81c509c71..1d40e89ed 100644 --- a/docs/public/cursor/gemini-setup.mdx +++ b/docs/public/cursor/gemini-setup.mdx @@ -95,7 +95,7 @@ bun run worker:status bun run cursor:status ``` -Open http://localhost:37777 to see the memory viewer. +Open the worker URL printed on startup to see the memory viewer. ## Available Gemini Models diff --git a/docs/public/cursor/index.mdx b/docs/public/cursor/index.mdx index 66d97d3e5..d0e9dc53b 100644 --- a/docs/public/cursor/index.mdx +++ b/docs/public/cursor/index.mdx @@ -35,7 +35,7 @@ Claude-mem integrates with Cursor through native hooks: 1. **Session hooks** capture tool usage, file edits, and shell commands 2. **AI extraction** compresses observations into semantic summaries 3. **Context injection** loads relevant history into each new session -4. **Memory viewer** at http://localhost:37777 shows your knowledge base +4. **Memory viewer** at the worker URL shows your knowledge base ## Installation Paths @@ -129,7 +129,7 @@ After setup, verify everything is working: ``` 3. **Open the memory viewer:** - Open http://localhost:37777 in your browser + Open the worker URL in your browser 4. **Restart Cursor** and start a coding session - you should see context being captured @@ -151,7 +151,7 @@ After setup, verify everything is working: ```bash # Check if port is in use -lsof -i :37777 +lsof -i :YOUR_WORKER_PORT # Force restart bun run worker:stop && bun run worker:start @@ -169,7 +169,7 @@ bun run worker:logs ### No context appearing 1. Ensure worker is running: `bun run worker:status` -2. Check that you have observations: visit http://localhost:37777 +2. Check that you have observations by opening the worker URL 3. Verify your API key is configured correctly ## Next Steps diff --git a/docs/public/cursor/openrouter-setup.mdx b/docs/public/cursor/openrouter-setup.mdx index 82c8b170d..c534979b5 100644 --- a/docs/public/cursor/openrouter-setup.mdx +++ b/docs/public/cursor/openrouter-setup.mdx @@ -89,7 +89,7 @@ bun run worker:status bun run cursor:status ``` -Open http://localhost:37777 to see the memory viewer. +Open the worker URL printed on startup to see the memory viewer. ## Recommended Models diff --git a/docs/public/development.mdx b/docs/public/development.mdx index 54309403b..4360c2553 100644 --- a/docs/public/development.mdx +++ b/docs/public/development.mdx @@ -166,7 +166,7 @@ npm run build 2. Build: `npm run build` 3. Sync to installed plugin: `npm run sync-marketplace` 4. Restart worker: `npm run worker:restart` -5. Refresh browser at http://localhost:37777 +5. Refresh the worker URL printed by `npm run worker:status` **Hot Reload**: Not currently supported. Full rebuild + restart required for changes. @@ -320,7 +320,7 @@ npm test export function buildObservationPrompt(observation: Observation): string { return ` - + `; } @@ -426,7 +426,8 @@ When developing new features: npm run worker:status # Queue inspection -curl http://localhost:37777/api/pending-queue +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +curl http://127.0.0.1:$WORKER_PORT/api/pending-queue # Database integrity sqlite3 ~/.claude-mem/claude-mem.db "PRAGMA integrity_check;" @@ -482,7 +483,8 @@ For manual recovery features specifically: 3. **Verify results**: ```bash - curl http://localhost:37777/api/pending-queue | jq '.queue' + WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) + curl http://127.0.0.1:$WORKER_PORT/api/pending-queue | jq '.queue' ``` ### Regression Testing @@ -500,7 +502,7 @@ Before releasing: - Context injection (recent sessions appear) - Observation processing (summaries generated) - MCP search tools (search returns results) - - Viewer UI (loads at http://localhost:37777) + - Viewer UI (loads at the worker URL) - Manual recovery (stuck messages recovered) 3. **Test edge cases**: @@ -602,61 +604,60 @@ echo '{"session_id":"test-123","cwd":"'$(pwd)'","prompt":"test"}' | node plugin/ ## Publishing -### NPM Publishing +Production releases happen from `main` only. `core-dev` and `community-edge` +are source-run branches; see [Release Branches](branches). + +### Version Bump + +Update every manifest that carries the package version: + +- `package.json` +- `plugin/package.json` +- `.claude-plugin/marketplace.json` +- `.claude-plugin/plugin.json` +- `plugin/.claude-plugin/plugin.json` +- `.codex-plugin/plugin.json` +- `plugin/.codex-plugin/plugin.json` +- `openclaw/openclaw.plugin.json` + +Verify the old version is gone and the new version appears everywhere expected: ```bash -# Update version in package.json -npm version patch # or minor, or major - -# Build -npm run build - -# Publish to NPM -npm run release +git grep -n '"version": "NEW_VERSION"' +git grep -n '"version": "OLD_VERSION"' ``` -The `release` script: -1. Runs tests -2. Builds all components -3. Publishes to NPM registry - -### Creating a Release - -1. Update version in `package.json` -2. Update `CHANGELOG.md` -3. Commit changes -4. Create git tag -5. Push to GitHub -6. Publish to NPM +### Build, Tag, and Publish ```bash -# Manual version bump: -# 1. Update version in package.json -# 2. Update version in plugin/.claude-plugin/plugin.json -# 3. Update version at top of CLAUDE.md -# 4. Update version badge in README.md -# 5. Run: npm run build && npm run sync-marketplace - -# Or use npm version command: -npm version 4.3.2 - -# Update changelog -# Edit CHANGELOG.md manually - -# Commit -git add . -git commit -m "chore: Release v4.3.2" - -# Tag -git tag v4.3.2 - -# Push -git push origin main --tags - -# Publish to NPM -npm run release +npm run build-and-sync +git add -A +git commit -m "chore: bump version to NEW_VERSION" +git tag -a vNEW_VERSION -m "Version NEW_VERSION" +git push origin main +git push origin vNEW_VERSION ``` +Publishing to npm requires the maintainer's npm credentials and 2FA: + +```bash +npm publish +npm view claude-mem@NEW_VERSION version +``` + +Only after npm resolves the version, create the GitHub release and regenerate the +changelog: + +```bash +gh release create vNEW_VERSION --title "vNEW_VERSION" --notes "..." +npm run changelog:generate +git add CHANGELOG.md +git commit -m "docs: regenerate changelog for vNEW_VERSION" +git push origin main +``` + +Do not hand-edit `CHANGELOG.md`; it is generated from GitHub releases. + ## Contributing ### Contribution Workflow @@ -676,7 +677,7 @@ npm run release - **Description**: Explain why the change is needed - **Tests**: Include tests for new features - **Documentation**: Update docs as needed -- **Changelog**: Add entry to CHANGELOG.md +- **Changelog**: Do not hand-edit `CHANGELOG.md`; it is generated during release - **Commits**: Use clear, descriptive commit messages ### Code Review Process @@ -759,7 +760,8 @@ rm -rf plugin/scripts/*.js plugin/scripts/*.cjs 2. Check port: ```bash - lsof -i :37777 + WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) + lsof -i :$WORKER_PORT ``` 3. Try custom port: diff --git a/docs/public/docs.json b/docs/public/docs.json index d52f3a172..289d34fe9 100644 --- a/docs/public/docs.json +++ b/docs/public/docs.json @@ -44,9 +44,7 @@ "usage/private-tags", "usage/export-import", "usage/manual-recovery", - "usage/folder-context", - "beta-features", - "endless-mode" + "usage/folder-context" ] }, { @@ -85,6 +83,7 @@ "modes", "telemetry", "development", + "branches", "troubleshooting", "platform-integration", "openclaw-integration" diff --git a/docs/public/endless-mode.mdx b/docs/public/endless-mode.mdx deleted file mode 100644 index e0ccf6eda..000000000 --- a/docs/public/endless-mode.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Endless Mode (Beta)" -description: "Experimental biomimetic memory architecture for extended sessions" ---- - -# Current State of Endless Mode - -## Core Concept - -Endless Mode is a **biomimetic memory architecture** that solves Claude's context window exhaustion problem. Instead of keeping full tool outputs in the context window (O(N²) complexity), it: - -- Captures compressed observations after each tool use -- Replaces transcripts with low token summaries -- Achieves O(N) linear complexity -- Maintains two-tier memory: working memory (compressed) + archive memory (full transcript on disk, maintained by default claude code functionality) - -## Implementation Status - -**Status**: FUNCTIONAL BUT EXPERIMENTAL - -**Current Branch**: `beta/endless-mode` (ahead of main) - -**Recent Activity**: -- Merged main branch changes -- Resolved merge conflicts in save-hook, SessionStore, SessionRoutes -- Updated documentation to remove misleading token reduction claims -- Added important caveats about beta status - -## Key Architecture Components - -1. **Pre-Tool-Use Hook** - Tracks tool execution start, sends tool_use_id to worker -2. **Save Hook (PostToolUse)** - **CRITICAL**: Blocks until observation is generated (110s timeout), injects compressed observation back into context -3. **SessionManager.waitForNextObservation()** - Event-driven wait mechanism (no polling) -4. **SDKAgent** - Generates observations via Agent SDK, emits completion events -5. **Database** - Added `tool_use_id` column for observation correlation - -## Configuration - -```json -{ - "CLAUDE_MEM_ENDLESS_MODE": "false", // Default: disabled - "CLAUDE_MEM_ENDLESS_WAIT_TIMEOUT_MS": "90000" // 90 second timeout -} -``` - -**Enable via**: Manual checkout of beta branch (see instructions below) - -## Flow - -``` -Tool Executes → Pre-Hook (track ID) → Tool Completes → -Save-Hook (BLOCKS) → Worker processes → SDK generates observation → -Event fired → Hook receives observation → Injects markdown → -Clears input → Context reduced -``` - -## Known Limitations - -From the documentation: -- ⚠️ **Slower than standard mode** - Blocking adds latency -- ⚠️ **Still in development** - May have bugs -- ⚠️ **Not battle-tested** - New architecture -- ⚠️ **Theoretical projections** - Efficiency gains not yet validated in production - -## What's Working - -- ✅ Synchronous observation injection -- ✅ Event-driven wait mechanism -- ✅ Token reduction via input clearing -- ✅ Database schema with tool_use_id -- ✅ Web UI for version switching -- ✅ Graceful timeout fallbacks - -## What's Not Ready - -- ❌ Production validation of token savings -- ❌ Comprehensive test coverage -- ❌ Stable channel release -- ❌ Performance benchmarks -- ❌ Long-running session data - -## How to Try Endless Mode - -Endless Mode is currently only available on the beta branch. To try it: - -```bash -# Navigate to your claude-mem installation -cd ~/.claude/plugins/marketplaces/thedotmack/ - -# Checkout the beta branch -git checkout beta/endless-mode - -# Install dependencies -npm install - -# Restart the worker -npm run worker:restart -``` - -**To return to stable:** - -```bash -cd ~/.claude/plugins/marketplaces/thedotmack/ -git checkout main -npm install -npm run worker:restart -``` - -## Summary - -The implementation is architecturally complete and functional, but remains experimental pending production validation of the theoretical efficiency gains. diff --git a/docs/public/platform-integration.mdx b/docs/public/platform-integration.mdx index 7bf6d0a59..984b9d655 100644 --- a/docs/public/platform-integration.mdx +++ b/docs/public/platform-integration.mdx @@ -137,7 +137,7 @@ Platform Hook/Extension - User settings - MCP toggle - - Git branch switching + - Dependency health diff --git a/docs/public/troubleshooting.mdx b/docs/public/troubleshooting.mdx index 0b7d9ea8a..26f957c6a 100644 --- a/docs/public/troubleshooting.mdx +++ b/docs/public/troubleshooting.mdx @@ -23,6 +23,12 @@ The skill includes comprehensive diagnostics, automated repair sequences, and de ## Common Issues +For worker API commands below, set `PORT` first: + +```bash +PORT=${CLAUDE_MEM_WORKER_PORT:-$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json)} +``` + ### Viewer UI Not Loading **Symptoms**: Cannot reach the viewer URL, page doesn't load, or browser shows a connection error. @@ -71,7 +77,7 @@ The skill includes comprehensive diagnostics, automated repair sequences, and de 2. Verify settings endpoint is working: ```bash - curl http://localhost:37777/api/settings + curl http://127.0.0.1:$PORT/api/settings ``` 3. Clear localStorage and try again: @@ -90,7 +96,7 @@ The skill includes comprehensive diagnostics, automated repair sequences, and de 1. Check SSE endpoint is accessible: ```bash - curl -N http://localhost:37777/stream + curl -N http://127.0.0.1:$PORT/stream ``` 2. Check browser console for errors: @@ -210,14 +216,14 @@ The skill includes comprehensive diagnostics, automated repair sequences, and de **Solutions**: -1. Check if port 37777 is in use: +1. Check if the configured port is in use: ```bash - lsof -i :37777 + lsof -i :$PORT ``` 2. Kill process using the port: ```bash - kill -9 $(lsof -t -i:37777) + kill -9 $(lsof -t -i:$PORT) ``` 3. Or use a different port: @@ -337,7 +343,7 @@ For automation or scripting scenarios: 1. **Check queue status**: ```bash - curl http://localhost:37777/api/pending-queue + curl http://127.0.0.1:$PORT/api/pending-queue ``` Response shows: @@ -348,7 +354,7 @@ For automation or scripting scenarios: 2. **Trigger manual recovery**: ```bash - curl -X POST http://localhost:37777/api/pending-queue/process \ + curl -X POST http://127.0.0.1:$PORT/api/pending-queue/process \ -H "Content-Type: application/json" \ -d '{"sessionLimit": 10}' ``` @@ -392,8 +398,8 @@ If recovery fails or messages remain stuck: 1. **Verify worker is healthy**: ```bash - curl http://localhost:37777/health - # Should return: {"status":"ok","uptime":12345,"port":37777} + curl http://127.0.0.1:$PORT/health + # Should return: {"status":"ok","uptime":12345,"port":...} ``` 2. **Check database for corruption**: diff --git a/docs/public/usage/claude-desktop.mdx b/docs/public/usage/claude-desktop.mdx index 5c48e4eea..df1bfa366 100644 --- a/docs/public/usage/claude-desktop.mdx +++ b/docs/public/usage/claude-desktop.mdx @@ -22,7 +22,8 @@ Before configuring MCP tools, ensure: ### Verify Worker is Running ```bash -curl http://localhost:37777/api/health +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +curl http://127.0.0.1:$WORKER_PORT/api/health # Should return: {"status":"ok"} ``` @@ -115,7 +116,7 @@ This 3-layer approach provides ~10x token savings compared to fetching full deta ### MCP Server Connection Failed -1. Verify the worker is running: `curl http://localhost:37777/api/health` +1. Verify the worker is running: `curl http://127.0.0.1:$WORKER_PORT/api/health` 2. Check the MCP server path in configuration 3. Look for errors in Claude Desktop logs @@ -133,9 +134,9 @@ This 3-layer approach provides ~10x token savings compared to fetching full deta ### Search Returns No Results -1. Ensure claude-mem has recorded sessions (check http://localhost:37777) +1. Ensure claude-mem has recorded sessions (check http://127.0.0.1:$WORKER_PORT) 2. Verify the database exists: `ls ~/.claude-mem/claude-mem.db` -3. Test the API directly: `curl "http://localhost:37777/api/search?query=test"` +3. Test the API directly: `curl "http://127.0.0.1:$WORKER_PORT/api/search?query=test"` ## Related diff --git a/docs/public/usage/export-import.mdx b/docs/public/usage/export-import.mdx index 59eca5158..197bb37f5 100644 --- a/docs/public/usage/export-import.mdx +++ b/docs/public/usage/export-import.mdx @@ -168,7 +168,8 @@ If you run the import again on the same file, duplicates are automatically skipp 4. **Verify import** by searching: ```bash - curl "http://localhost:37777/api/search?query=windows&format=index&limit=10" + WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) + curl "http://127.0.0.1:$WORKER_PORT/api/search?query=windows&format=index&limit=10" ``` ## JSON Export Format diff --git a/docs/public/usage/gemini-provider.mdx b/docs/public/usage/gemini-provider.mdx index 91b73f873..5d11d6998 100644 --- a/docs/public/usage/gemini-provider.mdx +++ b/docs/public/usage/gemini-provider.mdx @@ -44,7 +44,7 @@ Claude-mem supports Google's Gemini API as an alternative to the Claude Agent SD ### Using the Settings UI -1. Open the viewer at http://localhost:37777 +1. Open the worker URL printed on startup 2. Click the **gear icon** to open Settings 3. Under **AI Provider**, select **Gemini** 4. Enter your Gemini API key diff --git a/docs/public/usage/knowledge-agents.mdx b/docs/public/usage/knowledge-agents.mdx index e0f171320..98ddbcee9 100644 --- a/docs/public/usage/knowledge-agents.mdx +++ b/docs/public/usage/knowledge-agents.mdx @@ -79,7 +79,8 @@ BUILD ──> PRIME ──> QUERY A corpus is a filtered collection of observations saved as a JSON file. Use search filters to select exactly the slice of history you want. ```bash -curl -X POST http://localhost:37777/api/corpus \ +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +curl -X POST http://127.0.0.1:$WORKER_PORT/api/corpus \ -H "Content-Type: application/json" \ -d '{ "name": "hooks-expertise", @@ -97,7 +98,7 @@ Under the hood, `CorpusBuilder` searches your observations, hydrates full record Priming loads the entire corpus into a Claude session's context window. ```bash -curl -X POST http://localhost:37777/api/corpus/hooks-expertise/prime +curl -X POST http://127.0.0.1:$WORKER_PORT/api/corpus/hooks-expertise/prime ``` The agent renders all observations into full-detail text and feeds them to the Claude Agent SDK. Claude reads the corpus and acknowledges the themes. The returned `session_id` **is** the knowledge agent -- a Claude session with your history baked in. @@ -107,7 +108,7 @@ The agent renders all observations into full-detail text and feeds them to the C Resume the primed session and ask questions. ```bash -curl -X POST http://localhost:37777/api/corpus/hooks-expertise/query \ +curl -X POST http://127.0.0.1:$WORKER_PORT/api/corpus/hooks-expertise/query \ -H "Content-Type: application/json" \ -d '{ "question": "What are the 5 lifecycle hooks?" }' ``` @@ -138,7 +139,7 @@ Use these parameters when building a corpus to control which observations are in ``` MCP Tools HTTP API - (mcp-server.ts) (worker on :37777) + (mcp-server.ts) (worker on :$WORKER_PORT) | | build_corpus ──┤ | list_corpora ──┤ | diff --git a/docs/public/usage/manual-recovery.mdx b/docs/public/usage/manual-recovery.mdx index 77e502352..38ab0dff6 100644 --- a/docs/public/usage/manual-recovery.mdx +++ b/docs/public/usage/manual-recovery.mdx @@ -111,7 +111,8 @@ Would you like to process these pending queues? (y/n) #### Check Queue Status ```bash -curl http://localhost:37777/api/pending-queue +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +curl http://127.0.0.1:$WORKER_PORT/api/pending-queue ``` **Response**: @@ -148,7 +149,7 @@ curl http://localhost:37777/api/pending-queue #### Trigger Recovery ```bash -curl -X POST http://localhost:37777/api/pending-queue/process \ +curl -X POST http://127.0.0.1:$WORKER_PORT/api/pending-queue/process \ -H "Content-Type: application/json" \ -d '{"sessionLimit": 10}' ``` @@ -176,7 +177,7 @@ curl -X POST http://localhost:37777/api/pending-queue/process \ ```bash # Check queue status first -curl http://localhost:37777/api/pending-queue +curl http://127.0.0.1:$WORKER_PORT/api/pending-queue # Or use CLI tool which checks automatically bun scripts/check-pending-queue.ts @@ -209,7 +210,7 @@ Look for: Check recently processed messages: ```bash -curl http://localhost:37777/api/pending-queue | jq '.recentlyProcessed' +curl http://127.0.0.1:$WORKER_PORT/api/pending-queue | jq '.recentlyProcessed' ``` Or use the CLI tool which shows this automatically. @@ -248,7 +249,7 @@ sqlite3 ~/.claude-mem/claude-mem.db " 1. **Verify worker health**: ```bash - curl http://localhost:37777/health + curl http://127.0.0.1:$WORKER_PORT/health ``` 2. **Check worker logs for errors**: @@ -383,8 +384,10 @@ sqlite3 ~/.claude-mem/claude-mem.db " #!/bin/bash # Run every hour to process stuck queues +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) + # Check if worker is healthy -if curl -f http://localhost:37777/health > /dev/null 2>&1; then +if curl -f http://127.0.0.1:$WORKER_PORT/health > /dev/null 2>&1; then # Auto-process up to 5 sessions bun scripts/check-pending-queue.ts --process --limit 5 else @@ -399,7 +402,8 @@ fi #!/bin/bash # Alert if stuck count exceeds threshold -STUCK_COUNT=$(curl -s http://localhost:37777/api/pending-queue | jq '.queue.stuckCount') +WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) +STUCK_COUNT=$(curl -s http://127.0.0.1:$WORKER_PORT/api/pending-queue | jq '.queue.stuckCount') if [ "$STUCK_COUNT" -gt 5 ]; then echo "WARNING: $STUCK_COUNT stuck messages detected" diff --git a/docs/public/usage/openrouter-provider.mdx b/docs/public/usage/openrouter-provider.mdx index 747173d03..34bd9cf49 100644 --- a/docs/public/usage/openrouter-provider.mdx +++ b/docs/public/usage/openrouter-provider.mdx @@ -79,7 +79,7 @@ All free models support: ### Using the Settings UI -1. Open the viewer at http://localhost:37777 +1. Open the worker URL printed on startup 2. Click the **gear icon** to open Settings 3. Under **AI Provider**, select **OpenRouter** 4. Enter your OpenRouter API key diff --git a/docs/public/usage/search-tools.mdx b/docs/public/usage/search-tools.mdx index 6ddf7b6d5..978d2367c 100644 --- a/docs/public/usage/search-tools.mdx +++ b/docs/public/usage/search-tools.mdx @@ -372,7 +372,8 @@ All observations include rich metadata: 2. **Check database has data:** ```bash - curl "http://localhost:37777/api/search?query=test" + WORKER_PORT=$(jq -r .CLAUDE_MEM_WORKER_PORT ~/.claude-mem/settings.json) + curl "http://127.0.0.1:$WORKER_PORT/api/search?query=test" ``` 3. **Try without filters:** @@ -436,11 +437,11 @@ If searches seem slow: ## Technical Details -**Architecture:** MCP tools are a thin wrapper over the Worker HTTP API (localhost:37777). The MCP server translates tool calls into HTTP requests to the worker service, which handles all business logic, database queries, and Chroma vector search. +**Architecture:** MCP tools are a thin wrapper over the local Worker HTTP API. The MCP server translates tool calls into HTTP requests to the worker service, which handles all business logic, database queries, and Chroma vector search. **MCP Server:** Located at `~/.claude/plugins/marketplaces/thedotmack/plugin/scripts/mcp-server.cjs` -**Worker Service:** Express API on port 37777, managed by Bun +**Worker Service:** Express API on the configured worker port, managed by Bun **Database:** SQLite FTS5 full-text search on `~/.claude-mem/claude-mem.db` diff --git a/package.json b/package.json index 85912d747..24287971a 100644 --- a/package.json +++ b/package.json @@ -79,9 +79,9 @@ "strip-comments:check": "bun scripts/strip-comments.ts --check", "strip-comments:dry-run": "bun scripts/strip-comments.ts --dry-run", "translate-readme": "bun scripts/translate-readme/cli.ts -v -o docs/i18n README.md", - "translate:tier1": "npm run translate-readme -- zh zh-tw ja pt-br ko es de fr", + "translate:tier1": "npm run translate-readme -- zh zh-tw ja pt pt-br ko es de fr", "translate:tier2": "npm run translate-readme -- he ar ru pl cs nl tr uk", - "translate:tier3": "npm run translate-readme -- vi id th hi bn ro sv", + "translate:tier3": "npm run translate-readme -- vi tl id th hi bn ur ro sv", "translate:tier4": "npm run translate-readme -- it el hu fi da no", "translate:all": "npm run translate:tier1 & npm run translate:tier2 & npm run translate:tier3 & npm run translate:tier4 & wait", "bug-report": "bun scripts/bug-report/cli.ts", diff --git a/scripts/translate-readme/README.md b/scripts/translate-readme/README.md index d47d6e6e3..dd7b69e3d 100644 --- a/scripts/translate-readme/README.md +++ b/scripts/translate-readme/README.md @@ -145,19 +145,19 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - + - uses: actions/setup-node@v4 with: node-version: 20 - + - run: npm install -g readme-translator - + - name: Translate README env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} run: | translate-readme -v -o ./i18n README.md es fr de ja zh - + - name: Commit translations run: | git config user.name "github-actions[bot]" @@ -211,6 +211,7 @@ main(); | `id` | Indonesian | `th` | Thai | | `it` | Italian | `tr` | Turkish | | `ja` | Japanese | `uk` | Ukrainian | +| `tl` | Tagalog | `ur` | Urdu | | | | `vi` | Vietnamese | | | | `zh` | Chinese (Simplified) | | | | `zh-tw` | Chinese (Traditional) | diff --git a/scripts/translate-readme/cli.ts b/scripts/translate-readme/cli.ts index 92b2a054b..017662e37 100644 --- a/scripts/translate-readme/cli.ts +++ b/scripts/translate-readme/cli.ts @@ -83,12 +83,13 @@ function printLanguages(): void { nl: "Dutch", tr: "Turkish", uk: "Ukrainian", + ur: "Urdu", vi: "Vietnamese", id: "Indonesian", th: "Thai", + tl: "Tagalog", hi: "Hindi", bn: "Bengali", - ur: "Urdu", ro: "Romanian", sv: "Swedish", it: "Italian", diff --git a/scripts/translate-readme/index.ts b/scripts/translate-readme/index.ts index ed94734cf..70cc5fa78 100644 --- a/scripts/translate-readme/index.ts +++ b/scripts/translate-readme/index.ts @@ -75,12 +75,13 @@ const LANGUAGE_NAMES: Record = { nl: "Dutch", tr: "Turkish", uk: "Ukrainian", + ur: "Urdu", vi: "Vietnamese", id: "Indonesian", th: "Thai", + tl: "Tagalog", hi: "Hindi", bn: "Bengali", - ur: "Urdu", ro: "Romanian", sv: "Swedish", it: "Italian", @@ -366,11 +367,12 @@ export async function translateReadme( const translationResults = await runWithConcurrency(languages, parallel, translateLang); results.push(...translationResults); + const latestCache = await readCache(cachePath); const newCache: TranslationCache = { sourceHash, lastUpdated: new Date().toISOString(), translations: { - ...(isHashMatch ? cache?.translations : {}), + ...(latestCache?.sourceHash === sourceHash ? latestCache.translations : {}), ...Object.fromEntries( results.filter(r => r.success && !r.cached).map(r => [ r.language, diff --git a/src/services/worker/README.md b/src/services/worker/README.md index d886b84e3..a0d3fefb3 100644 --- a/src/services/worker/README.md +++ b/src/services/worker/README.md @@ -1,155 +1,42 @@ -# Worker Service Architecture +# Worker Service -## Overview +The worker is the local HTTP runtime used by hooks, the viewer, MCP search, and +background observation generation. It is built into `plugin/scripts/worker-service.cjs` +and managed by Bun. -The Worker Service is an Express HTTP server that handles all claude-mem operations. It runs on port 37777 (configurable via `CLAUDE_MEM_WORKER_PORT`) and is managed by PM2. +The port comes from `CLAUDE_MEM_WORKER_PORT`; if unset, the default is +`37700 + (uid % 100)`. The host comes from `CLAUDE_MEM_WORKER_HOST` and defaults +to `127.0.0.1`. -## Request Flow +## Main Routes -``` -Hook (plugin/scripts/*-hook.js) - → HTTP Request to Worker (localhost:37777) - → Route Handler (http/routes/*.ts) - → MCP Server Tool (for search) OR Service Layer (for session/data) - → Database (SQLite3 + Chroma vector DB) -``` +- `GET /health` - worker health and version status +- `GET /` - viewer UI +- `GET /stream` - server-sent events for live viewer updates +- `/api/settings` - user settings and dependency health +- `/api/mcp/*` - MCP enable/disable status +- `/api/observations`, `/api/summaries`, `/api/prompts`, `/api/projects` - stored data +- `/api/search`, `/api/timeline`, `/api/context/*` - search and context preview/injection +- `/api/corpus/*` - knowledge-agent corpora +- `/api/logs` - local worker logs +- `/api/chroma/status` - Chroma integration status -## Directory Structure +There are no worker HTTP endpoints for switching git branches. Non-stable +release lines are run from source; see `docs/public/branches.mdx`. -``` -src/services/worker/ -├── README.md # This file -├── WorkerService.ts # Slim orchestrator (~150 lines) -├── http/ # HTTP layer -│ ├── middleware.ts # Shared middleware (logging, CORS, etc.) -│ └── routes/ # Route handlers organized by feature area -│ ├── SessionRoutes.ts # Session lifecycle (init, observations, summarize, complete) -│ ├── DataRoutes.ts # Data retrieval (get observations, summaries, prompts, stats) -│ ├── SearchRoutes.ts # Search/MCP proxy (all search endpoints) -│ ├── SettingsRoutes.ts # Settings, MCP toggle, branch switching -│ └── ViewerRoutes.ts # Health check, viewer UI, SSE stream -└── services/ # Business logic services (existing, NO CHANGES in Phase 1) - ├── DatabaseManager.ts # SQLite connection management - ├── SessionManager.ts # Session state tracking - ├── SDKAgent.ts # Claude Agent SDK for observations/summaries - ├── SSEBroadcaster.ts # Server-Sent Events for real-time updates - ├── PaginationHelper.ts # Query pagination utilities - ├── SettingsManager.ts # User settings CRUD - └── BranchManager.ts # Git branch operations -``` +## Route Layout -## Route Organization +Route handlers live in `src/services/worker/http/routes/`: -### ViewerRoutes.ts -- `GET /health` - Health check endpoint -- `GET /` - Serve viewer UI (React app) -- `GET /stream` - SSE stream for real-time updates +- `ViewerRoutes.ts` +- `SettingsRoutes.ts` +- `SessionRoutes.ts` +- `DataRoutes.ts` +- `SearchRoutes.ts` +- `CorpusRoutes.ts` +- `MemoryRoutes.ts` +- `LogsRoutes.ts` +- `ChromaRoutes.ts` -### SessionRoutes.ts -Session lifecycle operations (use service layer directly): -- `POST /sessions/init` - Initialize new session -- `POST /sessions/:sessionId/observations` - Add tool usage observations -- `POST /sessions/:sessionId/summarize` - Trigger session summary -- `GET /sessions/:sessionId/status` - Get session status -- `DELETE /sessions/:sessionId` - Delete session -- `POST /sessions/:sessionId/complete` - Mark session complete -- `POST /sessions/claude-id/:claudeId/observations` - Add observations by claude_id -- `POST /sessions/claude-id/:claudeId/summarize` - Summarize by claude_id -- `POST /sessions/claude-id/:claudeId/complete` - Complete by claude_id - -### DataRoutes.ts -Data retrieval operations (use service layer directly): -- `GET /observations` - List observations (paginated) -- `GET /summaries` - List session summaries (paginated) -- `GET /prompts` - List user prompts (paginated) -- `GET /observations/:id` - Get observation by ID -- `GET /sessions/:sessionId` - Get session by ID -- `GET /prompts/:id` - Get prompt by ID -- `GET /stats` - Get database statistics -- `GET /projects` - List all projects -- `GET /processing` - Get processing status -- `POST /processing` - Set processing status - -### SearchRoutes.ts -All search operations (proxy to MCP server): -- `GET /search` - Unified search (observations + sessions + prompts) -- `GET /timeline` - Unified timeline context -- `GET /decisions` - Decision-type observations -- `GET /changes` - Change-related observations -- `GET /how-it-works` - How-it-works explanations -- `GET /search/observations` - Search observations -- `GET /search/sessions` - Search sessions -- `GET /search/prompts` - Search prompts -- `GET /search/by-concept` - Find by concept tag -- `GET /search/by-file` - Find by file path -- `GET /search/by-type` - Find by observation type -- `GET /search/recent-context` - Get recent context -- `GET /search/context-timeline` - Get context timeline -- `GET /context/preview` - Preview context -- `GET /context/inject` - Inject context -- `GET /search/timeline-by-query` - Timeline by search query -- `GET /search/help` - Search help - -### SettingsRoutes.ts -Settings and configuration (use service layer directly): -- `GET /settings` - Get user settings -- `POST /settings` - Update user settings -- `GET /mcp/status` - Get MCP server status -- `POST /mcp/toggle` - Toggle MCP server on/off -- `GET /branch/status` - Get git branch info -- `POST /branch/switch` - Switch git branch -- `POST /branch/update` - Pull branch updates - -## Current State (Phase 1) - -**Phase 1** is a pure code reorganization with ZERO functional changes: -- Extract route handlers from WorkerService.ts monolith -- Organize into logical route classes -- Keep all existing behavior identical - -**MCP vs Direct DB Split** (inherited, not changed in Phase 1): -- Search operations → MCP server (mem-search) -- Session/data operations → Direct DB access via service layer - -## Future Phase 2 - -Phase 2 will unify the architecture: -1. Expand MCP server to handle ALL operations (not just search) -2. Convert all route handlers to proxy through MCP -3. Move database logic from service layer into MCP tools -4. Result: Worker becomes pure HTTP → MCP proxy for maximum portability - -This separation allows the worker to be deployed anywhere (as a CLI tool, cloud service, etc.) without carrying database dependencies. - -## Adding New Endpoints - -1. Choose the appropriate route file based on the endpoint's purpose -2. Add the route handler method to the class -3. Register the route in the `setupRoutes()` method -4. Import any needed services in the constructor -5. Follow the existing patterns for error handling and logging - -Example: -```typescript -// In DataRoutes.ts -private async handleGetFoo(req: Request, res: Response): Promise { - try { - const result = await this.dbManager.getFoo(); - res.json(result); - } catch (error) { - logger.failure('WORKER', 'Get foo failed', {}, error as Error); - res.status(500).json({ error: (error as Error).message }); - } -} - -// Register in setupRoutes() -app.get('/foo', this.handleGetFoo.bind(this)); -``` - -## Key Design Principles - -1. **Progressive Disclosure**: Navigate from high-level (WorkerService.ts) to specific routes to implementation details -2. **Single Responsibility**: Each route class handles one feature area -3. **Dependency Injection**: Route classes receive only the services they need -4. **Consistent Error Handling**: All handlers use try/catch with logger.failure() -5. **Bound Methods**: All route handlers use `.bind(this)` to preserve context +Keep new endpoints in the nearest existing route class unless the behavior is a +new top-level API area.