Cursor
Cursor (GA) के लिए Apothem हार्नेस अडैप्टर।
विक्रेता: Anysphere
इंस्टॉल नाम: cursor
स्थिति: GA
नेटिव कॉन्फ़िग: प्रोजेक्ट रूट में .cursor/rules/
इंस्टॉलेशन
apothem install --harness cursor --project /path/to/projectअडैप्टर साझा Apothem नियमों और शासन सतह से एक एकल प्रोजेक्ट-स्कोप .mdc नियम
फ़ाइल रेंडर करता है, प्रोजेक्ट में Apothem के सहायकों को Cursor सबएजेंट के रूप में
लिखता है (सबएजेंट देखें), और प्रोजेक्ट की hooks.json में एक हुक
जोड़ता है (हुक देखें)।
यह Apothem की स्किल, और वे जिन नियमों और टेम्पलेट का हवाला देती हैं, उन्हें भी प्रोजेक्ट को छूने से पहले आपकी होम डायरेक्टरी में लिखता है (प्रोजेक्ट के बाहर की फ़ाइलें देखें)।
लिखी गई फ़ाइलें:
<project>/.cursor/rules/apothem-rules.mdc, नियम फ़ाइल।- प्रोजेक्ट में, हर Apothem सहायक के लिए
<project>/.cursor/agents/<name>.md। <project>/.cursor/hooks.json, जिसमें एकsessionStartप्रविष्टि जोड़ी जाती है। उसमें आपकी अपनी प्रविष्टियाँ और कुंजियाँ बनी रहती हैं।- प्रोजेक्ट में,
<project>/.apothem/support/cursor/hooks/, हुक स्क्रिप्ट। - आपकी होम डायरेक्टरी में, हर Apothem स्किल और कमांड के लिए
~/.agents/skills/<name>/SKILL.md। - आपकी होम डायरेक्टरी में,
~/.config/apothem/rules/और~/.config/apothem/templates/।
नियम फ़ाइल अनुशासनों का सारांश देती है और उन फ़ोल्डरों के नाम बताती है, ताकि जब किसी कार्य को इसकी आवश्यकता हो तो मॉडल कोई स्किल या नियम फ़ाइल खोल सके।
प्रोजेक्ट के बाहर की फ़ाइलें
इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले Apothem की स्किल आपकी होम डायरेक्टरी में भी लिखता है:
| फ़ोल्डर | Apothem वहाँ क्या लिखता है |
|---|---|
~/.agents/skills/ | हर Apothem स्किल के लिए एक SKILL.md वाला एक फ़ोल्डर, और हर Apothem कमांड के लिए एक (कमांड उसी नाम की स्किल बन जाता है)। |
~/.config/apothem/rules/, ~/.config/apothem/templates/ | वे नियम और टेम्पलेट जिनका स्किल और नियम फ़ाइल उल्लेख करती हैं। |
ये फ़ोल्डर साझा हैं। ये प्रोजेक्ट के निजी नहीं हैं:
- हर वह प्रोजेक्ट जिसमें आप
cursorइंस्टॉल करते हैं, और फ़ोल्डर का नाम लेने वाला हर अन्य Apothem इंस्टॉल, एक ही प्रति का उपयोग करता है और वही फ़ाइलें लिखता है, इसलिए आप किस क्रम में इंस्टॉल करते हैं इससे फ़र्क नहीं पड़ता। कई अन्य टूल भी~/.agents/skills/पढ़ते हैं; हार्नेस रजिस्ट्री उन्हें सूचीबद्ध करती है। --projectयह चुनता है कि कौन-सी नियम फ़ाइल लिखी जाए और इंस्टॉल किस प्रोजेक्ट का है। यह नहीं बदलता कि स्किल कहाँ जाती हैं।- इंस्टॉल आपकी रिपॉज़िटरी में कोई स्किल या नियम फ़ाइल नहीं जोड़ता। प्रोजेक्ट को
नियम फ़ाइल,
.cursor/agents/में सबएजेंट फ़ाइलें,.cursor/hooks.jsonमें हुक प्रविष्टि मिलती है, साथ ही वह.apothem/फ़ोल्डर जो हर प्रोजेक्ट इंस्टॉल बनाता है, जिसमें हुक स्क्रिप्ट भी रहती हैं। - होम फ़ोल्डर पहले लिखे जाते हैं। यदि यह विफल होता है, उदाहरण के लिए क्योंकि पथ में कोई फ़ोल्डर ऐसा लिंक है जो आपकी होम डायरेक्टरी से बाहर जाता है (जो लिंक उसके भीतर रहता है, उसका अनुसरण किया जाता है) या लिखा नहीं जा सकता, तो इंस्टॉल प्रोजेक्ट में कुछ भी बदलने से पहले त्रुटि के साथ रुक जाता है।
- Apothem स्किल के नाम वाला कोई स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा, उसे
छोड़ दिया जाता है, और इंस्टॉल एक चेतावनी प्रिंट करता है जो उसका नाम बताती है।
उसका नाम बदलें या उसे स्थानांतरित करें, फिर
apothem updateचलाएँ। जब तक वह नाम घिरा रहता है,apothem verifyविफल रहता है। - फ़ाइलें कुल मिलाकर कुछ मेगाबाइट की होती हैं।
इंस्टॉल एक नोट प्रिंट करता है जो उन फ़ोल्डरों के नाम बताता है जिन्हें वह --project
के बाहर लिखता है, और --dry-run उन्हें सूचीबद्ध करता है।
सबएजेंट
Cursor सबएजेंट दस्तावेज़ के अनुसार, Cursor
<project>/.cursor/agents/ में एक Markdown फ़ाइल से सबएजेंट पढ़ता है। इंस्टॉल उस
फ़ोल्डर में हर Apothem सहायक के लिए एक फ़ाइल लिखता है। यह केवल प्रोजेक्ट के लिए
इंस्टॉल करता है और कोई ~/.cursor/agents/ फ़ोल्डर नहीं लिखता।
हर फ़ाइल सहायक के निर्देशों को अपरिवर्तित रखती है और ये फ़्रंटमैटर कुंजियाँ रखती है:
| कुंजी | Apothem क्या लिखता है |
|---|---|
name, description | सहायक का नाम और विवरण। |
readonly | पाँच सहायकों के लिए true: citation-auditor, convention-auditor, fact-checker, memory-auditor और research-scout। |
Cursor में ऐसी कोई कुंजी नहीं है जो टूल सूचीबद्ध या वर्जित करे: सबएजेंट अपने पैरेंट
का हर टूल विरासत में पाता है। एकमात्र सीमा जिसे यह लागू कर सकता है वह
readonly: true है, जो कोई फ़ाइल संपादन और कोई स्थिति-बदलने वाला शेल कमांड अनुमत
नहीं करता। इसलिए सहायक की tools और disallowedTools पंक्तियाँ नहीं लिखी जातीं,
और सीमा केवल उसी फ़्लैग के रूप में बचती है:
- ऊपर के पाँच सहायक केवल-पठन हैं और उनके पास कोई
Bashनहीं है, इसलिए उन्हेंreadonly: trueमिलता है और उनके विवरणों में केवल-पठन शब्दावली बनी रहती है। - सात सहायक केवल-पठन हैं लेकिन कमांड चलाते हैं (
codebase-explorer,dependency-auditor,design-critic,prompt-evaluator,quality-gate,security-scannerऔरtest-runner)।readonly: trueउनके टेस्ट और लिंट रन भी रोक देगा, इसलिए उन्हें कोई फ़्लैग नहीं मिलता, और उनके विवरणों से वह केवल-पठन लेबल हट जाता है जिसे Cursor लागू नहीं करेगा। केवल विवरण बदलता है: निर्देश अपरिवर्तित कॉपी किए जाते हैं, इसलिए वे अब भी सहायक को केवल-पठन कहते हैं और एक ऐसे टूल प्रतिबंध का उल्लेख करते हैं जो Cursor फ़ाइल में नहीं है। मॉडल उस पाठ का पालन करता है, लेकिन Cursor उसे लागू नहीं करता, और सहायक पैरेंट के हर टूल के साथ चलता है। mcp-builderऔरrefactor-surgeonफ़ाइलें लिखते हैं और अपरिवर्तित हैं।
इंस्टॉल कोई model कुंजी नहीं लिखता, इसलिए सहायक उसी मॉडल पर चलता है जिसका
पैरेंट उपयोग करता है, और is_background, कोई टर्न सीमा, या Apothem की version,
updated और portability कुंजियों में से कोई भी नहीं लिखता।
जानने योग्य बातें:
- सबएजेंट फ़ाइलें सामान्य प्रोजेक्ट फ़ाइलें हैं। उन्हें प्रोजेक्ट के साथ कमिट करें या
.gitignoreमें.cursor/agents/सूचीबद्ध करें; Apothem आपके लिए यह नहीं चुनता। - Cursor अन्य टूल्स के लिए लिखे गए सहायक फ़ोल्डर भी लोड करता है, उनमें प्रोजेक्ट में
.claude/agents/और आपकी होम डायरेक्टरी में~/.claude/agents/शामिल हैं (हार्नेस रजिस्ट्री बाकी को सूचीबद्ध करती है)। नाम टकराने पर प्रोजेक्ट होम फ़ोल्डर पर और.cursor/अन्य पर प्राथमिकता लेता है, इसलिए इस इंस्टॉल वाले प्रोजेक्ट में नेटिव फ़ाइलें उन Claude Code प्रतियों का स्थान ले लेती हैं जिन्हें Cursor~/.claude/agents/से आयात करता। Cursor के दस्तावेज़ यह नहीं बताते कि वह दोनों प्रतियाँ लोड करता है या निचली को छोड़ देता है, और न ही यह कि वह आयात की गई Claude Code फ़ाइल कीtoolsऔरdisallowedToolsपंक्तियाँ लागू करता है या नहीं। - Apothem सहायक के नाम वाली आपकी कोई फ़ाइल
~/.apothem/backups/के अंतर्गत सहेजी जाती है और फिर बदल दी जाती है। अनइंस्टॉल उसे वापस नहीं रखता। अन्य नामों वाली फ़ाइलों को कभी नहीं छुआ जाता। - Apothem ने पुष्टि नहीं की है कि Cursor उन TOML फ़ाइलों को पढ़ता है या नहीं जिन्हें
कोई अन्य टूल उसके द्वारा आयात किए जाने वाले फ़ोल्डरों में लिखता है, क्या
Third-Party Imports सेटिंग उन आयातित फ़ोल्डरों को बंद करती है, या क्या वह
.cursor/agents/में.mdके अलावा अन्य एक्सटेंशन या नेस्टेड फ़ोल्डर पढ़ता है।
हुक
Cursor हुक दस्तावेज़ के अनुसार, Cursor
hooks.json फ़ाइलों से हुक चलाता है। इंस्टॉल <project>/.cursor/hooks.json में एक
प्रविष्टि जोड़ता है:
| इवेंट | क्या चलता है |
|---|---|
sessionStart | सत्र बूटस्ट्रैप: सत्र मेटाडेटा, स्किल इंडेक्स, मेमोरी और प्लान सारांश और स्थायी मुद्रा, बातचीत के प्रारंभिक संदर्भ में जोड़े जाते हैं। |
हुक मॉडल के लिए संदर्भ जोड़ता है। यह कुछ भी अवरुद्ध नहीं करता, और Cursor किसी
sessionStart हुक की प्रतीक्षा नहीं करता।
यह पहला संस्करण और कुछ भी पंजीकृत नहीं करता। Cursor के दस्तावेज़ postToolUse के
लिए भी additional_context सूचीबद्ध करते हैं, और जब कोई प्रोब दिखाएगा कि संदर्भ
मॉडल तक पहुँचता है, तब Apothem वहाँ संदर्भ-आकार काउंटर पंजीकृत करेगा। यह कोई
preToolUse गार्ड पंजीकृत नहीं करता: Cursor agent_message, वह फ़ील्ड जिसके
माध्यम से कोई गार्ड बोलता, केवल उस क्रिया के लिए प्रलेखित करता है जिसे वह अस्वीकार
करता है, और Apothem के गार्ड कभी अस्वीकार नहीं करते। write, edit और shell गार्ड,
AskUserQuestion जाँच और सत्र-समाप्ति प्रोटोकॉल उन टूल्स पर रहते हैं जो उन्हें
पहुँचाते हैं।
फ़ाइलें कहाँ जाती हैं
| फ़ाइल | उसमें क्या है |
|---|---|
<project>/.cursor/hooks.json | एक sessionStart प्रविष्टि, फ़ाइल के hooks मैप में विलय की गई। |
<project>/.apothem/support/cursor/hooks/ | डिस्पैचर स्क्रिप्ट, उसके हेल्पर और उसकी संदेश फ़ाइलें। |
hooks.json आपकी फ़ाइल है, और Cursor प्रोजेक्ट हुक को संस्करण नियंत्रण में चेक-इन
किए गए के रूप में प्रलेखित करता है। इंस्टॉल Apothem की प्रविष्टि आपकी प्रविष्टियों के
बाद जोड़ता है और आपकी प्रविष्टियों और अन्य कुंजियों को जैसी थीं वैसी छोड़ता है; अपडेट
केवल उस प्रविष्टि को बदलता है जिसका कमांड Apothem डिस्पैचर चलाता है
(--contract cursor के साथ .apothem/support/cursor/hooks/dispatch.py, चाहे वह
किसी भी प्रोजेक्ट पथ के अंतर्गत लिखा गया हो), और अनइंस्टॉल केवल उसी प्रविष्टि को
हटाता है। आपका कोई हुक जो केवल नाम साझा करता है, जैसे आपके प्रोजेक्ट में
tools/hooks/dispatch.py, या जो python -m apothem.conformity.gate चलाता है, उसे कभी Apothem का नहीं समझा जाता। अनइंस्टॉल
~/.apothem/backups/ के अंतर्गत एक प्रति सहेजने के बाद फ़ाइल को तब हटाता है जब
उसमें और कुछ शेष न रहे। टिप्पणियों, अनुगामी अल्पविराम या गलत आकार के hooks मान
वाली फ़ाइल को कुछ खोए बिना फिर से नहीं लिखा जा सकता, इसलिए इंस्टॉल उस फ़ाइल के लिए
config.unparseable त्रुटि रिपोर्ट करता है, उसे अछूता छोड़ता है और रुक जाता है, और
जिन अन्य फ़ाइलों को उसने लिखना शुरू किया था उन्हें फिर से हटा देता है: फ़ाइल ठीक
करें, या प्रविष्टि स्वयं जोड़ें।
कमिट की गई फ़ाइल आपकी मशीन का नाम बताती है। प्रविष्टि के कमांड में वह
इंटरप्रेटर होता है जो Apothem को चलते समय मिला और प्रोजेक्ट का पूर्ण पथ, इसलिए जो
साथी फ़ाइल चेक आउट करता है उसे ऐसा कमांड मिलता है जो आपकी मशीन की ओर इशारा करता है।
Cursor ऐसे कमांड को जिसे वह नहीं ढूँढ पाता, विफल के रूप में रिपोर्ट करता है और सत्र
जारी रहता है, इसलिए कुछ नहीं टूटता, लेकिन वहाँ हुक कुछ नहीं करता। फ़ाइल केवल तभी
कमिट करें जब आपकी टीम वही लेआउट साझा करती हो। Cursor प्रोजेक्ट हुक फ़ाइल का कोई
अनकमिट संस्करण प्रलेखित नहीं करता। .apothem/ फ़ोल्डर वह जगह है जहाँ स्क्रिप्ट
रहती हैं, और प्रोजेक्ट का .gitignore स्निपेट उसे संस्करण नियंत्रण से बाहर रखता है।
कमांड ऐसा दिखता है, दोनों पथों की जगह आपके इंटरप्रेटर और प्रोजेक्ट पथ के साथ:
"/path/to/python" "/path/to/project/.apothem/support/cursor/hooks/dispatch.py" --contract cursor sessionStartWindows होस्ट पर कमांड & से शुरू होता है, जो PowerShell का कॉल ऑपरेटर है,
क्योंकि Cursor का डेस्कटॉप ऐप हुक कमांड PowerShell के माध्यम से चलाता है, जहाँ
उद्धृत प्रोग्राम पथ से शुरू होने वाली पंक्ति कॉल नहीं होती। sh आरंभिक & को
सिंटैक्स त्रुटि के रूप में पढ़ता है, इसलिए किसी अन्य होस्ट को यह नहीं मिलता। दस्तावेज़
शेल का नाम बताते हैं, उद्धरण-शैली का नहीं, इसलिए यह PowerShell के सिंटैक्स की
Apothem की व्याख्या है।
--contract cursor Cursor के conversation_id और workspace_roots पढ़ता है और
{"additional_context": ...} के साथ उत्तर देता है, और कुछ नहीं।
पथ जिन्हें शेल गलत पढ़ेगा। $, बैकटिक, दोहरा उद्धरण चिह्न या बैकस्लैश वाला
कोई प्रोजेक्ट या इंटरप्रेटर पथ कुछ भी लिखे जाने से पहले अस्वीकार कर दिया जाता है:
उद्धृत कमांड के भीतर वह कोई अलग फ़ाइल चलाएगा, या उस JSON को तोड़ देगा जिसमें
कमांड लिखा जाता है। त्रुटि पथ का नाम बताती है; प्रोजेक्ट को स्थानांतरित करें या
उसका नाम बदलें और इंस्टॉल फिर से चलाएँ। पथ में स्पेस या अपॉस्ट्रॉफ़ी ठीक है।
Cursor वे हुक भी चलाता है जो Claude Code ने लिखे। जब तक "Include Third-Party
Plugins, Skills, and Other Configs" चालू है (Cursor Settings में, Third-Party Imports
के अंतर्गत), जो डिफ़ॉल्ट है, Cursor ~/.claude/settings.json,
.claude/settings.json और .claude/settings.local.json के हुक लोड करता है, और यह
हर स्रोत से हर मेल खाने वाला हुक चलाता है। यदि आपने Claude Code के लिए भी Apothem
इंस्टॉल किया है, तो हुक के दोनों सेट चल सकते हैं। यहाँ का sessionStart कमांड और
उसकी Claude Code प्रति Apothem के हुक स्थिति फ़ोल्डर में प्रति सत्र एक मार्कर साझा
करते हैं, इसलिए जो भी दूसरे क्रम पर चलता है वह मौन रहता है और बूटस्ट्रैप मॉडल तक
एक बार पहुँचता है; Apothem Cursor को उन CURSOR_PROJECT_DIR और CURSOR_VERSION
वेरिएबल से पहचानता है जिन्हें Cursor अपने हुक के लिए सेट करता है। मार्कर दस सेकंड
तक लागू रहता है, इसलिए उसी सत्र का बाद का आरंभ, जैसे दूसरा कॉम्पैक्शन, फिर भी
पहुँचाता है। Claude Code प्रति का संदर्भ-आकार काउंटर इसके अतिरिक्त चलता है, और
Apothem काउंटरों का दोहराव नहीं हटाता। केवल यहाँ का हुक चलाने के लिए, वह सेटिंग
बंद करें; इससे Cursor का तृतीय-पक्ष प्लगइन, स्किल और अन्य कॉन्फ़िग आयात करना भी
रुक जाता है। इंस्टॉल इसे एक नोट के रूप में प्रिंट करता है।
जानने योग्य बातें। सहेजे जाने पर Cursor hooks.json को फिर से लोड करता है,
इसलिए पुनरारंभ की आवश्यकता नहीं है। प्रोजेक्ट हुक विश्वसनीय वर्कस्पेस में चलते हैं।
Cursor का क्लाउड किसी रिपॉज़िटरी के प्रोजेक्ट हुक चलाता है लेकिन sessionStart को
स्थगित करता है, इसलिए वहाँ प्रविष्टि सक्रिय नहीं होती। Apothem हुक को मौन करने के
लिए Cursor के परिवेश में APOTHEM_HOOKS_DISABLE=1 सेट करें।
प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंग
अडैप्टर Apothem की साझा प्रोफ़ाइल पढ़ता है और प्रत्येक apothem install या
apothem update रन पर प्रोजेक्ट नियम फ़ाइल रेंडर करता है। सत्य का स्रोत साझा
प्रोफ़ाइल है; अगला सिंक Apothem-प्रबंधित सामग्री को बदले, उससे पहले उत्पन्न फ़ाइल
में किए गए प्रोजेक्ट-स्थानीय संपादनों का बैकअप लिया जाता है।
फ़ाइल अपने YAML फ़्रंटमैटर (description, globs, alwaysApply: true) से शुरू
होती है, क्योंकि Cursor किसी नियम का प्रकार केवल फ़ाइल की शुरुआत में स्थित
फ़्रंटमैटर से पढ़ता है। Apothem-प्रबंधित ब्लॉक उसके बाद आता है; ब्लॉक के बाद आपके
द्वारा जोड़ा गया पाठ हर सिंक पर बना रहता है।
संगतता टिप्पणियाँ
Cursor 0.45+ .cursor/rules/ के माध्यम से प्रोजेक्ट-स्तरीय निर्देशों का समर्थन
करता है। अडैप्टर डिफ़ॉल्ट रूप से प्रोजेक्ट-स्कोप वाली .cursor/rules/ डायरेक्टरी
में लिखता है; Cursor के पास कोई प्रलेखित फ़ाइल-आधारित उपयोगकर्ता-वैश्विक नियम पथ
नहीं है जिसे यह अडैप्टर प्रबंधित कर सके।
Cursor ~/.agents/skills/ से स्किल लोड करता है, इसलिए इंस्टॉल द्वारा लिखी गई स्किल
बिना किसी अतिरिक्त सेटअप के Cursor में दिखाई देती हैं। Cursor ~/.claude/skills/
भी लोड करता है, इसलिए ऐसी मशीन पर जिसमें Claude Code इंस्टॉल भी है, वह एक ही स्किल
नाम दो बार सूचीबद्ध कर सकता है, और उसके दस्तावेज़ यह नहीं बताते कि कौन-सी प्रति
प्राथमिकता पाती है। Apothem ने पुष्टि नहीं की है कि Cursor किसी ऐसी SKILL.md हेडर
कुंजी के साथ कैसा व्यवहार करता है जिसे वह सूचीबद्ध नहीं करता; स्किल
user-invocable, disable-model-invocation, allowed-tools, argument-hint, और
एक metadata मैप रखती हैं।
सत्यापन
apothem verify --harness cursor --project /path/to/projectverify कमांड पुष्टि करता है कि:
- नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
- हर प्रबंधित टारगेट मौजूद है,
.cursor/agents/फ़ोल्डर और हुक फ़ाइल.cursor/hooks.jsonसहित; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं। हुक फ़ाइल में एक ऐसी प्रविष्टि होनी चाहिए जो Apothem डिस्पैचर चलाती है (जाँच उसे चलाती नहीं), इसलिए जो फ़ाइल पहले जैसी लौटा दी गई या खाली कर दी गई, वह अब सत्यापित नहीं होती।--profile PATHजोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।.cursor/agents/के लिए जाँच यह है कि फ़ोल्डर मौजूद है, यह नहीं कि हर सहायक फ़ाइल उसमें है; कमांडapothem diff --harness cursor --project /path/to/projectउन सहायक फ़ाइलों को सूचीबद्ध करता है जो अनुपस्थित या पुरानी हैं। - हर Apothem स्किल फ़ोल्डर एक
SKILL.mdके साथ अपनी जगह पर है, चाहे उसे किसी भी इंस्टॉल ने लिखा हो, और Apothem नाम वाला कोई स्किल फ़ोल्डर ऐसी किसी चीज़ का नहीं है जिसे Apothem ने नहीं लिखा। विफल जाँच अनुपस्थित या बाहरी फ़ोल्डरों के नाम बताती है। - अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।
अपडेट करना
apothem update --harness cursor --project /path/to/projectवर्तमान साझा प्रोफ़ाइल स्थिति से प्रोजेक्ट नियम फ़ाइल को पुनः व्युत्पन्न करता है।
अपडेट ऐसे किसी भी स्किल फ़ोल्डर को भी फिर से लिखता है जिसकी फ़ाइलें वर्तमान फ़ाइलों से भिन्न हैं।
यदि आपने किसी पुराने रिलीज़ से इंस्टॉल किया था जिसने कोई स्किल नहीं लिखी, तो अपडेट उन्हें जोड़ता है।
यह उन सबएजेंट फ़ाइलों को फिर से लिखता है जो वर्तमान फ़ाइलों से भिन्न हैं, और जो अनुपस्थित हैं उन्हें जोड़ता है।
यह हुक स्क्रिप्ट और .cursor/hooks.json में Apothem प्रविष्टि को भी ताज़ा करता है,
आपकी अपनी प्रविष्टियों को अछूता छोड़ते हुए।
अनइंस्टॉल करना
apothem uninstall --harness cursor --project /path/to/project<project>/.cursor/rules/apothem-rules.mdc से Apothem ब्लॉक, और उसके ऊपर Apothem
द्वारा लिखा गया फ़्रंटमैटर, हटाता है और उसमें मौजूद बाकी सारा पाठ रहने देता है।
फ़ाइल तभी हटाई जाती है जब उसमें और कुछ शेष न बचे। बदलाव से पहले फ़ाइल की एक
टाइमस्टैम्प-युक्त प्रति ~/.apothem/backups/ के अंतर्गत सहेजी जाती है; प्रोजेक्ट में
कोई बैकअप फ़ाइल नहीं छोड़ी जाती। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित
रहते हैं।
अनइंस्टॉल <project>/.cursor/agents/ में अपने द्वारा लिखी गई सबएजेंट फ़ाइलें भी
हटाता है और वहाँ की किसी भी अन्य फ़ाइल को रखता है; खाली रह जाने पर फ़ोल्डर हटा
दिया जाता है। यह <project>/.cursor/hooks.json से Apothem प्रविष्टि हटाता है, उसे
उसके कमांड में डिस्पैचर पथ से पहचानते हुए, और आपकी अपनी प्रविष्टियाँ और कुंजियाँ
रखता है। फ़ाइल केवल तभी हटाई जाती है जब उसमें और कुछ शेष न रहे।
<project>/.apothem/support/cursor/hooks/ में हुक स्क्रिप्ट भी हटा दी जाती हैं।
यदि किसी फ़ाइल में ऐसी टिप्पणियाँ हैं जिन्हें अनइंस्टॉल पढ़ नहीं सकता, तो वह उस फ़ाइल
को जैसी है वैसी छोड़ देता है और प्रविष्टि को कारण सहित छोड़ी गई (skipped) के रूप में
रिपोर्ट करता है; Apothem प्रविष्टि हाथ से हटाएँ।
यह ~/.agents/skills/ में अपने द्वारा लिखे गए स्किल फ़ोल्डर और
~/.config/apothem/ में नियम और टेम्पलेट हटाता है, लेकिन केवल तभी जब कोई अन्य
Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो। कोई अन्य प्रोजेक्ट, या फ़ोल्डर साझा
करने वाला कोई अन्य टूल, ऐसा कर सकता है। उस स्थिति में अनइंस्टॉल फ़ोल्डर रखता है,
प्रिंट करता है कि कौन-सा इंस्टॉल उनका उपयोग करता है, और अंतिम अनइंस्टॉल उन्हें हटाता
है। उन फ़ोल्डरों में आपके द्वारा जोड़ी गई फ़ाइलें बनी रहती हैं, और खाली रह गया
फ़ोल्डर हटा दिया जाता है। हर फ़ोल्डर को हटाए जाने से पहले ~/.apothem/backups/
के अंतर्गत उसका बैकअप लिया जाता है।
अनुरूपता गेट
python -m apothem.conformity.gate --all .समस्या निवारण
| लक्षण | समाधान |
|---|---|
| कॉन्फ़िग फ़ाइल नहीं मिली | apothem install --harness cursor --project /path/to/project फिर से चलाएँ |
| सत्यापन विफल रहा | apothem update --harness cursor --project /path/to/project चलाएँ, फिर दोबारा सत्यापित करें |
| Cursor कोई भी Apothem सहायक सूचीबद्ध नहीं करता | apothem diff --harness cursor --project /path/to/project चलाएँ। .cursor/agents फ़ोल्डर के लिए कोई लंबित पंक्ति का अर्थ है कि सहायक फ़ाइलें अनुपस्थित या पुरानी हैं, इसलिए apothem update --harness cursor --project /path/to/project चलाएँ। apothem verify इसकी जाँच नहीं है: यह तब पास होता है जब .cursor/agents/ मौजूद हो, भले ही उसमें कोई सहायक फ़ाइल न हो। यदि diff कोई लंबित परिवर्तन रिपोर्ट नहीं करता, तो जाँचें कि प्रोजेक्ट Cursor में खुला है और एक नई चैट शुरू करें |
| Apothem हुक नहीं चलता | Cursor प्रोजेक्ट हुक केवल विश्वसनीय वर्कस्पेस में चलाता है। यह देखने के लिए कि प्रविष्टि लोड हुई या नहीं और उसने क्या रिपोर्ट किया, Customize में Hooks टैब, या Hooks आउटपुट चैनल खोलें। किसी अन्य मशीन पर लिखी गई फ़ाइल उस मशीन के इंटरप्रेटर का नाम बताती है, इसलिए Cursor कमांड को विफल के रूप में रिपोर्ट करता है: यहाँ apothem update --harness cursor --project /path/to/project चलाएँ |
कोई इंस्टॉल hooks.json के लिए config.unparseable रिपोर्ट करता है | फ़ाइल में टिप्पणियाँ, अनुगामी अल्पविराम या गलत आकार का hooks मान है। फ़ाइल ठीक करें और फिर से इंस्टॉल करें, या sessionStart प्रविष्टि स्वयं जोड़ें |
| Apothem संदर्भ दो बार दिखाई देता है | Cursor वे हुक भी चलाता है जो Claude Code इंस्टॉल ने लिखे। केवल .cursor/hooks.json का हुक चलाने के लिए Cursor Settings में, Third-Party Imports के अंतर्गत, "Include Third-Party Plugins, Skills, and Other Configs" बंद करें |
apothem verify किसी अनुपस्थित स्किल फ़ोल्डर का नाम बताता है | apothem install --harness cursor --project /path/to/project चलाएँ; यह फ़ोल्डर को पुनर्स्थापित करता है |
| कोई इंस्टॉल या अपडेट चेतावनी देता है कि उसने एक स्किल फ़ोल्डर छोड़ दिया | Apothem स्किल के नाम वाला एक फ़ोल्डर स्किल फ़ोल्डर में पहले से मौजूद है और उसे Apothem ने नहीं लिखा। उसका नाम बदलें या उसे स्थानांतरित करें, फिर apothem update चलाएँ |
| कोई इंस्टॉल प्रोजेक्ट बदलने से पहले रुक जाता है | आपकी होम डायरेक्टरी में कोई लेखन विफल रहा। त्रुटि पढ़ें, उसमें नामित फ़ोल्डर ठीक करें (ऐसा लिंक जो आपकी होम डायरेक्टरी से बाहर जाता है, फ़ोल्डर की जगह कोई फ़ाइल, या केवल-पठन फ़ोल्डर), और फिर से इंस्टॉल करें |
| अप्रत्याशित कॉन्फ़िग सामग्री | ~/.config/apothem/profile.yaml या --profile PATH जाँचें, फिर apothem update --harness cursor --project /path/to/project फिर से चलाएँ |
कॉन्फ़िगरेशन नॉब
| फ़्लैग | डिफ़ॉल्ट | विवरण |
|---|---|---|
--dry-run | false | फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें। |
यह भी देखें
- सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
- इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
apothem harnessesसंदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें