Claude Code के लिए Recall का उपयोग कैसे करें

Claude Code memory के लिए Recall क्या करता है

Recall एक Claude Code plugin है जो प्रत्येक project को sessions के बीच याददाश्त (memory) प्रदान करता है। यह आपके project के अंदर एक .recall/ folder में दो markdown files लिखता है: एक append-only log जिसमें पिछली गतिविधियों का विवरण होता है, और एक संक्षिप्त सारांश कि आपने काम कहाँ छोड़ा था। ये दोनों files आपकी मशीन पर ही एक local Python summarizer द्वारा बनाई जाती हैं, इसलिए इस memory के लिए कोई API tokens खर्च नहीं होते।

यह जिस कमी को पूरा करता है वह छोटी और निरंतर बनी रहती है। आप मंगलवार को अपने VPS पर एक session बंद करते हैं। बुधवार को, एक नया session मंगलवार की बातचीत को स्वचालित रूप से load नहीं करता है, हालाँकि Claude Code की built-in auto memory sessions के बीच notes को सुरक्षित रख सकती है। यदि उन notes में यह जानकारी नहीं है कि आपने काम कहाँ रोका था, तो आप या तो project को मैन्युअल रूप से फिर से समझाते हैं, या model को इसे समझने के लिए repository का आधा हिस्सा फिर से पढ़ने देते हैं। दोनों ही स्थितियों में tokens खर्च होते हैं, और दूसरी स्थिति में बहुत अधिक tokens खर्च होते हैं।

Recall version 0.4.0, जिसे 18 July 2026 को release किया गया था, October 2026 तक भी नवीनतम release है, और यह project MIT licensed है। यह एक plugin है। इसमें ऐसा कुछ भी नहीं है जो network call करता हो।

VPS पर आपको किन चीजों की आवश्यकता है

Recall के capture hooks वे Python scripts हैं जो plugin के साथ आती हैं। इसमें कोई third-party dependency नहीं है, इसलिए एकमात्र वास्तविक आवश्यकता एक interpreter है।

python3 -V

Ubuntu 24.04, Python 3.12.3 का उत्तर देता है। Recall, Python 3.9 और उसके बाद के संस्करणों को सपोर्ट करता है। Minimal container images में कभी-कभी कोई interpreter नहीं होता, और ऐसी स्थिति में shell, python3: command not found का उत्तर देता है। आगे बढ़ने से पहले एक interpreter install करें।

sudo apt update && sudo apt install -y python3

NumPy, summarizer के एक चरण के लिए एक वैकल्पिक accelerator है। आपको इसकी आवश्यकता नहीं है।

python3 -c "import numpy"

ModuleNotFoundError: No module named 'numpy' यहाँ एक स्वीकार्य उत्तर है। Summarizer में एक pure-Python path मौजूद है, और project की test suite यह सुनिश्चित करती है कि दोनों paths एक ही sentences का चयन करें।

Server पर session memory, laptop की तुलना में अधिक मायने रखती है, क्योंकि server का काम कई दिनों तक फैले छोटे-छोटे visits में आता है। यदि आपके पास पहले से ही VPS पर tmux में Claude Code चल रहा है, तो Recall वह घटक है जो कल के session को आज तक लेकर आता है।

Plugin marketplace से Recall इंस्टॉल करें

Claude Code session के भीतर टाइप की गई दो commands:

/plugin marketplace add raiyanyahya/recall
/plugin install recall@recall

दूसरी command plugin@marketplace पढ़ती है। यहाँ दोनों नाम recall हैं, जो copy-paste की गलती लग सकती है, लेकिन यह गलती नहीं है।

plugin की अपनी एक command चलाकर इंस्टॉलेशन की जाँच करें:

/recall:show

/recall:show वर्तमान सारांश (summary) प्रिंट करता है। बिल्कुल नए प्रोजेक्ट पर अभी प्रिंट करने के लिए कुछ नहीं है, इसलिए आप वास्तव में यह जाँच रहे हैं कि command मौजूद है या नहीं। यदि Claude Code /recall:show को नहीं पहचानता है, तो plugin लोड नहीं हुआ है और कोई भी hook सक्रिय नहीं होगा।

इसके बजाय checkout से चलाने के लिए, repository को clone करें और पहले उसे validate करें:

