हम Cursor SDK पेश कर रहे हैं, ताकि आप उसी रनटाइम, उपयोग में लाना और मॉडल्स के साथ एजेंट बना सकें जो Cursor को शक्ति देते हैं।

जो एजेंट Cursor desktop app, CLI और वेब ऐप में चलते हैं, वे अब TypeScript की कुछ ही पंक्तियों के साथ उपलब्ध हैं। इसे अपनी मशीन पर या Cursor क्लाउड पर, किसी भी अत्याधुनिक मॉडल के साथ, समर्पित VM पर चलाएँ।

कोडिंग एजेंट्स अब व्यक्तिगत डेवलपर्स के लिए इंटरैक्टिव टूल्स से आगे बढ़कर संगठनों के लिए प्रोग्रामेटिक इन्फ्रास्ट्रक्चर बन रहे हैं। Cursor SDK आपको पूरा एजेंट स्टैक बनाने और बनाए रखने के ओवरहेड के बिना एजेंट परिनियोजित करने देता है। कई टीमें CI/CD पाइपलाइन से सीधे एजेंट्स चला रही हैं, एंड-टू-एंड वर्कफ़्लो के लिए स्वचालन बना रही हैं, और एजेंट्स को अपने मुख्य उत्पादों में एम्बेड कर रही हैं।

Cursor SDK अब सभी उपयोगकर्ताओं के लिए सार्वजनिक बीटा में उपलब्ध है। शुरू करने के लिए npm install @cursor/sdk चलाएँ, फिर निर्माण के दौरान मार्गदर्शन के लिए Cursor के मूल /cursor-sdk कौशल का उपयोग करें।

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

#एजेंट्स को जल्दी प्रोडक्शन में डिप्लॉय करें

आपके डेटा पर सुरक्षित रूप से चलने वाले तेज़, विश्वसनीय और सक्षम कोडिंग एजेंट्स बनाने के लिए काफ़ी इंजीनियरिंग प्रयास की ज़रूरत होती है: सुरक्षित सैंडबॉक्सिंग, स्थायी स्टेट और सत्र प्रबंधन, परिवेश सेटअप और संदर्भ प्रबंधन। और जब कोई नया मॉडल शिप होता है, तो उसकी क्षमताओं का लाभ उठाने के लिए टीमों को अक्सर अपने एजेंट लूप्स पर फिर से काम करना पड़ता है।

Cursor SDK इस जटिलता को दूर करता है, ताकि आप उपयोगी एजेंट्स बनाने पर ध्यान केंद्रित कर सकें।

प्रोडक्शन-तैयार क्लाउड इन्फ्रास्ट्रक्चर का उपयोग करें

SDK से आरंभ किए गए क्लाउड सत्र उसी अनुकूलित रनटाइम पर चलते हैं, जिसका उपयोग हम क्लाउड एजेंट्स के लिए करते हैं। हर एजेंट को मज़बूत सैंडबॉक्सिंग, रेपो का एक क्लोन, और पूरी तरह कॉन्फ़िगर किया हुआ विकास परिवेश के साथ अपना समर्पित VM मिलता है।

जब आपका लैपटॉप स्लीप में चला जाए या नेटवर्क बाधित हो जाए, तब भी एजेंट्स काम करते रहते हैं। आप बातचीत को स्ट्रीम कर सकते हैं और बाद में फिर से कनेक्ट कर सकते हैं। जब एजेंट अपना काम पूरा कर लेता है, तो वह PR खोल सकता है, ब्रांच पुश कर सकता है, या डेमो और स्क्रीनशॉट संलग्न कर सकता है।

// क्लाउड एजेंट आरंभ करें और कार्य शुरू करें...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...बाद में कहीं से भी जाँच करें:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

SDK हमारे अपडेट किए गए Cloud Agents API का उपयोग करता है, जिससे क्लाउड एजेंट रन Cursor की एजेंट्स विंडो और वेब ऐप में दिखाई देते हैं। आप किसी कार्य को प्रोग्रामेटिक रूप से शुरू कर सकते हैं और फिर प्रगति देखने या काम अपने हाथ में लेने के लिए Cursor में जा सकते हैं।

जब आपको अलग रनटाइम की ज़रूरत हो, तो यही SDK स्व-होस्टेड workers पर एजेंट चला सकता है, जिससे कोड और टूल निष्पादन आपके नेटवर्क के भीतर ही रहते हैं, या तेज़ी से दोहराव के लिए आपकी मशीन पर लोकली भी चला सकता है।

पूर्ण Cursor उपयोग में लाने की व्यवस्था का उपयोग करें

SDK के ज़रिए लॉन्च किए गए एजेंट उसी उपयोग में लाने की व्यवस्था का लाभ उठाते हैं, जो हमारे डेस्कटॉप ऐप, CLI और वेब ऐप में Cursor को शक्ति देता है:

