सामग्री पर जाएँ

Codex CLI यूज़र्स के लिए

AGENTS.md, Codex को बताता है कैसे काम करना है।
क्या मौजूद है, यह नहीं बताता।

AGENTS.md वर्किंग एग्रीमेंट तय करता है। MCP Codex को टूल्स तक पहुँचने देता है। Maguyva वह MCP सर्वर है जो Codex को आपके रिपो का क्वेरी करने लायक़ नक़्शा देता है, ताकि पहली एडिट फ़ाइल स्ट्रक्चर पर अंदाज़ा न हो।

Free शुरू करेंCodex सेटअप पढ़ें

Free स्तर: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, कोई कार्ड नहीं।

AGENTS.md एग्रीमेंट है। MCP चैनल है। Maguyva नक़्शा है।

लेयर्ड स्टैक

चार आइडिया। हर एक का एक काम।

// एग्रीमेंट

AGENTS.md

इस रिपो पर Codex को कैसे व्यवहार करना चाहिए।

// ट्रांसपोर्ट

MCP

Codex बाहरी टूल्स और कॉन्टेक्स्ट तक कैसे पहुँचता है।

// कोडबेस

Maguyva

वह MCP सर्वर जो ग्राउंडेड रिपो तथ्य लौटाता है।

// कौन पेमेंट करता है

वर्कस्पेस, सीट नहीं

एजेंट्स सीट के लिए पेमेंट नहीं करते। प्राइसिंग देखें

AGENTS.md एक वर्किंग एग्रीमेंट है। इसे इस्तेमाल करें।

स्थायी इंस्ट्रक्शंस AGENTS.md में होने चाहिए। यह इनके लिए सही जगह है:

  • बिल्ड, टेस्ट, और लिंट कमांड्स जो Codex को चलाने चाहिए।
  • किसी डायरेक्टरी तक सीमित “हमेशा X करो / कभी Y मत करो” गार्डरेल्स।
  • नेमिंग कन्वेंशन और रीफ़ैक्टर वरीयताएँ।
  • कैनोनिकल डिसीज़न लॉग्स और आर्किटेक्चर नोट्स के पॉइंटर्स।

इसे संक्षिप्त रखें। इसका दायरा तय करें। इसे कमिट करें।

लेकिन AGENTS.md कभी भी आपके रिपो के हर सिंबल, फ़ाइल, और कॉल साइट का क्वेरी करने लायक़ इंडेक्स बनने के लिए नहीं बनाया गया था।

जहाँ अकेला AGENTS.md स्केल पर स्थिर हो जाता है

चार फ़ेलियर मोड्स, हर कार्ड में एक।

// एग्रीमेंट्स इंडेक्स नहीं हैं

Codex को कैसे काम करना है बताना, उसे क्या मौजूद है नहीं बताता। किसी अनजान पैकेज पर पहली एडिट फ़ाइल पाथ और फ़ंक्शन नामों पर अंदाज़ा होती है। AGENTS.md हर सिंबल को सूचीबद्ध नहीं कर सकता, और आप चाहेंगे भी नहीं कि वह करे।

// डॉक कोड से हट जाता है

आपकी क्यू टोपोलॉजी बताने वाला AGENTS.md ब्लॉक तब तक सही है जब तक कोई नया कंज़्यूमर न जोड़े। अब कोड ही सच्चाई का स्रोत है और डॉक भरोसे के साथ बासी हो चुका है। Codex ग़लत वाला पढ़ता है।

// रीनेम एक ग्राफ़ प्रॉब्लम है

“इस क्लास को कौन रेफ़र करता है?” का जवाब किसी मार्कडाउन फ़ाइल से नहीं मिलता। Codex या तो मोनोरिपो में grep करके दुआ माँगता है या आपसे कॉल साइट्स चैट में पेस्ट करने को कहता है।

// कॉन्टेक्स्ट विंडो मुफ़्त नहीं है

AGENTS.md को तब तक भरना जब तक Codex “काफ़ी जान न ले,” उन टोकन को खा जाता है जो रीज़निंग के लिए इस्तेमाल होने चाहिए। कुछ KB के बाद, आप जवाब की क्वालिटी को स्टैटिक कॉन्टेक्स्ट वॉल्यूम से बदल रहे होते हैं।

तीनों लेयर्स कैसे साथ फ़िट होती हैं

Codex यूज़र्स पहले से इसी शेप में सोचते हैं। पेज को यह साफ़ दिखाना चाहिए।

AGENTS.md

एग्रीमेंट्स

Codex कैसे व्यवहार करता है

MCP

चैनल

यह कैसे पहुँचता है