git clone https://github.com/raiyanyahya/recall ~/recall
cd ~/recall && claude plugin validate .

claude plugin validate ., .claude-plugin/ में मौजूद manifest को पढ़ता है और रिपोर्ट करता है कि क्या plugin सही ढंग से बना है। फिर अपने प्रोजेक्ट डायरेक्टरी से claude --plugin-dir ~/recall के साथ Claude Code शुरू करें।

हुक क्या लिखते हैं और कब

Recall तीन Claude Code हुक रजिस्टर करता है। प्रत्येक हुक प्लगइन डायरेक्टरी से एक Python स्क्रिप्ट चलाता है।

• SessionStart स्टार्टअप, रिज्यूम और क्लियर होने पर चलता है। यह context.md को सामने लाता है ताकि सेशन आपके सारांश (summary) के साथ खुले।
• Stop हर बार चलता है जब Claude अपना रिस्पॉन्स पूरा करता है। यह उस टर्न को लॉग में जोड़ देता है।
• SessionEnd सेशन बंद होने पर चलता है, और यह सारांश को दोबारा जनरेट कर सकता है।

इसके परिणामस्वरूप दो फाइलें बनती हैं, जो दोनों .recall/ के अंदर होती हैं।

• history.md केवल-अपेंड (append-only) रिकॉर्ड है: प्रॉम्प्ट्स, रिस्पॉन्स, छुई गई फाइलें और चलाए गए कमांड्स।
• context.md जनरेट किया गया डाइजेस्ट है: लक्ष्य, सारांश, अगले चरण, छुई गई फाइलें, चलाए गए कमांड्स और git कॉन्टेक्स्ट।

एक वास्तविक सेशन के बाद, डायरेक्टरी को देखें।

ls -la .recall/

यदि कैप्चर इनेबल्ड है, कोई पॉज मार्कर नहीं है और ट्रांसक्रिप्ट उपलब्ध है, तो आपको history.md में कंटेंट दिखना चाहिए। हो सकता है कि आपको context.md बिल्कुल न दिखे, और यह कोई त्रुटि नहीं बल्कि डिफ़ॉल्ट व्यवहार है। auto_save_context का मान off होता है जब तक आप इसे सेट न करें, इसलिए सारांश केवल तभी लिखा जाता है जब आप इसके लिए कहते हैं:

/recall:save

यह कमांड history.md पर लोकल समराइज़र चलाता है और context.md को फिर से लिखता है। एल्गोरिदम TF-IDF (term frequency, inverse document frequency) स्कोरिंग है जो TextRank सेंटेंस रैंकिंग को इनपुट देता है। यह डिटरमिनिस्टिक और एक्सट्रैक्टिव है, जिसका अर्थ है कि यह उन वाक्यों को चुनता है जो आपके लॉग में पहले से मौजूद हैं। इसमें किसी मॉडल को कॉल नहीं किया जाता है, इसलिए यह स्टेप फ्री है और मशीन के ऑफलाइन होने पर भी काम करता है।

एक प्रोजेक्ट के लिए Recall कॉन्फ़िगर करें

कॉन्फ़िगरेशन प्रोजेक्ट रूट में स्थित एक recall.config.json फ़ाइल में रहता है। ये इसके डिफ़ॉल्ट सेटिंग्स हैं:

{
  "output_dir": ".recall",
  "capture_history": true,
  "summary_sentences": 8,
  "redact": true,
  "include_git": true,
  "max_input_chars": 200000
}

• output_dir यह निर्धारित करता है कि दोनों फ़ाइलें कहाँ स्थित होंगी। इसे प्रोजेक्ट के अंदर ही रखें।
• capture_history यह history.md लॉग को चालू या बंद करता है।
• auto_save_context यह off या on_end को स्वीकार करता है, और डिफ़ॉल्ट रूप से off पर सेट रहता है।
• summary_sentences यह निर्धारित करता है कि कितनी वाक्य context.md में सुरक्षित रहेंगे। इसे बढ़ाने से सारांश लंबा हो जाता है और सेशन शुरू होने पर लोड थोड़ा बढ़ जाता है।
• redact यह डिस्क पर कुछ भी लिखने से पहले सामान्य सीक्रेट पैटर्न को हटा देता है।
• include_git यह वर्तमान डिफ आँकड़ों और हालिया कमिट्स को सारांश में जोड़ता है।
• max_input_chars यह सीमित करता है कि सारांश बनाने वाला एक बार में history.md का कितना हिस्सा पढ़ सकता है।

