agentcairn

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

वेबसाइट · PyPI · Obsidian साथी · बेंचमार्क

एक कायर्न उन लोगों के लिए रास्ता चिह्नित करता है जो आगे आते हैं। 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 के माध्यम से लॉन्च होता है, इसलिए पहले uv स्थापित करें यदि uvx --version पहले से उपलब्ध नहीं है।

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 और सिमेंटिक वेक्टर Reciprocal Rank Fusion के साथ जुड़े होते हैं, फिर वैकल्पिक रूप से रीरैंक किए जाते हैं। मॉडल/प्रदाता विफलताएँ असंगत वेक्टर लौटाने के बजाय निदान के साथ BM25 पर दृश्य रूप से वापस आती हैं।
• याद रखें: MCP टूल एक लेखक लॉक के तहत परमाणु रूप से एक Markdown नोट लिखता है और इंडेक्स को अपडेट करता है, जिससे एक सफल सहेजना तुरंत पुनर्प्राप्ति योग्य हो जाता है।

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

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

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

हर होस्ट एक ही कॉन्फ़िगर किए गए वॉल्ट को हल करता है। 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 पर लौटाया गया संदर्भ पूर्ण अनुक्रमित इतिहास से बहुत छोटा है:

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

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

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

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

• वॉल्ट डिज़ाइन से ही प्लेनटेक्स्ट है, एन्क्रिप्टेड स्टोरेज नहीं। AgentCairn अपने स्वचालित बॉडी/टाइटल/टैग लेखन से पहले पहचाने गए क्रेडेंशियल पैटर्न को रिडैक्ट करता है; अज्ञात पैटर्न और हाथ से किए गए संपादन आपकी ज़िम्मेदारी हैं।
• वॉल्ट फ़ाइलें केवल मालिक के लिए हैं (0600/0700)। चूंकि वॉल्ट प्लेनटेक्स्ट है और रिडैक्शन सर्वोत्तम प्रयास है, फ़ाइल मोड प्रभावी रूप से इसका एकमात्र एक्सेस नियंत्रण है। साझा-GID सेटअप (जैसे एक ही समूह पर लेकिन अलग-अलग UID वाले दो Docker कंटेनर) को समूह एक्सेस की आवश्यकता होती है, इसलिए vault_group_writable = true नए वॉल्ट नोट्स और निर्देशिकाओं को 0660/0770 तक विस्तृत करता है। यह जानबूझकर ऑप्ट-इन है: macOS पर हर स्थानीय उपयोगकर्ता का प्राथमिक समूह staff है, इसलिए समूह-पठनीय डिफ़ॉल्ट आपकी यादों को मशीन पर अन्य खातों के सामने उजागर कर देगा। यह नॉब कभी भी वॉल्ट के बाहर कुछ भी विस्तृत नहीं करता — इंडेक्स, लेजर, लॉक फ़ाइलें, और ~/.agentcairn/config.toml निजी रहते हैं।
• क्लाउड सुविधाएँ स्पष्ट बाहरी निकास हैं। डिफ़ॉल्ट स्थानीय रहता है। क्लाउड एम्बेडर या 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 Charles C. Figueiredo।