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

Canonical source: https://maguyva.ai/hi/for-zed

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

> एक 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` जैसी कुंजियों के साथ।

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

```text
# .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 एजेंट को *कोड का नक़्शा* देता है।

## दो वर्कफ़्लो

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

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

```text
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 के पूरे दौर की जगह लेता है। जवाब एक पाथ और लाइन के रूप में आता है जिसे एजेंट सीधे खोल सकता है।

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

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

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

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

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

## Zed में सेटअप

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

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

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

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

`~/.config/zed/settings.json`

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

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

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

Zed के अपने [MCP डॉक्स](https://zed.dev/docs/ai/mcp) कॉन्टेक्स्ट सर्वर, एजेंट प्रोफ़ाइल और टूल परमिशन के बारे में बताते हैं।

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

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