VPS पर चल रहे प्रोजेक्ट के लिए सबसे उपयोगी बदलाव ऑटोमैटिक सेविंग है, क्योंकि सर्वर पर सेशन अक्सर टर्मिनल बंद होने पर समाप्त हो जाता है, न कि तब जब आप उसे रोकना चाहते हैं।

{
  "auto_save_context": "on_end",
  "summary_sentences": 12
}

कॉन्फ़िगरेशन को छुए बिना कुछ समय के लिए कैप्चर रोकने हेतु, पॉज़ मार्कर बनाएँ। कैप्चरिंग फिर से शुरू करने के लिए इसे हटा दें।

touch .recall/.capture-paused

ऐसा उस सेशन से पहले करें जहाँ आप प्रोडक्शन क्रेडेंशियल्स को हैंडल करते हैं, क्योंकि रिडक्शन (redaction) एक फ़िल्टर है, गारंटी नहीं। यही तर्क सामान्य रूप से AI एजेंट्स से सीक्रेट्स को दूर रखने के पीछे भी है: सबसे सुरक्षित सीक्रेट वह है जिसे एजेंट कभी नहीं देखता।

Recall tokens की कितनी बचत करता है?

यह इस पर निर्भर करता है कि विकल्प क्या था। सत्र (session) की शुरुआत में summary लोड करना सस्ता है। यह जिस चीज़ की जगह लेता है, वह महंगी हो सकती है, क्योंकि आपके प्रोजेक्ट की memory न होने पर model फाइलों को पढ़कर उसे फिर से खोजता है।

[
  {
    "label": "Recall context.md",
    "char_count": "4,800",
    "est_tokens": "1,200"
  },
  {
    "label": "Hand-written CLAUDE.md",
    "char_count": "3,200",
    "est_tokens": "800"
  },
  {
    "label": "Re-reading the repo",
    "char_count": "120,000",
    "est_tokens": "30,000"
  },
  {
    "label": "Full transcript replay",
    "char_count": "340,000",
    "est_tokens": "85,000"
  }
]

ये एक मध्यम आकार के प्रोजेक्ट के लिए सामान्य आंकड़े हैं, न कि आपके प्रोजेक्ट का मापन। एक Recall summary लगभग 1,200 tokens पर लोड होती है, जो resume के लिए प्रोजेक्ट के एक से दो हजार tokens के घोषित दावे के अनुरूप है। पिछले पूरे transcript को फिर से चलाने पर पूरी बातचीत फिर से लोड होती है, जो लगभग 85,000 tokens के दायरे में आती है। model को फाइलों को पढ़कर प्रोजेक्ट को फिर से खोजने देने का विकल्प इन दोनों के बीच, लगभग 30,000 tokens के करीब होता है, और यह संख्या repository के साथ बढ़ती जाती है। CLAUDE.md पंक्ति पैमाने के लिए है: यह सस्ता है क्योंकि यह संक्षिप्त और static है, और यह model को पिछली रात क्या हुआ था, यह बताने के बजाय आपके स्थायी नियम बताता है।

अपने स्वयं के आंकड़े मापें। एक token अंग्रेजी गद्य के लगभग चार अक्षरों के बराबर होता है, और code के लिए थोड़ा कम। यदि आप उसी VPS पर स्थानीय model को भी summary देते हैं, तो resume पर भरोसा करने से पहले उस window की जाँच करें जिसमें यह लोड हो रहा है, क्योंकि Ollama की डिफ़ॉल्ट context length उपलब्ध VRAM पर निर्भर करती है।

wc -c .recall/context.md .recall/history.md
echo $(( $(wc -c < .recall/context.md) / 4 ))

