agentcairn

समर्थित कोडिंग एजेंटों में एक टिकाऊ स्मृति।
आपकी Markdown तिजोरी प्रामाणिक है। DuckDB बदली जा सकने वाली पुनर्प्राप्ति कैश है।

वेबसाइट · PyPI · Obsidian सहयोगी · बेंचमार्क

एक केयर्न (cairn) आने वालों के लिए रास्ता चिह्नित करता है। agentcairn कोडिंग एजेंटों के लिए यही करता है: यह आपके द्वारा उपयोग किए जाने वाले उपकरणों से टिकाऊ संदर्भ कैप्चर करता है, इसे उद्गम सहित निरीक्षण योग्य Markdown के रूप में संग्रहीत करता है, और जब किसी अन्य एजेंट को आवश्यकता होती है तो केवल सबसे प्रासंगिक अंशों को याद करता है।

प्रमाण जिसका आप निरीक्षण कर सकते हैं

स्मृति किसी व्यवस्थापक कंसोल या होस्टेड डेटाबेस के पीछे छिपी नहीं है। अलग agentcairn-obsidian सहयोगी एजेंटों के समान ही Markdown फ़ाइलों को पढ़ता है और उद्गम, मुद्रा, महत्व, अधिक्रमण, और related: लिंक को उजागर करता है।

_{Obsidian में एक वास्तविक agentcairn तिजोरी। सूची फ़ाइलों पर एक दृश्य है—कोई दूसरा स्मृति भंडार नहीं।}

डॉगफ़ूड स्नैपशॉट · 2026-07-15. 417 स्थानीय रिकॉल में, अनुरक्षक की तिजोरी ने हर बार पूरी तिजोरी लोड करने की तुलना में 262× smaller संदर्भ लौटाया—कुल मिलाकर अनुमानित 136.6M tokens of full-vault context avoided। टोकन गणना लगभग चार वर्ण प्रति टोकन का उपयोग करती है। यह बिल किए गए टोकन की बचत नहीं है, और agentcairn कोई टेलीमेट्री नहीं भेजता है।

स्थापित करें

सबसे छोटा रास्ता एक प्रथम श्रेणी का प्लगइन है। यह MCP सर्वर, स्मृति कौशल और होस्ट-विशिष्ट परिवेशी हुक को बंडल करता है—कोई अलग agentcairn पैकेज स्थापित करने की आवश्यकता नहीं है। प्लगइन uvx के माध्यम से लॉन्च होता है, इसलिए यदि uvx --version पहले से उपलब्ध नहीं है तो पहले uv स्थापित करें।

Claude Code

claude plugin marketplace add ccf/agentcairn
claude plugin install agentcairn@agentcairn

Claude Code को प्रति-मोड़ परियोजना-स्कोप्ड रिकॉल, सत्र/संघनन कैप्चर, और /agentcairn:recall, /agentcairn:remember, /agentcairn:memory, /agentcairn:savings, और /agentcairn:ingest कमांड मिलते हैं।

Codex

codex plugin marketplace add ccf/agentcairn
codex plugin add agentcairn@agentcairn

Codex को बंडल MCP उपकरण और स्मृति कौशल, लाइव-सत्यापित SessionStart रिकॉल, और cairn sweep के साथ SessionEnd कैप्चर आउट-ऑफ-बैंड बैकस्टॉप के रूप में मिलता है।

एजेंट-सहायता प्राप्त सेटअप

पहले से ही skills.sh या find-skills वर्कफ़्लो का उपयोग करते हैं? सार्वजनिक सेटअप सहायक स्थापित करें:

npx skills add ccf/agentcairn --skill agentcairn-setup -g

फिर अपने एजेंट से पूछें: Use $agentcairn-setup to preview, install, and verify AgentCairn for this coding agent.

यह केवल सेटअप मार्गदर्शन स्थापित करता है—AgentCairn रनटाइम, MCP सर्वर, प्लगइन, या हुक नहीं। सहायक उन परिवर्तनों को AgentCairn के पूर्वावलोकन-प्रथम मूल इंस्टॉलर को सौंपता है और परिणामी एकीकरण को सत्यापित करता है। ऊपर दिए गए Claude Code और Codex प्लगइन कमांड सबसे छोटा रास्ता बने हुए हैं।

