Skip to content

Latest commit

 

History

History
430 lines (315 loc) · 28.1 KB

File metadata and controls

430 lines (315 loc) · 28.1 KB

🌐 यह एक स्वचालित अनुवाद है। समुदाय से सुधार का स्वागत है!

🇨🇳 中文🇹🇼 繁體中文🇯🇵 日本語🇵🇹 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 Version Node Mentioned in Awesome Claude Code

thedotmack/claude-mem | Trendshift


Claude-Mem Preview Star History Chart

त्वरित शुरुआतयह कैसे काम करता हैखोज उपकरणदस्तावेज़ीकरणकॉन्फ़िगरेशनसमस्या निवारणलाइसेंस

Claude-Mem स्वचालित रूप से टूल उपयोग अवलोकनों को कैप्चर करके, सिमेंटिक सारांश उत्पन्न करके, और उन्हें भविष्य के सत्रों के लिए उपलब्ध कराकर सत्रों में संदर्भ को निर्बाध रूप से संरक्षित करता है। यह Claude को परियोजनाओं के बारे में ज्ञान की निरंतरता बनाए रखने में सक्षम बनाता है, भले ही सत्र समाप्त हो जाएं या पुनः कनेक्ट हो जाएं।


त्वरित शुरुआत

एक ही कमांड से इंस्टॉल करें:

npx claude-mem install

या OpenCode के लिए इंस्टॉल करें:

npx claude-mem install --ide opencode

या Antigravity CLI के लिए इंस्टॉल करें (सेटअप गाइड):

npx claude-mem install --ide antigravity

या Claude Code के अंदर प्लगइन मार्केटप्लेस से इंस्टॉल करें:

/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 gateways पर claude-mem को स्थायी मेमोरी प्लगइन के रूप में इंस्टॉल करें:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

इंस्टॉलर डिपेंडेंसीज़, प्लगइन सेटअप, AI प्रोवाइडर कॉन्फ़िगरेशन, worker स्टार्टअप, और Telegram, Discord, Slack, और अन्य प्लेटफ़ॉर्म्स पर वैकल्पिक रीयल-टाइम अवलोकन फ़ीड को संभालता है। विवरण के लिए OpenClaw एकीकरण गाइड देखें।

मुख्य विशेषताएं:

  • 🧠 स्थायी मेमोरी - संदर्भ सत्रों में बना रहता है
  • 📊 प्रगतिशील प्रकटीकरण - टोकन लागत दृश्यता के साथ स्तरित मेमोरी पुनर्प्राप्ति
  • 🔍 स्किल-आधारित खोज - mem-search स्किल के साथ अपने प्रोजेक्ट इतिहास को क्वेरी करें
  • 🖥️ वेब व्यूअर UI - स्टार्टअप पर प्रिंट किए गए worker URL पर रीयल-टाइम मेमोरी स्ट्रीम
  • 💻 Claude Desktop स्किल - Claude Desktop वार्तालापों से मेमोरी खोजें
  • 🔒 गोपनीयता नियंत्रण - संवेदनशील सामग्री को स्टोरेज से बाहर रखने के लिए <private> टैग का उपयोग करें
  • ⚙️ संदर्भ कॉन्फ़िगरेशन - किस संदर्भ को इंजेक्ट किया जाता है, इस पर सूक्ष्म नियंत्रण
  • 🤖 स्वचालित संचालन - मैन्युअल हस्तक्षेप की आवश्यकता नहीं
  • 🔗 उद्धरण - worker API के माध्यम से IDs के साथ पिछले अवलोकनों का संदर्भ दें या वेब व्यूअर में सभी देखें

दस्तावेज़ीकरण

📚 पूर्ण दस्तावेज़ीकरण देखें - आधिकारिक वेबसाइट पर ब्राउज़ करें

शुरुआत करना

सर्वोत्तम अभ्यास

आर्किटेक्चर

कॉन्फ़िगरेशन और विकास


यह कैसे काम करता है