एक सत्र के भीतर, /context दिखाता है कि अभी context window में क्या लोड है, और /cost सत्र के कुल योग की रिपोर्ट करता है। एक सत्र को बिना किसी पूर्व डेटा के शुरू करें, अगले को summary के साथ शुरू करें, और तुलना करें। सत्र के tokens वास्तव में कहाँ खर्च होते हैं, इसकी पूरी तस्वीर के लिए, Claude Code tokens कैसे खर्च करता है में इसका विवरण दिया गया है।

एक चेतावनी इस दावे को निष्पक्ष रखती है। summary हर सत्र की शुरुआत में लोड की जाती है, इसलिए जिस summary पर आप कभी काम नहीं करते, वह बचत के बजाय एक छोटा सा अतिरिक्त खर्च है। summary_sentences को डिफ़ॉल्ट के करीब रखें, जब तक कि आपके सत्र बहुत लंबे न चलते हों। एक शांत सत्र दूसरी तरफ मदद करता है, क्योंकि सबसे छोटे संभव बदलाव की ओर प्रेरित agent summarizer के लिए रैंक करने हेतु एक छोटा log छोड़ता है।

बिना session के summary को फिर से बनाना

यदि आपने repository को clone किया है, तो summarizer का अपना command line entry point होता है। यह VPS पर तब उपयोगी होता है जब terminal के साथ session समाप्त हो गया हो और आप फिर भी digest प्राप्त करना चाहते हैं।

python3 ~/recall/scripts/make_context.py --help

Help output उन flags की सूची दिखाता है जिन्हें यह स्वीकार करता है: project root के लिए --cwd, स्पष्ट transcript file के लिए --transcript, output को दबाने के लिए --quiet, और claude तथा opencode के बीच चयन करने के लिए --harness। इसे एक project पर point करें:

python3 ~/recall/scripts/make_context.py --cwd /srv/projects/api

यह session transcript और history.md को पढ़ता है, और फिर आपके द्वारा pass की गई directory के अंतर्गत context.md लिखता है। यदि आपने marketplace के माध्यम से install किया है, तो plugin उस directory में रहता है जिसे Claude Code manage करता है, और वही काम करने का समर्थित तरीका /recall:save है।

कुछ भी क्यों नहीं लिखा जा रहा है

पूर्ण सत्र के बाद कोई .recall/ निर्देशिका नहीं है। यह निष्कर्ष निकालने से पहले कि हुक कभी नहीं चले, जाँचें कि क्या कैप्चर अक्षम है, आउटपुट निर्देशिका कहीं और कॉन्फ़िगर की गई है, या कोई ट्रांसक्रिप्ट नहीं मिली है। प्लगइन लोड है या नहीं यह पुष्टि करने के लिए /recall:show टाइप करें, फिर python3 -V चलाएँ। हुक कमांड पहले python3 और फिर python का प्रयास करता है, इसलिए जिस बॉक्स में इनमें से कोई भी नहीं है, वह stderr और एग्जिट स्टेटस 127 के साथ विफल हो जाता है। Claude Code एक नॉन-ब्लॉकिंग हुक त्रुटि सूचना दिखाता है जिसमें stderr की पहली पंक्ति होती है।

history.md बढ़ता है लेकिन context.md कभी नहीं बदलता है। auto_save_context डिफ़ॉल्ट रूप से off है। /recall:save चलाएँ, या की (key) को on_end पर सेट करें और SessionEnd हुक को इसे करने दें।

फ़ाइलें गलत प्रोजेक्ट के अंतर्गत दिखाई देती हैं। Recall उस निर्देशिका के सापेक्ष लिखता है जहाँ से Claude Code शुरू किया गया था, इसलिए अपनी होम निर्देशिका से सत्र शुरू करने पर मेमोरी वहीं चली जाती है। प्रोजेक्ट रूट से शुरू करें, और फ़ाइलें वास्तव में कहाँ गईं यह पता लगाने के लिए ls -la .recall/ का उपयोग करें।

कैप्चर रुक गया और आपको कोई चेतावनी नहीं मिली। ls -a .recall/ के साथ पॉज़ मार्कर की जाँच करें। आपके द्वारा पिछले सप्ताह बनाई गई .capture-paused फ़ाइल अभी भी अपना काम कर रही है।

लंबे सत्र के बाद सारांश संक्षिप्त है। max_input_chars सारांशक इनपुट को 200000 वर्णों पर सीमित करता है, इसलिए बहुत लंबा लॉग कट जाता है। इसे रोटेट करें।