डिफ़ॉल्ट तिजोरी ~/agentcairn है और पहले उपयोग पर बनाई जाती है। एक नई खाली तिजोरी में अभी तक याद करने के लिए कुछ भी उपयोगी नहीं है, इसलिए पूरे लूप को स्पष्ट रूप से साबित करें:

You   → Remember this durable fact: staging deploys use blue-green.
Agent → written and indexed
You   → Recall the staging deploy strategy.
Agent → staging deploys use blue-green.  ↳ <memory permalink>

remember Markdown नोट और इंडेक्स प्रविष्टि को एक साथ लिखता है, इसलिए तत्काल रिकॉल अनुबंध का हिस्सा है। पहला स्थानीय रन कॉन्फ़िगर किए गए एम्बेडिंग/रीरैंकिंग मॉडल को डाउनलोड और वार्म कर सकता है।

अनुबंध

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

• कैप्चर: होस्ट हुक तात्कालिकता में सुधार करते हैं; cairn sweep टिकाऊ बैकस्टॉप के रूप में समर्थित प्रतिलेख भंडारों को आउट-ऑफ-बैंड पढ़ता है। AgentCairn अपने स्वचालित सादे पाठ लेखन से पहले मान्यता प्राप्त क्रेडेंशियल्स को संपादित करता है, डुप्लिकेट हटाता है, महत्व-द्वारक लगाता है, और आसवन करता है।
• समाधान: पहला पठन लेन-देन रूप से तिजोरी-स्कोप्ड इंडेक्स को Markdown के साथ सिंक में लाता है। एक असफल पुनर्निर्माण अंतिम अच्छे कैश को संरक्षित करता है और टिकाऊ फ़ाइलें अछूती रहती हैं।
• रिकॉल: BM25 और सिमेंटिक वेक्टर को रेसिप्रोकल रैंक फ्यूजन के साथ जोड़ा जाता है, फिर वैकल्पिक रूप से पुनः रैंक किया जाता है। मॉडल/प्रदाता विफलताएँ असंगत वेक्टर लौटाने के बजाय निदान के साथ BM25 पर स्पष्ट रूप से वापस आती हैं।
• याद रखें: MCP उपकरण परमाणु रूप से एक Markdown नोट लिखता है और एक लेखक लॉक के तहत इंडेक्स को अपडेट करता है, जिससे एक सफल सेव तुरंत याद करने योग्य हो जाता है।

विश्वास के लिए डिज़ाइन किया गया

• डिफ़ॉल्ट रूप से स्थानीय। FastEmbed स्थानीय रूप से चलता है, MCP सर्वर stdio का उपयोग करता है, कोई आवश्यक डेमॉन या बाहरी डेटाबेस नहीं है, और कोई टेलीमेट्री नहीं है।
• स्पष्ट सीमाएँ। सिंक की गई तिजोरी में Markdown होता है; डिफ़ॉल्ट रूप से, पुनर्निर्माण योग्य .duckdb इंडेक्स इसके बाहर रहता है। कॉन्फ़िगर किए गए रूट से बाहर निकलने वाली तिजोरी सिमलिंक अस्वीकार कर दी जाती हैं।
• समय-जागरूक सुधार। valid_from, valid_until, और superseded_by पुराने साक्ष्य को दृश्यमान रखते हुए वर्तमान तथ्यों को पहले रैंक करते हैं।
• नियतात्मक ग्राफ। [[wikilinks]] और वैकल्पिक cairn link पड़ोसी किसी LLM को संस्थाओं का आविष्कार करने के लिए कहे बिना एक Obsidian-मूल ग्राफ बनाते हैं।
• परियोजना-जागरूक रिकॉल। वर्तमान परियोजना को डिफ़ॉल्ट रूप से बढ़ावा दिया जाता है; क्रॉस-प्रोजेक्ट परिणाम उपलब्ध रहते हैं और लेबल किए जाते हैं। स्वचालित रिकॉल परियोजना-स्कोप्ड है जब तक कि आप स्पष्ट रूप से सभी परियोजनाओं का विकल्प नहीं चुनते।

समर्थित एजेंट

