CLI में एजेंट का उपयोग

मोड्स

CLI में एडिटर जैसे ही मोड्स उपलब्ध हैं। स्लैश कमांड्स या --mode फ्लैग से मोड बदलें।

योजना मोड

कोडिंग शुरू करने से पहले अपना तरीका तय करने के लिए योजना मोड का उपयोग करें। एजेंट आपकी योजना को बेहतर बनाने के लिए स्पष्टीकरणात्मक प्रश्न पूछता है।

• योजना मोड पर जाने के लिए Shift+Tab दबाएँ
• योजना मोड पर स्विच करने के लिए /plan का उपयोग करें
• --plan या --mode=plan फ्लैग के साथ शुरू करें

पूछें मोड

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

• पूछें मोड पर स्विच करने के लिए /ask का उपयोग करें
• --mode=ask फ्लैग के साथ शुरू करें

प्रॉम्प्टिंग

बेहतरीन परिणामों के लिए अपना आशय स्पष्ट रूप से बताना अनुशंसित है। उदाहरण के लिए, एजेंट को किसी भी फ़ाइल में बदलाव करने से रोकने के लिए आप "कोई कोड न लिखें" प्रॉम्प्ट का उपयोग कर सकते हैं। कार्यों को लागू करने से पहले उनकी योजना बनाते समय यह आम तौर पर मददगार होता है।

एजेंट के पास फ़ाइल कार्रवाइयों, खोज, शेल कमांड्स चलाने और वेब पहुंच के लिए उपकरण हैं।

MCP

एजेंट विस्तारित कार्यक्षमता और इंटीग्रेशन के लिए MCP (Model Context Protocol) का समर्थन करता है। CLI आपकी mcp.json कॉन्फ़िगरेशन फ़ाइल को स्वचालित रूप से पहचानकर उसका पालन करेगा, जिससे एडिटर के लिए कॉन्फ़िगर किए गए वही MCP सर्वर और उपकरण उपलब्ध होंगे।

ACP

एजेंट कस्टम क्लाइंट इंटीग्रेशन के लिए ACP (Agent Client Protocol) का भी समर्थन करता है। JSON-RPC मैसेजिंग के साथ stdio पर Cursor CLI को ACP सर्वर के रूप में चलाने के लिए agent acp का उपयोग करें।

नियम

CLI एजेंट, एडिटर की तरह ही नियम प्रणाली का समर्थन करता है। एजेंट को संदर्भ और मार्गदर्शन देने के लिए आप .cursor/rules डायरेक्टरी में नियम बना सकते हैं। ये नियम अपनी कॉन्फ़िगरेशन के आधार पर स्वचालित रूप से लोड और लागू होते हैं, जिससे आप अपने प्रोजेक्ट के अलग-अलग हिस्सों या विशिष्ट फ़ाइल प्रकारों के लिए एजेंट के व्यवहार को अनुकूलित कर सकते हैं।

एजेंट के साथ काम करना

नेविगेशन

ऊपर तीर (ArrowUpArrow Up) का उपयोग करके पिछले संदेशों तक पहुंचा जा सकता है और उनके बीच साइकल किया जा सकता है।

इनपुट शॉर्टकट्स

• Shift+Tab — मोड (एजेंट, योजना, पूछें) के बीच स्विच करें
• Shift+Enter — जमा करने के बजाय नई पंक्ति डालें, जिससे कई पंक्तियों वाले प्रॉम्प्ट लिखना आसान हो जाता है।
• Ctrl+D — CLI से बाहर निकलें। यह मानक शेल व्यवहार का पालन करता है और बाहर निकलने के लिए दो बार दबाना होता है।
• Ctrl+J or +Enter — नई पंक्तियाँ डालने के सार्वभौमिक विकल्प, जो सभी टर्मिनल में काम करते हैं।

समीक्षा