mv .recall/history.md .recall/history-2026-07-30.md

इसके बाद एक छोटा सत्र चलाएँ और पुष्टि करने के लिए कि एक नया history.md दिखाई दिया है, फिर से ls -la .recall/ की जाँच करें।

Recall कहाँ रुकता है

Recall एक लॉग और एक समराइज़र है, और यह स्पष्ट होना आवश्यक है कि यह क्या छोड़ देता है।

समराइज़र एक्सट्रैक्टिव (extractive) है। TextRank उन वाक्यों को चुनता है जो पहले से ही history.md में मौजूद हैं, इसलिए यह कभी यह नहीं परखता कि कोई निर्णय सही था या नहीं। मंगलवार को रिकॉर्ड किया गया एक गलत निर्णय बुधवार को एक अच्छे निर्णय जैसा ही दिखता है। जब दांव पर कुछ महत्वपूर्ण हो, तो context.md को पढ़ें और उसे हाथ से ठीक करें। यह एक markdown फ़ाइल है और इसे संपादित करने से आपको कोई नहीं रोकता।

इसमें कोई सर्च सुविधा नहीं है। आपको प्रति प्रोजेक्ट एक वर्तमान सारांश और एक बढ़ता हुआ लॉग मिलता है, न कि प्रोजेक्ट्स के बीच क्वेरी करने योग्य मेमोरी। यदि प्रश्न यह है कि आपने तीन सप्ताह पहले डेटाबेस के बारे में क्या निर्णय लिया था, तो आप history.md को grep कर रहे होंगे। यह लाइव समन्वय प्रदान नहीं करता है: एक ही प्रोजेक्ट में दो सेशन लॉग फ़ाइल साझा करते हैं, लेकिन Recall दूसरे सेशन के कॉन्टेक्स्ट में नई लॉग प्रविष्टियाँ पुश नहीं करता है। इसलिए जब एक को यह जानने की आवश्यकता होती है कि दूसरा क्या कर रहा है, तो सेशन सीधे आपस में टेक्स्ट पास कर सकते हैं जब वे चल रहे हों।

यह एक सेशन के भीतर मदद नहीं करता है। सेशन के बीच में कॉन्टेक्स्ट विंडो का भर जाना एक अलग समस्या है जिसके अलग समाधान हैं, और एक सेशन के भीतर कॉन्टेक्स्ट विंडो को मैनेज करना इस गाइड का पूरक हिस्सा है।

सारांश को डिज़ाइन के अनुसार अनट्रस्टेड इनपुट माना जाता है। context.md को फेंस और लेबल करके इंजेक्ट किया जाता है, और Claude उस पर भरोसा करने से पहले पूछता है। यह डिज़ाइन इसलिए मौजूद है क्योंकि एक कमिट किया गया .recall/ डायरेक्टरी ऐसी जगह है जहाँ कमिट एक्सेस वाला कोई भी व्यक्ति ऐसा टेक्स्ट लिख सकता है जिसे आपका एजेंट पढ़ेगा। एजेंट जो पढ़ता है उसके बारे में पूछने के लिए कितना रुकता है, यह उस परमिशन मोड द्वारा सेट किया जाता है जिसमें सेशन शुरू होता है। Claude Code v2.1.283 या बाद के वर्ज़न के साथ, ऑटो मोड सभी प्लान और प्रोवाइडर पर इंटरैक्टिव टर्मिनल और VS Code सेशन के लिए पहले से ही इन-बिल्ट स्टार्टिंग मोड है, इसलिए आपके बजाय एक क्लासिफायर अधिकांश क्रियाओं की समीक्षा करता है; HIPAA कॉन्फ़िगरेशन वाले संगठन अभी भी मैनुअल मोड में शुरू होते हैं। एक बार तय करें कि .recall/ व्यक्तिगत है या साझा: इसे व्यक्तिगत मेमोरी के लिए .gitignore में जोड़ें, या इसे कमिट करें और किसी अन्य योगदान की तरह इसकी समीक्षा करें। यदि एजेंट बिना निगरानी के चलता है, तो Claude Code को VPS पर सुरक्षित रूप से चलाना व्यापक सीमाओं को कवर करता है।

