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

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

Windsurf फ़ाइल को एडिट करता है।
Maguyva पूरा रिपो देखता है।

Windsurf एडिटर है और Cascade एजेंट है। मोनोरिपो में, एजेंट को अब भी यह नक़्शा चाहिए कि कौन-सी फ़ाइल मायने रखती है। Maguyva आपकी कोडबेस को इंडेक्स करता है और उसे MCP (सिमेंटिक, AST, ग्राफ़, और टेक्स्ट) पर वापस देता है, ताकि “auth कहाँ होता है” जैसे सवाल का जवाब असली auth फ़्लो हो, सात टेस्ट स्टब्स नहीं।

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

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

Windsurf वहीं एडिट करता है जहाँ आप इशारा करते हैं। Maguyva Cascade को बताता है किस फ़ाइल पर इशारा करना है।

हर लेयर क्या करती है

चार हिस्से। हर एक का अपना काम।

// एडिटर

Windsurf

जहाँ आप और Cascade असल में काम करते हैं।

// मैनुअल कॉन्टेक्स्ट

@ मेंशन्स + .windsurfrules

मैनुअल कॉन्टेक्स्ट तब तक जीतता है, जब तक रिपो बड़ा न हो जाए।

// कोडबेस

Maguyva

MCP पर ऑटोमैटिक कोडबेस तथ्य।

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

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

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

Windsurf एडिटर है। इसे इस्तेमाल करें।

IDE समस्या नहीं है। Cascade, टैब कम्प्लीशन, मल्टी-फ़ाइल एडिट्स, और .windsurfrules बेहतरीन हैं, और आप पहले से इनका इस्तेमाल करते हैं:

  • खुली हुई फ़ाइल में इनलाइन सुझाव और Cascade एडिट्स।
  • जब बदलाव लोकल हो तो मल्टी-फ़ाइल एडिट्स।
  • रिपो कन्वेंशन और स्टाइल गार्डरेल्स के लिए .windsurfrules।
  • किसी ख़ास फ़ाइल को कॉन्टेक्स्ट में लाने के लिए @-मेंशन्स।

यह करते रहें। इनमें से कुछ भी ख़त्म नहीं होता।

लेकिन असली मोनोरिपो में (वर्कस्पेस डिपेंडेंसीज़ वाला TypeScript, Python सर्विसेज़, मिक्स्ड पैकेज) एजेंट कॉन्टेक्स्ट उसी पल टूट जाता है जब प्रासंगिक फ़ाइल पहले से Cascade के रडार पर नहीं होती।

वे मैनुअल फ़िक्स जो आप पहले ही आज़मा चुके हैं, और वे कहाँ टूटते हैं

चार मैनुअल फ़िक्स, उनके फ़ेलियर मोड के साथ। बाएँ = आप आज क्या करते हैं। दाएँ = वह कहाँ टूटता है।

// the fix

// फ़ाइलों का ज़िक्र करें

आप उन तीन फ़ाइलों को @-मेंशन करते हैं जिन्हें आप ज़रूरी समझते हैं। Cascade उनके अंदर साफ़-सुथरा एडिट करता है।

// where it breaks

// ज़िक्र करना एक अंदाज़ा है

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

// the fix

// स्निपेट्स पेस्ट करें

आप Cascade को पर्याप्त कॉन्टेक्स्ट देने के लिए किसी दूसरे पैकेज की 200 लाइनें पेस्ट करते हैं।

// where it breaks

// पेस्ट किया हुआ कोड बासी हो जाता है

सुबह 9 बजे पेस्ट किया गया स्निपेट, आपके टीममेट द्वारा सुबह 11 बजे किए गए रीबेस को नहीं दिखाता। Cascade पैकेज के एक भूतिया वर्ज़न के आधार पर एडिट कर रहा है।

// the fix

// एक कॉन्टेक्स्ट डॉक लिखें

आप एक .windsurfrules फ़ाइल या आर्किटेक्चर मार्कडाउन लिखते हैं। यह आज सही है।

// where it breaks

// डॉक्स कोड से तेज़ी से बासी होते हैं