Maguyva

कोडबेस तथ्य

यह क्या देखता है

  • AGENTS.md इस रिपो पर Codex कैसे व्यवहार करता है।
  • MCP Codex टूल्स और कॉन्टेक्स्ट तक कैसे पहुँचता है। (स्पेक)
  • Maguyva जब Codex कोडबेस से कोई सवाल पूछता है तो वह क्या देखता है। फ़ाइल पाथ और लाइन नंबर के साथ लौटाया गया सिमेंटिक, AST, ग्राफ़, और टेक्स्ट सर्च।

AGENTS.md, Codex को बताता है कैसे काम करना है।

Maguyva, Codex को काम करने के लिए कुछ ठोस देता है।

तीन वर्कफ़्लो

Codex-विशिष्ट। असली कॉल ग्राफ़ के आधार पर ग्राउंडेड, Codex के grep के आधार पर नहीं।

// workflow 01

एक शेयर्ड क्लास को रीनेम करें, पहले हर डिपेंडेंट ढूँढ़ें

codex> rename PaymentClient → BillingClient

graph::callers(PaymentClient)            7 पैकेजों में 12 रेफ़रेंस
graph::importers(src/payments/client.ts)  9 इम्पोर्टर्स
graph::extends(PaymentClient)             2 सबक्लास (RetryClient, MockClient)

→ Codex फ़ाइल लिस्ट के साथ इनलाइन 21-एडिट माइग्रेशन सुझाता है।
[exit 0]

Codex एडिटिंग शुरू करने से पहले Maguyva से डिपेंडेंट्स माँगता है। माइग्रेशन लिस्ट असली ग्राफ़ के आधार पर ग्राउंडेड होकर वापस आती है, Codex की याददाश्त के आधार पर नहीं।

// workflow 02

असली इम्प्लीमेंटेशन ढूँढ़ें, टेस्ट स्टब नहीं

codex> normalizePhoneNumber, E.164 को कैसे हैंडल करता है?

semantic::query("normalize phone E.164")
  src/util/phone.ts:88   normalizePhoneNumber()   ← असली इम्प्लीमेंटेशन
  test/util/phone.spec.ts:14  jest.mock(...)      ← स्टब
[exit 0]

नाम झूठ बोलते हैं। मॉक्स असली कोड को छिपा देते हैं। Maguyva असली इम्प्लीमेंटेशन को टेस्ट मॉक से ऊपर रैंक करता है।

// workflow 03

रीफ़ैक्टर से पहले ब्लास्ट रेडियस चेक करें

codex> what calls QueueDispatcher.publish?

graph::callers(QueueDispatcher.publish)
  3 in src/billing/*    1 in src/audit/*    1 in src/notifications/*
[exit 0]

क्रॉस-पैकेज कॉल-साइट्स इनलाइन सामने आती हैं। डिफ़ असली इम्पोर्टर्स के आधार पर ग्राउंडेड है, Codex के grep के आधार पर नहीं।

Codex CLI में सेटअप

तीन चरण। Free स्तर: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, कोई कार्ड नहीं।

  1. // step 01

    maguyva.ai पर एक रिपो इंडेक्स करें

    ऐसा रिपो चुनें जिसे आप अच्छी तरह जानते हों, ताकि आप जवाब वेरिफ़ाई कर सकें।

  2. // step 02

    अपने Codex कॉन्फ़िग में Maguyva को MCP सर्वर के तौर पर जोड़ें

    $ export MAGUYVA_API_KEY=mgv_xxxx
$ codex mcp add maguyva --url https://maguyva.tools/mcp \
    --bearer-token-env-var MAGUYVA_API_KEY

# equivalent ~/.codex/config.toml
[mcp_servers.maguyva]
url = "https://maguyva.tools/mcp"
bearer_token_env_var = "MAGUYVA_API_KEY"

  3. // step 03

    एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं

    अपनी पूरी कंपनी से शुरुआत न करें। एक रिपो और एक वेरिफ़ाई करने लायक़ सवाल से शुरू करें।

सेल्फ़-सर्व साइनअप खुले हैं।

एक ऐसा रिपो इंडेक्स करें जिसे आप पहले से जानते हैं।

Codex को MCP पर कनेक्ट करें। एक ऐसा सवाल पूछें जिसका जवाब आप वेरिफ़ाई कर सकें।

अपनी पहली रिपॉज़िटरी इंडेक्स करेंसंगतता डॉक्स देखें

Free योजना: 3 रिपॉज़िटरी, 50K तक इंडेक्स्ड रिपॉज़िटरी लाइनें, कोई कार्ड नहीं।