मुख्य घटक:

  1. 5 जीवनचक्र Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook स्क्रिप्ट)
  2. स्मार्ट इंस्टॉल - कैश्ड डिपेंडेंसी चेकर (pre-hook स्क्रिप्ट, जीवनचक्र hook नहीं)
  3. Worker सेवा - वेब व्यूअर UI और खोज endpoints के साथ लोकल HTTP API, Bun द्वारा प्रबंधित
  4. SQLite डेटाबेस - सत्र, अवलोकन, सारांश संग्रहीत करता है
  5. mem-search स्किल - प्रगतिशील प्रकटीकरण के साथ प्राकृतिक भाषा क्वेरी
  6. Chroma वेक्टर डेटाबेस - बुद्धिमान संदर्भ पुनर्प्राप्ति के लिए हाइब्रिड सिमेंटिक + कीवर्ड खोज

विवरण के लिए आर्किटेक्चर अवलोकन देखें।


MCP खोज उपकरण

Claude-Mem एक टोकन-कुशल 3-लेयर वर्कफ़्लो पैटर्न का पालन करते हुए 4 MCP टूल्स के माध्यम से बुद्धिमान मेमोरी खोज प्रदान करता है:

3-लेयर वर्कफ़्लो:

  1. search - IDs के साथ कॉम्पैक्ट इंडेक्स प्राप्त करें (~50-100 टोकन/परिणाम)
  2. timeline - दिलचस्प परिणामों के आसपास कालानुक्रमिक संदर्भ प्राप्त करें
  3. get_observations - केवल फ़िल्टर किए गए IDs के लिए पूर्ण विवरण प्राप्त करें (~500-1,000 टोकन/परिणाम)

यह कैसे काम करता है:

  • Claude आपकी मेमोरी खोजने के लिए MCP टूल्स का उपयोग करता है
  • परिणामों का एक इंडेक्स प्राप्त करने के लिए search से शुरू करें
  • विशिष्ट अवलोकनों के आसपास क्या हो रहा था यह देखने के लिए timeline का उपयोग करें
  • प्रासंगिक IDs के लिए पूर्ण विवरण प्राप्त करने के लिए get_observations का उपयोग करें
  • विवरण प्राप्त करने से पहले फ़िल्टर करके ~10x टोकन बचत

उपलब्ध MCP टूल्स:

  1. search - पूर्ण-पाठ क्वेरी के साथ मेमोरी इंडेक्स खोजें, प्रकार/तिथि/प्रोजेक्ट के अनुसार फ़िल्टर करें
  2. timeline - किसी विशिष्ट अवलोकन या क्वेरी के आसपास कालानुक्रमिक संदर्भ प्राप्त करें
  3. get_observations - IDs द्वारा पूर्ण अवलोकन विवरण प्राप्त करें (हमेशा कई IDs को बैच करें)

उपयोग उदाहरण:

// चरण 1: इंडेक्स के लिए खोजें
search(query="authentication bug", type="bugfix", limit=10)

// चरण 2: इंडेक्स की समीक्षा करें, प्रासंगिक IDs की पहचान करें (जैसे, #123, #456)

// चरण 3: पूर्ण विवरण प्राप्त करें
get_observations(ids=[123, 456])

विस्तृत उदाहरणों के लिए खोज उपकरण गाइड देखें।


रिलीज़ ब्रांच

स्थिर रिलीज़ main से शिप होती हैं और npm पर प्रकाशित होती हैं। core-dev और community-edge शुरुआती विश्वसनीयता सुधारों और सामुदायिक एकीकरण के लिए सोर्स-रन ब्रांच हैं। ब्रांच प्रवाह और गैर-स्थिर रन निर्देशों के लिए रिलीज़ ब्रांच देखें।


सिस्टम आवश्यकताएं

  • Node.js: 20.0.0 या उच्चतर
  • Claude Code: प्लगइन समर्थन के साथ नवीनतम संस्करण
  • Bun: JavaScript रनटाइम और प्रोसेस मैनेजर (यदि गायब हो तो ऑटो-इंस्टॉल)
  • uv: वेक्टर खोज के लिए Python पैकेज मैनेजर (यदि गायब हो तो ऑटो-इंस्टॉल)
  • SQLite 3: स्थायी स्टोरेज के लिए (बंडल किया गया)

Windows सेटअप नोट्स