• बुद्धिमान संदर्भ प्रबंधन: कोडबेस इंडेक्सिंग, सिमैंटिक खोज और Instant Grep एजेंट्स को सही नतीजे तक ज़्यादा तेज़ी और दक्षता से पहुँचने में मदद करते हैं।
• MCP सर्वर: एजेंट stdio या HTTP के ज़रिए बाहरी टूल और डेटा स्रोतों से जुड़ सकते हैं, चाहे .cursor/mcp.json config file के माध्यम से या call में inline पास करके।
• कौशल: एजेंट आपके repo की .cursor/skills/ directory से कौशल स्वचालित रूप से प्राप्त कर लेते हैं।
• हुक्स: .cursor/hooks.json file के साथ क्लाउड, स्व-होस्टेड और लोकल वातावरणों में एजेंट लूप को देखें, नियंत्रित करें और बढ़ाएँ।
• उप-एजेंट: उप-कार्यों को नामित उप-एजेंट्स को सौंपें, जिनके अपने prompts और मॉडल होते हैं, और जिन्हें मुख्य एजेंट Agent tool के माध्यम से शुरू करता है।

किसी भी मॉडल पर बनाएँ

Cursor SDK आपको Cursor में समर्थित हर मॉडल तक पहुँच देता है। सिर्फ़ एक field बदलकर, एजेंट्स को उस काम के लिए सर्वश्रेष्ठ मॉडल पर रूट करें, जिसमें लागत और क्षमता का आपका मनचाहा संतुलन हो।

और Composer 2 के साथ, जो एक विशेषीकृत कोडिंग मॉडल है और सामान्य-उद्देश्य मॉडल्स की तुलना में बहुत कम लागत पर अत्याधुनिक स्तर का प्रदर्शन देता है, आपको ज़्यादातर कोडिंग एजेंट कार्यों के लिए इंटेलिजेंस और दक्षता का सर्वश्रेष्ठ संयोजन मिलता है।

#डेवलपर्स क्या बना रहे हैं

टीमें कस्टम एजेंट्स को तेज़ी से शिप करने के लिए Cursor SDK का उपयोग कर रही हैं। उदाहरण के लिए, ऐसे प्रोग्रामेटिक एजेंट जिन्हें बदलावों का सारांश तैयार करने, CI विफलताओं के मूल कारण पहचानने, और सुधारों के साथ PRs अपडेट करने के लिए सीधे CI/CD से ट्रिगर किया जाता है। कुछ टीमें कस्टम एजेंट प्लेटफ़ॉर्म भी बना रही हैं, जैसे आंतरिक एप्लिकेशन, जो GTM टीमों को बिना कोड लिखे उत्पाद डेटा पर क्वेरी करने देते हैं।

कुछ ग्राहक Cursor को सीधे ग्राहक-सामना करने वाले उत्पादों में एम्बेड भी कर रहे हैं, जहाँ अंतिम उपयोगकर्ताओं को अब होस्ट एप्लिकेशन छोड़े बिना ही एजेंट जैसा अनुभव मिलता है।

Cursor SDK पर निर्माण कर रहे हमारे कुछ ग्राहकों से सीधे सुनें:

#एक नमूना प्रोजेक्ट से शुरू करें

हमने सार्वजनिक GitHub रेपो में कुछ शुरुआती प्रोजेक्ट जोड़े हैं, जिन्हें आप अपने उपयोग के अनुसार फ़ोर्क करके आगे बढ़ा सकते हैं:

• त्वरित प्रारंभ: एक न्यूनतम Node.js उदाहरण, जो एक लोकल एजेंट बनाता है, एक प्रॉम्प्ट भेजता है, और प्रतिक्रिया को स्ट्रीम करता है।
• प्रोटोटाइपिंग टूल: एक वेब ऐप, जिसमें एजेंट्स स्पॉन करके नए प्रोजेक्ट्स का ढांचा तैयार किया जा सकता है और सैंडबॉक्स्ड क्लाउड परिवेश में विचारों पर तेजी से काम किया जा सकता है।
• कानबन बोर्ड: एजेंट-संचालित कानबन टूल, जहाँ इंजीनियर किसी कार्ड को ड्रैग कर सकते हैं और एजेंट्स प्रोग्रामेटिक रूप से काम शुरू कर सकते हैं, एक PR खोल सकते हैं, और नतीजे को संलग्नक के रूप में वापस पोस्ट कर सकते हैं।
• कोडिंग एजेंट CLI: एक हल्का कमांड-लाइन इंटरफ़ेस, जो आपको अपने टर्मिनल से Cursor एजेंट्स स्पॉन करने देता है।

#आगे क्या

Cursor SDK सभी उपयोगकर्ताओं के लिए उपलब्ध है और इसका बिल मानक, token-आधारित खपत मूल्य निर्धारण के अनुसार किया जाता है।

हम Cursor SDK में लगातार निवेश कर रहे हैं, ताकि टीमों के लिए अधिक भाषाओं, वर्कफ़्लो और परिनियोजन पैटर्न में प्रोग्रामेटिक एजेंट बनाना और भी आसान हो सके।

हमारे दस्तावेज़ पढ़कर और जानें। आप बनाना शुरू करने में मदद के लिए Cursor का मूल /cursor-sdk कौशल भी उपयोग कर सकते हैं।