रिडैक्शन (redaction) सर्वोत्तम प्रयास है। यह API keys, tokens, PEM blocks और .env असाइनमेंट जैसे सामान्य पैटर्न को लक्षित करता है। इसे कमिट करने से पहले .recall/ को पढ़ें।

वर्ज़न नंबर परिपक्वता के बारे में ईमानदार है। 0.4.0 पर, जो अक्टूबर 2026 में भी नवीनतम रिलीज़ है, कॉन्फ़िगरेशन कीज़ और फ़ाइल लेआउट अभी भी रिलीज़ के बीच बदल सकते हैं, इसलिए जिस सेटअप पर आप निर्भर हैं उसे अपग्रेड करने से पहले changelog पढ़ें।

FAQ

क्या Recall मेरा कोड या ट्रांसक्रिप्ट कहीं भेजता है?

नहीं। कैप्चर हुक और समराइज़र Python स्क्रिप्ट हैं जो आपकी अपनी मशीन पर चलती हैं। प्लगइन के पास कोई API key नहीं होती और यह कोई नेटवर्क कॉल नहीं करता है। समरी बनाने के लिए किसी मॉडल के बजाय TF-IDF और TextRank का उपयोग किया जाता है, इसलिए इस प्रक्रिया में कोई लागत नहीं आती और यह मशीन के ऑफलाइन होने पर भी काम करती है। इसका परिणाम यह है कि समरी 'एक्सट्रैक्टिव' (extractive) होती है: यह नए वाक्य लिखने के बजाय आपके लॉग से ही वाक्य चुनती है।

मेरा .recall/context.md गायब या पुराना क्यों है?

auto_save_context का डिफ़ॉल्ट मान off है, इसलिए समरी केवल तब रीजेनरेट होती है जब आप /recall:save चलाते हैं। प्रत्येक सत्र (session) के समाप्त होने पर इसे फिर से लिखने के लिए recall.config.json में "auto_save_context": "on_end" सेट करें। यदि history.md भी गायब है, तो capture_history, .capture-paused मार्कर और यह जाँचें कि क्या सत्र का ट्रांसक्रिप्ट उपलब्ध है: इन मामलों में रनिंग हुक हिस्ट्री लिखना छोड़ देते हैं। /recall:show के साथ पुष्टि करें कि प्लगइन लोड हो गया है, फिर पुष्टि करें कि उस बॉक्स पर python3 -V उत्तर देता है, क्योंकि हुक Python स्क्रिप्ट हैं।

Recall प्रति सत्र कितनी बचत करता है?

एक समरी लोड करने की लागत लगभग 1,200 टोकन होती है, जबकि उस मॉडल के लिए यह 30,000 टोकन होती है जिसे यह पता लगाने के लिए कि वह कहाँ है, आपके रिपॉजिटरी को फिर से पढ़ना पड़ता है। ये सामान्य आंकड़े हैं। wc -c .recall/context.md और सत्र के भीतर /context कमांड का उपयोग करके अपना माप लें, और कोल्ड स्टार्ट की तुलना समरी से रिज्यूम होने वाले स्टार्ट से करें।

क्या मुझे अभी भी CLAUDE.md फ़ाइल की आवश्यकता है?

हाँ, और दोनों अलग-अलग काम करते हैं। CLAUDE.md वह है जिसे आप जानबूझकर लिखते हैं: स्थायी नियम और बिल्ड कमांड। context.md पिछले सत्र में वास्तव में जो हुआ, उससे जनरेट होता है, इसलिए इसमें वह अधूरा माइग्रेशन होता है जिसे आप शायद कभी लिखने के बारे में न सोचें। दोनों को रखें।

क्या एक VPS कई प्रोजेक्ट्स की मेमोरी रख सकता है?

हाँ। Recall प्रत्येक प्रोजेक्ट डायरेक्टरी के भीतर .recall/ में मेमोरी रखता है, इसलिए एक ही सर्वर पर दो प्रोजेक्ट्स के लॉग और समरी अलग-अलग रहते हैं। हर बार प्रोजेक्ट रूट से Claude Code शुरू करें, क्योंकि फ़ाइलें वर्किंग डायरेक्टरी का अनुसरण करती हैं, न कि यूजर अकाउंट का।