Codex

विक्रेता: OpenAI इंस्टॉल नाम: codex स्थिति: बीटा नेटिव कॉन्फ़िग: ~/.codex/AGENTS.md, ~/.codex/hooks.json, ~/.codex/hooks/, ~/.codex/agents/*.toml, और ~/.agents/skills/

इंस्टॉलेशनCopy Anchor Link

apothem install --harness codex

अडैप्टर Codex-नेटिव निर्देश और हुक इंस्टॉल करता है, Apothem एजेंटों को Codex TOML एजेंटों में परिवर्तित करता है, और पुनः प्रयोज्य कमांड प्रॉम्प्ट को Codex स्किल के रूप में लपेटता है।

लिखी गई फ़ाइलें: ~/.codex/AGENTS.md, ~/.codex/hooks.json, ~/.codex/hooks/, ~/.codex/agents/*.toml, ~/.agents/skills/*/SKILL.md, उपयोगकर्ता-आह्वानित स्किल के लिए ~/.agents/skills/*/agents/openai.yaml, और ~/.config/apothem/{rules,templates}/ के अंतर्गत समर्थन फ़ाइलें।

हुक इंटरप्रेटर। कुछ भी लिखने से पहले, इंस्टॉल एक CPython 3.10+ इंटरप्रेटर खोजता है। Windows पर, hooks.json में प्रत्येक हुक की commandWindows प्रविष्टि py -3 लॉन्चर के बजाय उस इंटरप्रेटर का निरपेक्ष पथ चलाती है; POSIX command प्रविष्टियाँ python3 ही रखती हैं। इंटरप्रेटर का स्थान बदलने या उसे हटाने के बाद apothem update --harness codex फिर से चलाएँ। यदि कोई CPython 3.10+ नहीं मिलता, तो इंस्टॉल कोई भी फ़ाइल लिखने से पहले रुक जाता है।

AGENTS.md में Apothem ब्लॉक एक Apothem समर्थन फ़ाइल अनुभाग के साथ समाप्त होता है, जो इंस्टॉल किए गए स्किल और नियमों में प्रत्येक रिपॉज़िटरी-शैली उद्धरण के लिए वह निरपेक्ष डायरेक्टरी बताता है जिसके सापेक्ष वह उद्धरण हल होता है: rules/<name>.md और templates/... ~/.config/apothem/ के अंतर्गत, और hooks/... ~/.codex/hooks/ के अंतर्गत। Codex इंस्टॉल कोई schemas/ या conformity/ वृक्ष शिप नहीं करता, इसलिए अनुभाग इनमें से किसी को भी सूचीबद्ध नहीं करता।

उपयोगकर्ता-आह्वानित स्किल। Codex disable-model-invocation कुंजी को अनदेखा करता है। हर उस स्किल या कमांड के लिए जिसका स्रोत disable-model-invocation: true सेट करता है, अडैप्टर उसकी SKILL.md के बगल में policy.allow_implicit_invocation: false के साथ agents/openai.yaml लिखता है, ताकि Codex उस स्किल को अपने आप न चुने; आप फिर भी उसे $skill-name से स्पष्ट रूप से चला सकते हैं। Codex स्किल दस्तावेज़ देखें।

प्रोफ़ाइल-से-नेटिव-कॉन्फ़िग मैपिंगCopy Anchor Link

अडैप्टर Apothem के साझा समूहों को पढ़ता है और प्रत्येक को सही Codex सतह में इंस्टॉल करता है: निर्देश AGENTS.md में, हुक hooks.json और hooks/ में, एजेंट TOML में, स्किल ~/.agents/skills/ में, और गैर-नेटिव Markdown नियम/टेम्पलेट समर्थन सामग्री के रूप में ~/.config/apothem/ में।

प्रत्येक परिवर्तित सहायक name, description, और developer_instructions सेट करता है, जो सहायक का मुख्य भाग रखता है। कोई मॉडल या तर्क-प्रयास सेट नहीं किया जाता, इसलिए प्रत्येक सहायक सत्र के विकल्प विरासत में लेता है। Codex में प्रति-सहायक टूल सूची या टर्न सीमा नहीं होती, इसलिए किसी सहायक के tools और maxTurns आगे नहीं ले जाए जाते।

केवल-पठन सहायक (एजेंट संदर्भ देखें) अपने निर्देशों में कहते हैं कि वे कुछ भी संपादित नहीं करते। केवल-पठन मूल सत्र के सैंडबॉक्स द्वारा लागू होता है, सहायक की TOML फ़ाइल द्वारा नहीं: हर सहायक उस सत्र की सैंडबॉक्स और अनुमोदन सेटिंग्स के अंतर्गत चलता है जिसने उसे शुरू किया। कोई सहायक फ़ाइल सत्र के सैंडबॉक्स मोड, अनुमोदन नीति, मॉडल प्रदाता, या MCP सर्वरों को ओवरराइड नहीं कर सकती, इसलिए अडैप्टर इनमें से कुछ भी नहीं लिखता, और किसी सहायक के निर्देश एक अलग केवल-पठन सैंडबॉक्स बनाए बिना उससे संपादनों से बचने को कह सकते हैं। केवल-पठन सीमा को बाध्यकारी बनाने के लिए, सैंडबॉक्स और अनुमोदन नियंत्रण स्वयं Codex सत्र पर सेट करें। इस प्रतिबंध को जोड़ने वाले रिलीज़ से पुराना कोई Codex बिल्ड अब भी किसी सहायक फ़ाइल में sandbox_mode का पालन कर सकता है; Apothem ने यह स्थापित नहीं किया है कि वह कौन-सा रिलीज़ है, और वह किसी भी स्थिति में कोई sandbox_mode नहीं लिखता।

संगतता टिप्पणियाँCopy Anchor Link

~/.agents/skills/ एक साझा रूट है जिसका स्वामी Codex है: नौ अन्य समर्थित टूल भी इसे लोड करते हैं (हार्नेस रजिस्ट्री उन्हें सूचीबद्ध करती है), इसलिए कोई Codex इंस्टॉल वहाँ जो Apothem स्किल लिखता है, वे उन टूल्स में भी दिखाई देते हैं। उनमें से चार टूल इंस्टॉल किए जाने पर स्वयं भी यह फ़ोल्डर लिखते हैं (रजिस्ट्री उन्हें सह-इंस्टॉलर के रूप में सूचीबद्ध करती है), उन्हीं फ़ाइलों के साथ जो कोई Codex इंस्टॉल लिखता है, इसलिए स्किल ऐसी मशीन पर भी मौजूद रहते हैं जिस पर कोई Codex इंस्टॉल नहीं है। यही बात ~/.config/apothem/ के नियमों और टेम्पलेट पर लागू होती है, जिन्हें सात प्रोजेक्ट-स्कोप अडैप्टर भी लिखते हैं। फ़ोल्डर हमेशा आपकी होम डायरेक्टरी में होता है, चाहे CODEX_HOME कुछ भी हो: Codex $HOME/.agents/skills पढ़ता है, इसलिए ~/.codex के अलावा कोई CODEX_HOME Codex फ़ाइलों को स्थानांतरित करता है, स्किल को नहीं। फ़ोल्डर का उपयोग करने वाला हर Apothem इंस्टॉल वहाँ वही फ़ाइलें लिखता है, और इंस्टॉल यह दर्ज करता है कि कौन-से इंस्टॉल उसका उपयोग करते हैं, इसलिए आप किस क्रम में इंस्टॉल करते हैं इससे फ़र्क नहीं पड़ता। कोई Codex अनइंस्टॉल स्किल केवल तभी हटाता है जब कोई अन्य Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो; अन्यथा वह उन्हें रखता है और बताता है कि कौन-से इंस्टॉल उनका उपयोग करते हैं (अनइंस्टॉल करना देखें)। पंजीकृत स्वामी वह टूल है जिसके लिए विक्रेता उस पथ को प्रलेखित करता है। फ़ाइलें रखने वाला इंस्टॉल वह है जो अब भी उनका उपयोग करता है, और इंस्टॉल नोट उसका नाम बताता है। ऐसा स्किल फ़ोल्डर जिसे Apothem ने नहीं लिखा और जिसका नाम किसी Apothem स्किल के समान है, छोड़ दिया जाता है, साथ में एक चेतावनी जो उसका नाम बताती है। इंस्टॉल एक नोट प्रिंट करता है जो उन टूल्स के नाम बताता है। ~/.codex/agents/ एक दूसरा साझा रूट है: एक अन्य समर्थित टूल उस फ़ोल्डर को संगतता स्थान के रूप में सूचीबद्ध करता है (रजिस्ट्री उसका नाम बताती है), और उसके दस्तावेज़ यह नहीं बताते कि क्या वह उन TOML फ़ाइलों को पढ़ता है जो कोई Codex इंस्टॉल वहाँ लिखता है।

Codex .rules निष्पादन नीतियों के लिए ~/.codex/rules/ आरक्षित रखता है। Apothem वहाँ Markdown व्यवहार नियम नहीं रखता; वह उन्हें ~/.config/apothem/ में रखता है और AGENTS.md तथा इंस्टॉल किए गए स्किल से उनका संदर्भ देता है।

Codex प्लगइनCopy Anchor Link

Apothem एक Codex प्लगइन भी शिप करता है, जिसे रिपॉज़िटरी के प्लगइन मार्केटप्लेस से जोड़ा जाता है (इंस्टॉल गाइड चैनल 7 के अंतर्गत कमांड सूचीबद्ध करती है)। प्लगइन एक बूटस्ट्रैप है: यह एक प्रवेश स्किल बंडल करता है जो इंजन चलाता है, और apothem install --harness codex ऊपर सूचीबद्ध सब कुछ लिखता है।

प्लगइन plugins/apothem/ में रहता है। इसका मैनिफ़ेस्ट एक रूट plugin.json है, वह स्थान जिसे Codex नए पैकेज के लिए प्रलेखित करता है। मैनिफ़ेस्ट कोई स्किल पथ नहीं बताता, क्योंकि Codex किसी प्लगइन की skills/ डायरेक्टरी प्लगइन रूट से खोजता है। एक .codex-plugin/plugin.json फ़ाइल उसके बगल में उन Codex बिल्ड के लिए संगतता फ़ॉलबैक के रूप में रहती है जो केवल उस पुराने स्थान को पढ़ते हैं; Codex अब भी उसका समर्थन करता है और प्लगइन की पहचान के लिए रूट मैनिफ़ेस्ट को कैनोनिकल मानता है। दोनों फ़ाइलें रिलीज़ संस्करण रखती हैं, और एक परीक्षण उन्हें इंजन के संस्करण से बाँधे रखता है।

प्लगइन कोई एजेंट, हुक, या MCP सर्वर बंडल नहीं करता। Codex प्लगइनों के लिए कोई कस्टम-एजेंट घटक प्रलेखित नहीं करता, इसलिए इंजन एजेंटों को ~/.codex/agents/*.toml में लिखता रहता है। किसी प्लगइन में बंडल किए गए हुक Codex डेस्कटॉप में मैन्युअल रूप से इंस्टॉल किए गए प्लगइनों तक सीमित हैं और स्वचालित रूप से विश्वसनीय नहीं माने जाते, इसलिए इंजन उन्हें ~/.codex/hooks.json में लिखता रहता है।

मार्केटप्लेस प्रविष्टि वह policy ब्लॉक सेट करती है जिसे Codex लेखकों को हमेशा शामिल करने को कहता है: policy.installation AVAILABLE है और policy.authentication ON_INSTALL है, वे डिफ़ॉल्ट जिन्हें Codex नई प्रविष्टि के लिए प्रलेखित करता है।

सत्यापनCopy Anchor Link

apothem verify --harness codex

verify कमांड पुष्टि करता है कि:

1. नेटिव कॉन्फ़िग अपेक्षित पथ पर मौजूद है।
2. हर प्रबंधित टारगेट मौजूद है; प्रबंधित फ़ाइलें खाली नहीं हैं, और JSON या YAML कॉन्फ़िग पार्स होते हैं। --profile PATH जोड़ने पर यह भी पुष्टि होती है कि इंस्टॉल की गई फ़ाइलें उस प्रोफ़ाइल से मेल खाती हैं।
3. अडैप्टर-विशिष्ट सत्यापन रूटीन सफलता की रिपोर्ट करता है।

अपडेट करनाCopy Anchor Link

apothem update --harness codex

Codex बूटस्ट्रैप, परिवर्तित एजेंटों, स्किल, और समर्थन समूहों को ताज़ा करता है।

~/.agents/skills/ में स्किल फ़ोल्डर एक ऐसे रूप में लिखे जाते हैं जिसे उस फ़ोल्डर का हर Apothem इंस्टॉल साझा करता है: SKILL.md हेडर कुंजियाँ version, updated, archetype, और portability एक metadata मैप के अंतर्गत रहती हैं, और userInvocable को user-invocable लिखा जाता है। अपग्रेड के बाद का पहला अपडेट किसी Codex इंस्टॉल द्वारा पहले लिखे गए फ़ोल्डरों को उस रूप में फिर से लिखता है, और अपने द्वारा बदले गए हर फ़ोल्डर का बैकअप लेता है। apothem rollback --harness codex उन्हें पुनर्स्थापित करता है।

अनइंस्टॉल करनाCopy Anchor Link

apothem uninstall --harness codex

~/.codex/AGENTS.md से Apothem ब्लॉक हटाता है और उसके बाहर का सारा पाठ रहने देता है, और ~/.codex/hooks.json से Apothem की प्रविष्टियाँ हटाता है और आपकी प्रविष्टियाँ रहने देता है। साथ ही ~/.codex/hooks/, ~/.codex/agents/, ~/.agents/skills/, और ~/.config/apothem/{rules,templates}/ में मौजूद Apothem फ़ाइलें हटाता है, जब तक कि कोई अन्य Apothem इंस्टॉल अब भी उनका उपयोग न कर रहा हो (अनइंस्टॉल उन्हें रखता है और सूचीबद्ध करता है); उन फ़ोल्डरों की अन्य फ़ाइलें बनी रहती हैं। ~/.agents/skills/ से हटाए गए स्किल उसे लोड करने वाले अन्य टूल्स से भी गायब हो जाते हैं (संगतता टिप्पणियाँ देखें)। यदि आपने CODEX_HOME को ~/.codex के अलावा किसी फ़ोल्डर पर सेट किया था और किसी पुराने रिलीज़ से इंस्टॉल किया था, तो उस रिलीज़ द्वारा उस फ़ोल्डर के बगल में लिखी गई प्रतियाँ (<CODEX_HOME>/../.agents/skills/ और <CODEX_HOME>/../.config/apothem/) नहीं हटाई जातीं; उन्हें हाथ से हटाएँ। प्रत्येक फ़ाइल को बदले या हटाए जाने से पहले ~/.apothem/backups/ के अंतर्गत उसका बैकअप लिया जाता है। साझा प्रोफ़ाइल YAML और Apothem इंजन अप्रभावित रहते हैं।

अनुरूपता गेटCopy Anchor Link

python -m apothem.conformity.gate --all .

समस्या निवारणCopy Anchor Link

कॉन्फ़िगरेशन नॉबCopy Anchor Link

यह भी देखेंCopy Anchor Link

• सभी हार्नेस — समर्थित टूल्स का पूरा कैटलॉग
• इंस्टॉल गाइड — इस हार्नेस में Apothem इंस्टॉल करें
• apothem harnesses संदर्भ — CLI से अडैप्टरों को सूचीबद्ध करें और उनका निरीक्षण करें