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

AGENTS.md, OpenCode को आपके नियम बताता है।
Maguyva उसे कोड दिखाता है।

OpenCode काम का तरीका AGENTS.md से पढ़ता है और बाकी सब के लिए MCP सर्वर कॉल करता है। Maguyva एक रिमोट MCP सर्वर है जो OpenCode को आपके रिपो का क्वेरी करने लायक नक़्शा देता है, फ़ाइल पाथ और लाइन नंबर के साथ।

मुफ़्त शुरू करें OpenCode सेटअप पढ़ें

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

mcp के नीचे एक रिमोट एंट्री। लोकल कुछ नहीं चलता।

OpenCode के बारे में क्या जानना ज़रूरी है

OpenCode से जुड़े चार तथ्य।

// कॉन्फ़िग फ़ाइल

opencode.json

सर्वर को अपने प्रोजेक्ट के opencode.json में mcp के नीचे जोड़ें, या हर प्रोजेक्ट के लिए ~/.config/opencode/opencode.json में।

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

type: remote

OpenCode, Maguyva के एंडपॉइंट से HTTP पर जुड़ता है। लोकल कुछ नहीं चलता और Node.js की ज़रूरत नहीं।

// कुंजी

एक एनवायरनमेंट वेरिएबल रेफ़रेंस

OpenCode अपने कॉन्फ़िग में एनवायरनमेंट वेरिएबल्स बदल देता है, इसलिए हेडर Bearer {env:MAGUYVA_API_KEY} लिखा जाता है और कुंजी उस फ़ाइल से बाहर रहती है जिसे आप कमिट करते हैं।

// कॉन्टेक्स्ट बजट

हर एजेंट के हिसाब से सीमित करें

हर MCP सर्वर कॉन्टेक्स्ट में टूल परिभाषाएं जोड़ता है। OpenCode किसी सर्वर के टूल्स को "maguyva*": false जैसे glob से ग्लोबली बंद कर सकता है और सिर्फ़ ज़रूरत वाले एजेंट्स के लिए फिर से चालू कर सकता है।

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

> /init
# रिपो स्कैन करता है और AGENTS.md लिखता है

OpenCode प्रोजेक्ट रूट में AGENTS.md और निजी नियमों के लिए ~/.config/opencode/AGENTS.md पढ़ता है। AGENTS.md न हो तो वह CLAUDE.md पर लौटता है। इसे इनके लिए रखें:

बिल्ड, टेस्ट और लिंट कमांड।
वे कन्वेंशन और सीमाएं जिनका एजेंट को सम्मान करना चाहिए।
ज़रूरी दस्तावेज़ों के पॉइंटर।

/init के समय का स्कैन एक सारांश है, इंडेक्स नहीं। वह OpenCode को नहीं बताता कि कल जोड़े गए फ़ंक्शन को कौन कॉल करता है।

जहां AGENTS.md कम पड़ता है

तीन कमियां जिन्हें OpenCode grep और धैर्य से भरता है।

// सारांश इंडेक्स नहीं है

AGENTS.md ज़रूरी पैकेजों के नाम ले सकता है। वह हर सिंबल और कॉल साइट की सूची नहीं बना सकता, और उसे कोशिश भी नहीं करनी चाहिए।

// grep स्ट्रिंग ढूंढता है, कॉलर नहीं

टेक्स्ट मैच असली कॉल को किसी कमेंट, mock या दूसरी क्लास के उसी नाम वाले मेथड से अलग नहीं कर सकता।

// फ़ाइल पीछे छूट जाती है

AGENTS.md जिस दिन लिखा जाता है उस दिन सही होता है। कोड आगे बढ़ता रहता है; फ़ाइल तब बदलती है जब किसी को अपडेट करना याद आता है।

OpenCode में रिमोट MCP सर्वर के रूप में Maguyva

mcp के नीचे एक एंट्री OpenCode को देती है:

आपके इंडेक्स किए गए रिपो पर 11 टूल सिमेंटिक, स्ट्रक्चरल (AST), ग्राफ़ और टेक्स्ट सर्च, साथ में सिंबल लुकअप, डिपेंडेंट्स और फ़ाइल रिट्रीवल।
फ़ाइल पाथ और लाइन नंबर के साथ जवाब 285+ भाषाओं में।
हर मॉडल के लिए एक जैसे जवाब OpenCode कई मॉडल प्रोवाइडर्स के साथ काम करता है। कोई भी मॉडल पूछे, Maguyva वही नक़्शा लौटाता है।

AGENTS.md, OpenCode को बताता है कैसे काम करना है।
Maguyva, OpenCode को काम करने के लिए कुछ ठोस देता है।

दो वर्कफ़्लो

उसी टर्मिनल से नक़्शे से पूछें।

// workflow 01

कई पैकेजों में शेयर किए गए type का नाम बदलें

opencode> OrderStatus का नाम बदलकर FulfillmentStatus करो

dependency_search("OrderStatus", dependents)
  8 पैकेजों में 23 रेफ़रेंस
structural_search(switch_statement, "OrderStatus")
  4 एग्ज़ॉस्टिव switch

→ OpenCode switch समेत पूरी सूची एडिट करता है।
[exit 0]

एग्ज़ॉस्टिव switch ही वे जगहें हैं जिन्हें टेक्स्ट सर्च चूक जाता है और कंपाइलर देर से पकड़ता है।

// workflow 02

कोड को डॉक्यूमेंटेशन से अलग करें

opencode> FEATURE_BULK_EXPORT कहां पढ़ा जाता है?

text_pattern_search("FEATURE_BULK_EXPORT")
  src/config/flags.ts:17
  src/export/bulk.ts:5
  docs/flags.md:40   ← सिर्फ़ डॉक्स

→ दो कोड पाथ, एक पुराना डॉक।
[exit 0]

सटीक मैच पाथ के साथ लौटते हैं, ताकि OpenCode किसी को भी एडिट करने से पहले कोड को डॉक्यूमेंटेशन से अलग कर सके।

OpenCode में सेटअप

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

// step 01

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

ऐसा रिपो चुनें जिसे आप पहले से जानते हैं, ताकि आप जवाबों को परख सकें।

// step 02

opencode.json में mcp के नीचे Maguyva जोड़ें

opencode.json

{
  "mcp": {
    "maguyva": {
      "type": "remote",
      "url": "https://maguyva.tools/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

अपनी कुंजी export करें और कनेक्शन जांचें

जिस शेल से OpenCode शुरू होता है उसमें MAGUYVA_API_KEY सेट करें। opencode mcp list हर कॉन्फ़िगर किया गया सर्वर दिखाता है; फिर एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं।

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

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

OpenCode को MCP पर कनेक्ट करें, फिर एक ऐसा सवाल पूछें जिसे आप जांच सकें।

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

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