प्रत्येक होस्ट समान कॉन्फ़िगर की गई तिजोरी का समाधान करता है। cairn install बिना लिखे पता लगाए गए होस्ट का पूर्वावलोकन करता है। MCP कॉन्फ़िगरेशन लेखन बैकअप-प्रथम हैं और असंबंधित सर्वरों को संरक्षित करते हैं; प्लगइन-होस्ट इंस्टॉल होस्ट के अपने CLI को सौंपते हैं।

Codex SessionStart को agentcairn 0.24.2 / प्लगइन 0.1.2 के साथ एंड-टू-एंड लाइव सत्यापित किया गया था। स्थापित SessionEnd कमांड डिस्पैच और डिटैच्ड स्वीप सटीक हैंडलर जांच पास करते हैं; cairn sweep आउट-ऑफ-बैंड कैप्चर बैकस्टॉप बना हुआ है। उनके मूल जीवनचक्र विवरण के लिए OpenCode एकीकरण और Hermes एकीकरण देखें।

इसे सीधे उपयोग करना

प्लगइन सबसे आसान मार्ग है, लेकिन agentcairn एक स्टैंडअलोन CLI और ऑन-डिमांड MCP सर्वर भी है। स्टैंडअलोन इंस्टॉल के लिए Python 3.11+ की आवश्यकता होती है।

uv tool install agentcairn

cairn init ~/agentcairn
cairn sweep --vault ~/agentcairn
cairn recall "how did we fix the auth bug?" --vault ~/agentcairn
cairn doctor --vault ~/agentcairn

Claude Code की स्मृति अपने साथ लाएँ

Claude Code की ऑटो-मेमोरी अपनी स्रोत फ़ाइलों को बदले बिना साझा तिजोरी को सीड कर सकती है। कमांड डिफ़ॉल्ट रूप से केवल वर्तमान रिपॉजिटरी का पूर्वावलोकन करता है; संपादित नोट्स लिखने और इंडेक्स को ताज़ा करने के लिए --apply जोड़ें।

cairn import claude-memory                         # preview; writes nothing
cairn import claude-memory --apply                 # import this repository
cairn import claude-memory --project ../other --apply

एकतरफ़ा आयात MEMORY.md और इसकी विषय Markdown फ़ाइलों को पढ़ता है—कभी भी CLAUDE.md या .claude/rules/ को नहीं। आयातित नोट्स Claude Code, परियोजना और स्रोत-फ़ाइल उद्गम बनाए रखते हैं। जब कोई स्रोत बदलता है, तो पूर्व संस्करण निरीक्षण योग्य रहता है लेकिन अधिक्रमित हो जाता है; जब कोई गायब हो जाता है, तो उसका आयातित संस्करण समाप्त हो जाता है। एक छोटी .agentcairn/native-memory/ रजिस्ट्री स्रोत सामग्री को दो बार अनुक्रमित किए बिना उस जीवनचक्र को संरक्षित करती है। कस्टम, प्रबंधित, या सत्र-अधिरोहित Claude मेमोरी निर्देशिका के लिए --source <dir> का उपयोग करें, या आयातों को बैच करते समय --no-reindex का।

एक अल्पकालिक प्रक्रिया को प्राथमिकता दें:

uvx agentcairn                             # MCP server
uvx --from agentcairn cairn recall "..."  # CLI; plain `uvx cairn` is a different package

cairn schedule install --vault ~/agentcairn  # launchd on macOS / user crontab on Linux
cairn schedule status
cairn link --vault ~/agentcairn              # write deterministic related: neighbors
cairn reindex ~/agentcairn                   # rebuild the disposable cache
cairn savings                                # local context-efficiency estimate
cairn index-status --vault ~/agentcairn

cairn config --init
cairn config

auto_recall = true
auto_recall_k = 3
auto_recall_scope = "project"  # use "all" only as an explicit cross-project opt-in

बेंचमार्क मापे गए

रिपॉजिटरी एक संशोधन-पिन किया हुआ, प्रतिलिपि प्रस्तुत करने योग्य LongMemEval-S + LoCoMo हार्नेस भेजता है। डिफ़ॉल्ट स्थानीय nomic-embed-text-v1.5 और क्रॉस-एनकोडर रीरैंकर है।