Ctrl+R से परिवर्तनों की समीक्षा करें। फॉलो-अप निर्देश जोड़ने के लिए i दबाएँ। स्क्रॉल करने के लिए ArrowUpArrow Up/ArrowDownArrow Down और फ़ाइलों के बीच स्विच करने के लिए ArrowLeftArrow Left/ArrowRightArrow Right का उपयोग करें।

संदर्भ चुनना

@ से संदर्भ में शामिल करने के लिए फ़ाइलें और फ़ोल्डर चुनें। /summarize चलाकर कॉन्टेक्स्ट विंडो में जगह खाली करें। /compress अब भी एक उपनाम है।

क्लाउड एजेंट हैंडऑफ़

अपनी बातचीत को क्लाउड एजेंट पर पुश करें और आपके दूर रहने के दौरान उसे चलता रहने दें। किसी संदेश को क्लाउड पर भेजने के लिए उसके आगे & जोड़ें। वेब या मोबाइल पर cursor.com/agents से इसे फिर से शुरू करें।

# बातचीत के बीच में ही क्लाउड एजेंट को कोई कार्य भेजें& refactor the auth module and add comprehensive tests

CLI वर्कट्रीज़

एजेंट को आपके मौजूदा checkout में सीधे संपादन करने के बजाय नई Git worktree में चलाने के लिए -w या --worktree [name] दें। Cursor इन checkouts को एडिटर से बनाई गई worktrees के साथ-साथ ~/.cursor/worktrees/<reponame>/<name> के अंतर्गत बनाता है। अगर आप name नहीं देते हैं, तो Cursor इसे जनरेट कर देता है।

Cursor, एडिटर worktrees के लिए लागू समान retention नियमों के अनुसार CLI वर्कट्रीज़ का क्लीनअप करता है। क्लीनअप सेटिंग्स और सीमाओं के लिए, पुरानी worktrees का क्लीनअप कैसे किया जाता है? देखें।

जब आपको स्पष्ट रिपॉज़िटरी root की आवश्यकता हो, तो --workspace <path> का उपयोग करें। अन्यथा, CLI मौजूदा वर्किंग डायरेक्टरी का उपयोग करता है। --worktree केवल यह बदलता है कि एजेंट उस प्रोजेक्ट में file edits कहाँ करता है।

# मौजूदा रिपॉज़िटरी से जनरेट किए गए नाम वाला एक अस्थायी worktree बनाएंagent --worktree "upgrade the test runner and fix any broken snapshots"# किसी दूसरी रिपॉज़िटरी से नाम दिया गया worktree बनाएंagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

इतिहास

पिछला संदर्भ लोड करने के लिए --resume [thread id] के साथ किसी मौजूदा थ्रेड को फिर से शुरू करें।

सबसे हाल की बातचीत फिर से शुरू करने के लिए agent resume, --continue या /resume स्लैश कमांड का उपयोग करें।

पिछली चैट खोलने और उनमें से किसी एक को फिर से शुरू करने के लिए agent ls भी चला सकते हैं।

कमांड अनुमोदन

टर्मिनल कमांड चलाने से पहले, CLI आपसे उसके निष्पादन को अनुमोदित (y) या अस्वीकार (n) करने के लिए कहेगा।

गैर-इंटरैक्टिव मोड

गैर-इंटरैक्टिव मोड में एजेंट चलाने के लिए -p या --print का उपयोग करें। इससे प्रतिक्रिया कंसोल पर प्रिंट होगी।

गैर-इंटरैक्टिव मोड में आप एजेंट को प्रोग्रामेटिक तरीके से चला सकते हैं। इससे आप इसे स्क्रिप्ट्स, CI पाइपलाइनों आदि में एकीकृत कर सकते हैं।

आउटपुट के प्रारूप को नियंत्रित करने के लिए इसे --output-format के साथ जोड़ सकते हैं। उदाहरण के लिए, स्क्रिप्ट्स में आसानी से पार्स किए जा सकने वाले संरचित आउटपुट के लिए --output-format json का उपयोग करें, या एजेंट की अंतिम प्रतिक्रिया के सादे टेक्स्ट आउटपुट के लिए --output-format text का उपयोग करें।