# Warp का एजेंट टर्मिनल में रहता है। उसे रिपो का नक्शा दें।

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

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).

Warp का एजेंट कमांड चलाता है और उनका आउटपुट पढ़ता है। Maguyva पूरा रिपो इंडेक्स करता है और उसे MCP पर देता है, ताकि एजेंट कुछ मैच होने तक grep और cat चलाने के बजाय पूछे कि कोड कहां है।

> ~/.warp/.mcp.json में एक mcpServers एंट्री: एक URL और एक Authorization हेडर।

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

Warp से जुड़ी चार खास बातें।

### ~/.warp/.mcp.json

Warp इस ग्लोबल फ़ाइल के सर्वर खुद शुरू करता है। आप वही JSON Settings → Agents → MCP servers → + Add में भी पेस्ट कर सकते हैं।

### रिमोट, URL से

`url` एंट्री Streamable HTTP या SSE पर कनेक्ट होती है। लोकल कुछ नहीं चलता और Node.js की ज़रूरत नहीं।

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

कुंजी सीधे `Authorization` हेडर में जाती है। इसे ग्लोबल फ़ाइल में रखें, प्रोजेक्ट की उस `.warp/.mcp.json` में नहीं जिसे आप कमिट करते हैं।

### कभी अपने-आप शुरू नहीं होतीं

Warp क्लोन किए गए रिपो में `.warp/.mcp.json` पहचान लेता है, लेकिन हर सर्वर को आपके शुरू करने का इंतज़ार करता है। यह सेटिंग चालू करने पर वह Claude Code और Codex की कॉन्फ़िग से भी सर्वर पढ़ सकता है।

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

```text
# AGENTS.md
- किसी बदलाव को पूरा कहने से पहले make test चलाओ।
- तात्कालिक कमांड नहीं, bin/ की स्क्रिप्ट इस्तेमाल करो।
```

Warp प्रोजेक्ट नियम `AGENTS.md` से पढ़ता है (या `WARP.md` से, जो दोनों होने पर प्राथमिकता पाता है) और ग्लोबल नियम हर जगह लागू करता है। इन्हें इनके लिए इस्तेमाल करें:

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

नियम एजेंट को बताते हैं कि कैसे काम करना है। वे यह नहीं बता सकते कि कौन-सी सर्विस अब भी वह एनवायरनमेंट वेरिएबल पढ़ती है जिसे आप हटाने वाले हैं।

## जहां टर्मिनल में grep कम पड़ता है

तीन बातें जो एक शेल सेशन सस्ते में नहीं सीख सकता।

### // आउटपुट निकल जाता है

एजेंट जो भी grep और cat चलाता है, वह बातचीत में पहुंच जाता है। दो सौ लाइनें छापने वाली सर्च असली काम शुरू होने से पहले ही कॉन्टेक्स्ट खर्च कर देती है।

### // मैच कॉलर नहीं है

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

### // शेल शून्य से शुरू होता है

नया सेशन रिपो के बारे में कुछ नहीं जानता। Maguyva का इंडेक्स पहले से बना है, इसलिए पहले ही सवाल को रैंक किया गया जवाब मिलता है।

## Warp MCP सर्वर के तौर पर Maguyva

एक mcpServers एंट्री Warp एजेंट को देती है:

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

> Warp एजेंट को *एक टर्मिनल* देता है।
> Maguyva एजेंट को *कोड का नक़्शा* देता है।

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

पहले नक्शे से पूछें, फिर कमांड चलाएं।

### 01. फ़ेल होती स्क्रिप्ट को उसके स्रोत तक ट्रेस करें

```text
warp agent> deploy.sh फ़ेल हो रहा है: BUILD_ID सेट नहीं है। यह कहां सेट होता है?

text_pattern_search("BUILD_ID=")
  ci/env.sh:9   export BUILD_ID=...
  docs/deploy.md:31   ← टेक्स्ट

→ एजेंट ci/env.sh को source करता है और डिप्लॉय फिर से चलाता है।
[exit 0]
```

एक इंडेक्स्ड सर्च पूरे रिपो पर रिकर्सिव grep और उसके आउटपुट की जगह ले लेती है।

### 02. बूट स्टेप बदलने से पहले कॉलर जांचें

```text
warp agent> क्या हम स्टार्टअप पर माइग्रेशन चलाना बंद कर सकते हैं?

dependency_search("runMigrations", dependents)
  3 कॉलर: server.ts, worker.ts, scripts/seed.ts

→ एजेंट तीनों को रिलीज़ स्टेप में ले जाता है।
[exit 0]
```

कॉलर बदलाव से पहले आ जाते हैं, इसलिए worker पुराने स्कीमा पर बूट नहीं होता।

## Warp में सेटअप

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

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

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

### 02. Maguyva को ~/.warp/.mcp.json में जोड़ें

`~/.warp/.mcp.json`

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

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

`mgv_xxxx` की जगह अपनी API कुंजी डालें और सेव करें। Settings → Agents → MCP servers में देखें कि सर्वर चल रहा है, फिर एक ऐसा सवाल पूछें जिसका जवाब आप पहले से जानते हैं।

Warp के [MCP डॉक्स](https://docs.warp.dev/agents/capabilities/mcp/) फ़ाइल-आधारित सर्वर, शेयरिंग और ऑथेंटिकेशन के बारे में बताते हैं।

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

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