प्रोफ़ाइल संपादित करें

लक्ष्य: साझा प्रोफ़ाइल में एक मान बदलें और उसे हर उस टूल में धकेलें जो आपने इंस्टॉल किया है।

पूर्वापेक्षाएँCopy Anchor Link

• आपके PATH पर apothem CLI (या स्व-निहित रूप: आगे PYTHONPATH="$HOME/.apothem/src" जोड़कर python -m apothem चलाएँ, या npx @ahmed-g-gad/apothem का उपयोग करें)।
• ~/.config/apothem/profile.yaml पर एक प्रोफ़ाइल। यदि यह अनुपस्थित है तो apothem profile init से एक बनाएँ।

प्रोफ़ाइल का आकारCopy Anchor Link

प्रोफ़ाइल एक एकल YAML दस्तावेज़ है। इसकी शीर्ष-स्तरीय कुंजियाँ:

• identity (आवश्यक) — name, साथ ही वैकल्पिक role, email, website, github।
• preferences — language, style (concise / verbose / balanced), formatter, test_framework।
• rules — सक्षम टूल के साथ साझा किए गए अतिरिक्त नियम स्ट्रिंग की एक सूची।
• seriousness — EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH में से एक।
• enforcement — ऑप्ट-इन टॉगल (sprints, agent_teams, multitasking, continuous_execution, learning_loop), हर फ़्लैग डिफ़ॉल्ट-बंद।
• harnesses — टूल id द्वारा कुंजीबद्ध प्रति-टूल ओवरराइड।
• exclude_harnesses — बैच (--harness all) कमांड द्वारा छोड़े गए टूल id।
• mcp_servers — सर्वर नाम द्वारा कुंजीबद्ध MCP सर्वर परिभाषाएँ।
• agent_mcp_servers — प्रति सहायक नाम, वे MCP सर्वर जिन्हें वह सहायक कॉल कर सकता है (किसी सहायक को MCP सर्वरों तक पहुँच दें देखें)। डिफ़ॉल्ट रूप से खाली, इसलिए कोई सहायक किसी MCP टूल तक नहीं पहुँचता।
• workspace — जहाँ Apothem अपनी साझा कार्य डायरेक्टरी रखता है (directory_name, scope)।
• schema_version — वैकल्पिक प्रोफ़ाइल-स्कीमा संस्करण; जिस प्रोफ़ाइल में यह नहीं है उसे संस्करण 1 के रूप में पढ़ा जाता है।

हर फ़ील्ड प्रोफ़ाइल फ़ील्ड में सूचीबद्ध है।

चरणCopy Anchor Link

1. वर्तमान प्रोफ़ाइल का निरीक्षण करें:

   Copy Text

   apothem profile show

2. इसे संपादित करें। इसे अपने सिस्टम संपादक में खोलें:

   Copy Text

   apothem profile edit

   या कमांड लाइन से एक एकल बिंदु-वाली कुंजी सेट करें। मान अक्षरशः संग्रहीत होता है (true/false और स्पष्ट [..]/{..} इनपुट को छोड़कर, जिन्हें पार्स किया जाता है) और प्रोफ़ाइल लिखने से पहले स्कीमा के विरुद्ध सत्यापित होती है — एक अमान्य सेट अस्वीकृत कर दिया जाता है और डिस्क पर प्रोफ़ाइल अपरिवर्तित रहती है:

   Copy Text

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. टूल को पुनः-मटेरियलाइज़ करें ताकि बदलाव उनकी नेटिव कॉन्फ़िग तक पहुँचे। एक उपयोगकर्ता-दायरे के टूल के लिए:

   Copy Text

   apothem update --harness claude-code

   एक प्रोजेक्ट-दायरे के टूल के लिए, प्रोजेक्ट रूट पास करें; हर इंस्टॉल किए गए टूल को ताज़ा करने के लिए all का उपयोग करें:

   Copy Text

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

सत्यापनCopy Anchor Link

apothem profile show
apothem verify --harness all

profile show आपके संपादन को परिलक्षित करता है।

apothem verify --harness all प्रोफ़ाइल के exclude_harnesses में सूचीबद्ध हार्नेसों को छोड़कर हर पंजीकृत हार्नेस की जाँच करता है, इसलिए जब तक बाकी सभी इंस्टॉल न हों, तब तक यह शून्येतर एग्ज़िट कोड के साथ बाहर निकलता है। प्रोजेक्ट-दायरे वाले हार्नेसों के लिए --project PATH भी चाहिए; उसके बिना बैच project.required त्रुटि के साथ रुक जाता है। केवल उस हार्नेस की जाँच के लिए, जिसे आपने अपडेट किया है, उसी कमांड को उस हार्नेस के नाम के साथ चलाएँ:

apothem verify --harness <name>

जिन हार्नेसों को आपने इंस्टॉल नहीं किया है उन्हें सहन करने वाले पूरे-सिस्टम के दृश्य के लिए apothem doctor चलाएँ।

संबंधितCopy Anchor Link

• पुनः-मटेरियलाइज़ करने से पहले किसी नए टूल को प्रोफ़ाइल नियंत्रण में लाने के लिए एक टूल जोड़ें।
• अपडेट करना पुनः-मटेरियलाइज़ चरण के साथ-साथ इंजन को अपग्रेड करने को कवर करता है।