जो कुछ भी आप हाथ से लिखते हैं वह बासी हो जाता है। कोड ही सच्चाई का स्रोत है। क्यू लेयर समझाने वाला एक डॉक एक हफ़्ते तक सही रहता है, फिर हमेशा के लिए ग़लत हो जाता है।

// the fix

// rules फ़ाइलें बनाए रखें

आप नेमिंग, लिंट, और बिल्ड कमांड्स के लिए .windsurfrules जोड़ते हैं। बिहेवियर के लिए बेहतरीन।

// where it breaks

// rules ≠ इंडेक्स

.windsurfrules, “कमिट से पहले हमेशा pnpm tsc -b चलाएँ” जैसी बातों के लिए सही जगह है। यह आपके मोनोरिपो के हर सिंबल, फ़ाइल, और कॉल-साइट का क्वेरी करने लायक़ इंडेक्स नहीं है।

Maguyva नीचे वाली लेयर है

Windsurf का विकल्प नहीं। वह रिपो-कॉन्टेक्स्ट लेयर जो Cascade के MCP सपोर्ट से जुड़ी है।

  • सिमेंटिक + AST + ग्राफ़ + टेक्स्ट अर्थ, स्ट्रक्चर, डिपेंडेंसी, या शब्दशः — किसी भी तरह से सर्च करें। हर हिट एक फ़ाइल पाथ और लाइन नंबर लौटाती है।
  • डिफ़ॉल्ट रूप से क्रॉस-पैकेज मोनोरिपो के हर पैकेज में कॉल-साइट्स और इम्पोर्टर्स, न कि सिर्फ़ वह जो Cascade में खुला है।
  • ब्रांच-अवेयर Maguyva उसी वर्ज़न का कोड देखता है जिसे Cascade एडिट कर रहा है।
  • प्रतिस्पर्धी नहीं, पूरक .windsurfrules अपना काम करता रहता है। @-मेंशन्स अपना काम करते रहते हैं। Maguyva वह गैप भरता है जो वे नहीं भरते।

Cascade उसी फ़ाइल को एडिट करता है जिस पर आप इशारा करते हैं।

Maguyva एजेंट को बताता है किस फ़ाइल पर इशारा करना है।

तीन मोनोरिपो वर्कफ़्लो

क्रॉस-पैकेज, क्रॉस-लैंग्वेज। असली कॉल ग्राफ़ के आधार पर ग्राउंडेड, Cascade के grep के आधार पर नहीं।

// workflow 01

बिना किसी का ज़िक्र किए, पैकेजों में auth फ़्लो ढूँढ़ें

cascade> इस मोनोरिपो में authentication कहाँ होता है?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

→ 4 पैकेजों में 4 एंट्री पॉइंट, कॉल-साइट डेंसिटी के अनुसार रैंक्ड।
[exit 0]

आपने किसी फ़ाइल का ज़िक्र नहीं किया। आपने कोई स्निपेट पेस्ट नहीं किया। Cascade के पास वे चार फ़ाइलें हैं जो मायने रखती हैं, सही रैंकिंग में, और वह एक ग्राउंडेड एडिट कर सकता है।

// workflow 02

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

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

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

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

// workflow 03

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

cascade> मोनोरिपो में QueueDispatcher.publish को कौन कॉल करता है?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← gRPC स्टब के ज़रिए क्रॉस-लैंग्वेज
[exit 0]

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

Windsurf के साथ सेटअप

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

  1. // step 01

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

    वह मोनोरिपो चुनें जहाँ आपने सबसे ज़्यादा कॉन्टेक्स्ट की दिक़्क़त महसूस की हो।

  2. // step 02

    Windsurf में Maguyva को MCP सर्वर के तौर पर जोड़ें

    // ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer <your-key>"
      }
    }
  }
}

  3. // step 03

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

    अपनी पूरी कंपनी से शुरुआत न करें। एक रिपो और एक वेरिफ़ाई करने लायक़ सवाल से शुरू करें, जैसे “पैकेजों में formatInvoice को कौन कॉल करता है?”

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

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

एक ऐसा सवाल टेस्ट करें जिसका जवाब आप वेरिफ़ाई कर सकें।

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

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