डिफ़ॉल्ट k=10 पर लौटाया गया संदर्भ पूर्ण अनुक्रमित इतिहास की तुलना में बहुत छोटा है:

संख्याओं को ईमानदारी से पढ़ें:

• पुनर्प्राप्ति रिकॉल QA सटीकता नहीं है। ये तालिकाएँ नियंत्रित पुनर्प्राप्ति भुजाओं की तुलना करती हैं, न कि अंतिम-उपयोगकर्ता उत्तर गुणवत्ता या किसी अन्य उत्पाद के लीडरबोर्ड स्कोर की।
• टोकन गणना लगभग चार-वर्ण-प्रति-टोकन अनुमान का उपयोग करती है। कमी अनुक्रमित ढेर की तुलना लौटाए गए खंडों से करती है; यह बिल की गई लागत बचत नहीं है।
• ग्राफ बूस्ट इन चैट कॉर्पोरा पर निष्क्रिय है क्योंकि उनमें कोई मूल [[wikilink]] ग्राफ नहीं है। यह वास्तविक अंतर्संबंधित तिजोरियों के लिए डिज़ाइन किया गया है।
• वैकल्पिक QA न्यायाधीश पेपर्स के GPT-4o सेटअप के बजाय Anthropic का उपयोग करता है, इसलिए वे QA परिणाम सापेक्ष उच्छेदन के लिए उपयोगी हैं—प्रकाशित-लीडरबोर्ड तुलनाओं के लिए नहीं।

पूर्ण मेट्रिक्स, एम्बेडिंग स्वीप, विलंबता माप, लाइसेंस, कमांड और चेतावनियाँ benchmarks/README.md में रहती हैं।

गोपनीयता और सीमाएँ

• वॉल्ट डिज़ाइन से सादा पाठ है, एन्क्रिप्टेड स्टोरेज नहीं। AgentCairn अपने स्वचालित बॉडी/शीर्षक/टैग लेखन से पहले मान्यता प्राप्त क्रेडेंशियल पैटर्न को संपादित करता है; अज्ञात पैटर्न और हाथ से किए गए संपादन आपकी जिम्मेदारी हैं।
• क्लाउड सुविधाएँ स्पष्ट निर्गमन हैं। डिफ़ॉल्ट स्थानीय रहता है। क्लाउड एम्बेडर या LLM निर्णायक का विकल्प चुनने पर शेष संपादित पाठ उस प्रदाता को भेज दिया जाता है।
• परियोजना बीटा में है। स्टैंडअलोन उपयोग के लिए Python 3.11+ आवश्यक है, और पहले स्थानीय मॉडल लोड में समय लग सकता है। प्रकाशित पुनर्प्राप्ति साक्ष्य संवादात्मक स्मृति के लिए सबसे मजबूत है, सार्वभौमिक कोड-खोज दावा नहीं।
• परिवेशी व्यवहार होस्ट के अनुसार भिन्न होता है। उपरोक्त मैट्रिक्स सुविचारित है: Cursor और Antigravity स्वीप कैप्चर पर निर्भर करते हैं; सामान्य MCP होस्ट जीवनचक्र हुक के बिना उपकरण प्रदर्शित कर सकते हैं।
• स्वचालन प्लेटफ़ॉर्म-विशिष्ट है। प्रबंधित शेड्यूलिंग macOS launchd और Linux उपयोगकर्ता crontab को लक्षित करती है; अन्यत्र अपने स्वयं के शेड्यूलर का उपयोग करें।

विकास

agentcairn निर्भरता प्रबंधन और टूलिंग के लिए विशेष रूप से uv का उपयोग करता है।

uv sync
uv run pre-commit install

uv run pytest
uv run ruff format .
uv run ruff check --fix .
uv run pre-commit run --all-files

API कुंजियों के बिना ऑफ़लाइन बेंचमार्क रिग्रेशन चलाएँ:

uv run pytest benchmarks/tests/

लाइसेंस

Apache License 2.0 — अनुमोदक, एक स्पष्ट पेटेंट अनुदान के साथ। कॉपीराइट © 2026 चार्ल्स सी. फिगुएरेडो।