यदि आपको इस तरह की त्रुटि दिखाई देती है:

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 मॉडल, worker पोर्ट, डेटा डायरेक्टरी, लॉग स्तर, और संदर्भ इंजेक्शन सेटिंग्स कॉन्फ़िगर करें।

सभी उपलब्ध सेटिंग्स और उदाहरणों के लिए कॉन्फ़िगरेशन गाइड देखें।

मोड और भाषा कॉन्फ़िगरेशन

Claude-Mem CLAUDE_MEM_MODE सेटिंग के माध्यम से कई वर्कफ़्लो मोड और भाषाओं का समर्थन करता है।

यह विकल्प दोनों को नियंत्रित करता है:

  • वर्कफ़्लो व्यवहार (जैसे code, chill, investigation)
  • जनरेट किए गए अवलोकनों में उपयोग की जाने वाली भाषा

कॉन्फ़िगर कैसे करें

अपनी सेटिंग्स फ़ाइल को ~/.claude-mem/settings.json पर संपादित करें:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

मोड plugin/modes/ में परिभाषित हैं। स्थानीय रूप से सभी उपलब्ध मोड देखने के लिए:

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 को पुनः आरंभ करें।

विकास

बिल्ड निर्देश, परीक्षण, और योगदान वर्कफ़्लो के लिए विकास गाइड देखें।


समस्या निवारण

यदि समस्याओं का सामना कर रहे हैं, तो Claude को समस्या का वर्णन करें और troubleshoot स्किल स्वचालित रूप से निदान करेगी और सुधार प्रदान करेगी।

सामान्य समस्याओं और समाधानों के लिए समस्या निवारण गाइड देखें।


बग रिपोर्ट

स्वचालित जेनरेटर के साथ व्यापक बग रिपोर्ट बनाएं:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

योगदान

योगदान का स्वागत है! कृपया:

  1. रिपॉजिटरी को Fork करें
  2. एक feature ब्रांच बनाएं
  3. परीक्षणों के साथ अपने परिवर्तन करें
  4. दस्तावेज़ीकरण अपडेट करें
  5. एक Pull Request सबमिट करें

Claude-Mem तीन ब्रांच से शिप होता है: main (स्थिर), core-dev, और community-edge। केवल main npm पर प्रकाशित होता है; अन्य सोर्स से रन किए जाते हैं। रणनीति और लोकल रन निर्देशों के लिए रिलीज़ ब्रांच देखें।

योगदान वर्कफ़्लो के लिए विकास गाइड देखें।


लाइसेंस

Claude-Mem को Apache License 2.0 के तहत लाइसेंस प्राप्त है।

हमने Apache-2.0 इसलिए चुना क्योंकि स्थायी एजेंटिक मेमोरी को डेवलपर टूल्स, लोकल एजेंट्स, MCP सर्वर, एंटरप्राइज़ सिस्टम, रोबोटिक्स स्टैक्स, और प्रोडक्शन एजेंट हार्नेस में आसानी से एम्बेड करने योग्य होना चाहिए।

पूर्ण विवरण के लिए LICENSE फ़ाइल देखें। लाइसेंसिंग स्कोप और ओपन/कमर्शियल सीमा के लिए docs/license.md और docs/ip-boundary.md देखें।

Ragtime पर नोट: ragtime/ डायरेक्टरी Apache License 2.0 के तहत लाइसेंस प्राप्त है। विवरण के लिए ragtime/LICENSE देखें।


समर्थन


Claude Agent SDK के साथ निर्मित | Claude Code के साथ काम करता है | TypeScript के साथ बनाया गया


CMEM के बारे में क्या?

CMEM एक ऐसा टोकन है जिसे किसी तीसरे पक्ष द्वारा बनाया गया है लेकिन Claude-Mem के निर्माता (Alex Newman, @thedotmack) द्वारा आधिकारिक रूप से अपनाया गया है। यह टोकन विकास के लिए एक सामुदायिक उत्प्रेरक और CMEM को उन डेवलपर्स और नॉलेज वर्कर्स तक पहुंचाने का एक माध्यम है जिन्हें इसकी सबसे ज़्यादा ज़रूरत है।

आधिकारिक BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3