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

Zed तेज़ है। फिर भी एजेंट को कोड ढूंढना पड़ता है।

Zed एजेंट उन फ़ाइलों से काम करता है जो आप खोलते हैं और उन निर्देशों से जो आप देते हैं। Maguyva पूरा रिपो इंडेक्स करता है और उसे MCP पर वापस देता है, ताकि एजेंट अंदाज़ा लगाने के बजाय पूछे कि कोई सिंबल कहां है।

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

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

एक context_servers एंट्री: एक URL और एक Authorization हेडर।

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

Zed से जुड़े चार तथ्य। इनमें से कोई भी मुश्किल नहीं।

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

settings.json

रिमोट सर्वर context_servers के नीचे रहते हैं। फ़ाइल को zed: open settings file से खोलें, या Settings → AI → MCP Servers से सर्वर जोड़ें।

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

रिमोट, URL से

Zed, Maguyva के रिमोट एंडपॉइंट से HTTP पर जुड़ता है। कोई लोकल प्रोसेस नहीं, कोई Node.js नहीं।

// कुंजी

सीधा लिखा हेडर

यह गाइड कुंजी को सीधे Authorization हेडर में रखती है, क्योंकि Zed हेडर्स में एनवायरनमेंट-वेरिएबल एक्सपैंशन यहां वेरिफ़ाई नहीं हुआ है। इसे अपनी यूज़र सेटिंग्स में रखें, उस फ़ाइल में नहीं जिसे आप कमिट करते हैं।

// अनुमतियां

टूल परमिशन

डिफ़ॉल्ट रूप से Zed हर टूल कॉल से पहले पूछता है। Maguyva के टूल्स को agent.tool_permissions.tools के नीचे एक-एक करके अनुमति दें, mcp:maguyva:find_symbol जैसी कुंजियों के साथ।

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

# .rules
- किसी बदलाव को पूरा मानने से पहले रिपो का टेस्ट कमांड चलाएं।
- एडिट उसी पैकेज तक सीमित रखें जिसे बदलने को कहा गया है।

Zed एक प्रोजेक्ट निर्देश फ़ाइल लोड करता है: एक तय सूची में पहला मैच, जो .rules से शुरू होती है और जिसमें AGENTS.md व CLAUDE.md शामिल हैं। निजी निर्देश ~/.config/zed/AGENTS.md में जाते हैं। इसे इनके लिए इस्तेमाल करें:

बिल्ड, टेस्ट और लिंट कमांड।
वे कन्वेंशन जिन्हें एजेंट बार-बार गलत करता है।
वे डायरेक्टरी जिन्हें एजेंट को नहीं छूना चाहिए।

निर्देश फ़ाइल एजेंट को बताती है कि कैसे काम करना है। वह यह नहीं बता सकती कि चार हज़ार फ़ाइलों में से कौन-सी उस फ़ंक्शन को कॉल करती हैं जिसे एजेंट बदलने वाला है।

जहां खुला बफ़र कम पड़ता है

तीन बातें जो Zed एजेंट अपने सामने की फ़ाइलों से नहीं सीख सकता।

// खुली फ़ाइल पूरा रिपो नहीं है

एजेंट वही देखता है जो आपने खोला और जो उसने grep किया। किसी दूसरे पैकेज में उसी नाम का हेल्पर बिल्कुल एक जैसा दिखता है, जब तक गलत वाला शिप न हो जाए।

// कॉलर स्क्रीन पर नहीं हैं

“यह सिग्नेचर बदलूं तो क्या टूटेगा?” एक ग्राफ़ सवाल है। इंडेक्स के बिना एजेंट एक-एक फ़ाइल पढ़ता है, जब तक उसके टर्न या कॉन्टेक्स्ट खत्म न हो जाएं।

// कॉन्टेक्स्ट का बजट होता है

दिशा समझने के लिए एजेंट जो भी फ़ाइल खोलता है, उसमें वे टोकन खर्च होते हैं जो बदलाव पर लग सकते थे। file:line के साथ एक रैंक किया गया जवाब दस खोजी रीड्स से सस्ता है।

Zed कॉन्टेक्स्ट सर्वर के रूप में Maguyva

एक context_servers एंट्री Zed एजेंट को देती है:

आपके इंडेक्स किए गए रिपो पर 11 टूल सिमेंटिक, स्ट्रक्चरल (AST), ग्राफ़ और टेक्स्ट सर्च, साथ में सिंबल लुकअप, डिपेंडेंट्स और फ़ाइल रिट्रीवल।
फ़ाइल पाथ और लाइन नंबर के साथ जवाब 285+ भाषाओं में, ताकि एजेंट पहली बार में ही सही फ़ाइल खोले।
हमेशा अपडेट रहने वाली टूल सूची जब सर्वर बदलाव की घोषणा करता है, Zed बिना रीस्टार्ट के उस सर्वर के टूल्स दोबारा लोड कर लेता है।

Zed एजेंट को एक तेज़ एडिटर देता है।
Maguyva एजेंट को कोड का नक़्शा देता है।

दो वर्कफ़्लो

पहले नक़्शे से पूछें, फिर एडिट करें।

// workflow 01

एजेंट के टैब खोलने से पहले इम्प्लीमेंटेशन ढूंढें

zed agent> आउटबाउंड webhooks की retry policy कहां है?

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← इम्प्लीमेंटेशन
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ एजेंट mock नहीं, dispatch.ts:41 खोलता है।
[exit 0]

एक रैंक किया गया लुकअप grep के पूरे दौर की जगह लेता है। जवाब एक पाथ और लाइन के रूप में आता है जिसे एजेंट सीधे खोल सकता है।

// workflow 02

सिग्नेचर बदलने से पहले डिपेंडेंट्स जांचें

zed agent> fetchInvoice में timeout आर्ग्युमेंट जोड़ो

dependency_search("fetchInvoice", dependents)
  4 पैकेजों में 7 कॉलर

→ एजेंट सातों कॉल साइट्स एक ही बार में अपडेट करता है।
[exit 0]

ब्लास्ट रेडियस पहली एडिट से पहले सामने आता है, बिल्ड फ़ेल होने के बाद नहीं।

Zed में सेटअप

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

// step 01

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

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

// step 02

अपनी Zed सेटिंग्स में Maguyva को context_servers में जोड़ें

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

प्लेसहोल्डर बदलें और एक सवाल पूछें

mgv_xxxx को अपनी API कुंजी से बदलें और सेव करें। एजेंट से एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं, फिर उद्धृत फ़ाइल खोलें।

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

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

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

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

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