Cursor Origin ट्यूटोरियल: CLI सेटअप, GitHub मिररिंग, और पुल रिक्वेस्ट्स

Cursor Origin क्या है?

Cursor Origin एक Git forge है। यह रिपॉजिटरी होस्ट करता है, GitHub प्रोजेक्ट्स का मिरर बनाता है, और पुल रिक्वेस्ट व कोड ब्राउज़िंग सपोर्ट करता है। Origin रिपॉजिटरी Cursor के क्लाउड एजेंट्स और ऑटोमेशन के साथ भी काम करती हैं।

Cursor Origin और GitHub में क्या अंतर है?

Origin, GitHub की हर सुविधा कवर नहीं करता। पब्लिक रिपॉजिटरीज़ डाक्यूमेंटेड नहीं हैं, और मिरर में GitHub Issues, GitHub Actions वर्कफ़्लो, और Actions सीक्रेट्स शामिल नहीं होते। पब्लिक रिपॉजिटरी, Issues, Actions, और थर्ड-पार्टी ऐप्स के लिए GitHub अभी भी व्यापक प्लेटफ़ॉर्म है, इसलिए आज Origin एक संकरा सर्विस है।

मुख्य फर्क परिचित Git वर्कफ़्लो के नीचे है: Cursor ने एजेंट्स द्वारा उत्पन्न ब्रांच और कमिट वॉल्यूम के लिए अलग स्टोरेज लेयर बनाई है। Cursor इसे "एजेंट स्केल" कहता है: ऐसे वर्कलोड जहाँ कई एजेंट्स एक ही रिपॉजिटरी पर ब्रांच बनाते, कमिट करते, और पुल रिक्वेस्ट खोलते हैं।

Cursor ने अपना Git होस्ट क्यों बनाया?

स्टोरेज डिज़ाइन समझाता है कि Cursor ने किसी मौजूदा होस्ट पर एक और इंटरफ़ेस जोड़ने के बजाय नया Git होस्ट क्यों बनाया।

Cursor की Continuity पर इंजीनियरिंग पोस्ट यह वर्णन करती है कि मौजूदा Git होस्ट एक रिपॉजिटरी को कई सर्वरों पर रखते हैं और तब पुश को कमिट करते हैं जब बहुमत सहमत हो। Cursor कहता है कि यह मॉडल महँगा पड़ता है जब सिस्टम में हज़ारों शॉर्ट-लिव्ड रिपॉजिटरीज़ हों या एक ही रिपॉजिटरी पर बार-बार पुश हों।

Cursor Origin का Continuity स्टोरेज कैसे काम करता है?

Continuity, या "Cnt", Origin के पीछे का स्टोरेज सिस्टम है। यह S3-कम्पैटिबल ऑब्जेक्ट स्टोरेज में एक write-ahead लॉग को सोर्स ऑफ़ ट्रुथ के रूप में स्टोर करता है। लोकल डिस्क पर Git रिपॉजिटरी एक वार्म कैश है जिसे लॉग से दोबारा बनाया जा सकता है।

Continuity, Git writes को ऑब्जेक्ट्स के रूप में स्टोर करता है। चित्र: लेखक।

क्योंकि ऑब्जेक्ट लॉग वास्तविक रिकॉर्ड है, Cursor व्यस्त रिपॉजिटरीज़ के लिए रीड रेप्लिका जोड़ सकता है और मांग घटने पर उन्हें हटा सकता है। Cursor के परीक्षणों में, 100 रेप्लिका तक जोड़ने से रीड थ्रूपुट बढ़ा। सिस्टम ने स्टैण्डर्ड S3 पर प्रति सेकंड 120 पुश तक संभाले, लेकिन ये आँकड़े किसी स्वतंत्र बेंचमार्क द्वारा जाँचे नहीं गए हैं।

उपयोगकर्ता के लिए मुख्य असर सरल है: व्यस्त रिपॉजिटरी रीड क्षमता बढ़ा सकती है, जबकि शॉर्ट-लिव्ड रिपॉजिटरी को हर सर्वर पर स्थायी लोकल कॉपी की ज़रूरत नहीं होती।

Cursor Origin तक किसकी पहुँच है?

Origin, Pro, Teams, और Enterprise प्लान्स पर उपलब्ध है, फ्री प्लान्स पर नहीं। एक्सेस चरणों में रोल आउट होता है, इसलिए पात्र प्लान होने पर भी Codebase टैब तुरंत नज़र आना तय नहीं है। Pro पर आप एक व्यक्तिगत namespace के मालिक होते हैं और अपना codebase नाम क्लेम करते हैं।

Enterprise एडमिन इसे अपनी ऑर्गनाइज़ेशन के लिए डिसेबल कर सकते हैं। Cursor के ओवरव्यू में कहा गया है कि कोई भी टीम मेंबर पहला codebase नाम क्लेम कर सकता है, जबकि Codebase Settings पेज कहता है कि टीम एडमिन को इसे क्लेम करना चाहिए। सेटअप से पहले अपनी टीम में यह परमिशन जाँचें।

Cursor Origin CLI क्या है?

Origin ऑथेंटिकेशन, रिपॉजिटरी, पुल रिक्वेस्ट, और अकाउंट कॉन्फ़िगरेशन के लिए अपना कमांड-लाइन टूल देता है।

Cursor Origin CLI बनाम Cursor Agent CLI

Origin का CLI, Cursor के Agent CLI से अलग बाइनरी है, origin, जबकि Agent CLI agent के रूप में चलता है। 

मुझे नाम आसानी से गड़बड़ाने वाले लगे क्योंकि origin Git रिमोट का पारंपरिक नाम भी है। इस आर्टिकल में, "push to origin" का मतलब Git रिमोट है, जबकि "run origin" का मतलब CLI चलाना है।

Origin CLI किन प्लेटफ़ॉर्म्स पर सपोर्टेड है?

Cursor macOS, Linux, और WSL के जरिए Windows को डॉक्यूमेंट करता है। मेरे टेस्ट के समय, Windows का मतलब WSL था क्योंकि कोई नेटिव इंस्टॉलर नहीं था।

यदि आप Windows पर फॉलो कर रहे हैं, तो CLI इंस्टॉल करने से पहले Ubuntu टर्मिनल खोलें। PowerShell में शेल इंस्टॉलर चलाना वही सेटअप नहीं है।

Cursor Origin CLI कमांड्स

Cursor Origin CLI में फिलहाल नौ कमांड समूह हैं।

अधिकांश रेपो कमांड्स लक्ष्य को origin नामक Git रिमोट से पढ़ते हैं। -R owner/repo विकल्प लक्ष्य को सीधे सेट करता है, जो ऐसे स्क्रिप्ट में उपयोगी है जो कई रिपॉजिटरीज़ पर चल सकता है। ruleset कमांड्स केवल मौजूदा पुश और मर्ज रूल्स दिखाते हैं; वे उन्हें बदलते नहीं।

Cursor Origin CLI कैसे इंस्टॉल और लॉग-इन करें

Cursor, CLI को पैकेज मैनेजर के बजाय एक शेल स्क्रिप्ट के जरिए देता है। कमांड Cursor केsor के इंस्टॉल पेज से आता है।

Cursor Origin CLI कैसे इंस्टॉल करें

इंस्टॉल एक ही लाइन में हो जाता है:

curl -fsSL https://downloads.cursor.com/origin/install.sh | sh

इंस्टॉलर ने origin को यहाँ रखा: ~/.local/bin/origin। यदि आपकी टीम स्क्रिप्ट्स को चलाने से पहले रिव्यू करती है, तो स्क्रिप्ट को पहले डाउनलोड करें, सीधे sh में पाइप करने के बजाय।

Origin CLI में "command not found" त्रुटि ठीक करना

यदि इंस्टॉल के बाद आपका शेल origin नहीं ढूँढ पा रहा, तो उसकी डायरेक्टरी PATH में जोड़ें:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

bash पर ~/.zshrc की जगह ~/.bashrc रखें। यह प्रति मशीन एक बार की फिक्स है।

इंस्टॉल और लॉगिन जाँचना

इंस्टॉल कन्फर्म करने के लिए origin --version और origin --help चलाएँ, फिर Cursor का ब्राउज़र साइन-इन फ्लो खोलने के लिए origin auth login उपयोग करें।

WSL में वेरिफिकेशन आउटपुट कुछ ऐसा दिखा:

Origin CLI वर्ज़न और हेल्प आउटपुट। चित्र: लेखक।

हेडलैस वातावरण में, CLI इसके बजाय एक URL प्रिंट करता है। लॉगिन Git के क्रेडेंशियल हेल्पर को भी कॉन्फ़िगर करता है, इसलिए Origin रिमोट के लिए अलग Git टोकन की ज़रूरत नहीं। सेशन जाँचने के लिए बाद में origin auth status चलाएँ।

ब्राउज़र के बिना Cursor API कुंजी का उपयोग

CI या स्क्रिप्ट्स के लिए, origin auth login --api-key <key> चलाएँ या CURSOR_API_KEY सेट करें, फिर origin auth login चलाएँ। कुंजी को कमिटेड फ़ाइलों से दूर रखें। CURSOR_AUTH_TOKEN अलग है और एक bearer token की अपेक्षा करता है।

Cursor Origin रिपॉजिटरी कैसे बनाएं, क्लोन करें, और पुश करें

साइन-इन के बाद, आप वेब पेज या CLI से रिपॉजिटरी बना सकते हैं। पुश करने के लिए मानक Git कमांड्स का उपयोग होता है।

origin repo create से रिपॉजिटरी बनाना

cursor.com/codebase से, New चुनें, नाम दर्ज करें, और Internal या Private विज़िबिलिटी चुनें। 

CLI से, origin repo create my-project आपके अकाउंट के namespace का उपयोग करता है। टीम namespace के लिए ओनर शामिल करें, जैसे origin repo create acme/my-project। वैकल्पिक --default-branch फ़्लैग सर्वर डिफ़ॉल्ट main को बदलता है।

कमांड origin repo clone acme/my-project, CLI द्वारा सेव्ड लॉगिन के साथ HTTPS पर रिपॉजिटरी क्लोन करता है।

Origin पर अपना पहला कमिट पुश करना

पहले पुश के बाद, रिपॉजिटरी Codebase में दिखती है:

रिपॉजिटरी पुश की गई और Codebase में दिख रही है। वीडियो: लेखक।

एक बिल्कुल नई खाली रिपॉजिटरी के लिए, इसे क्लोन करें, एक फ़ाइल जोड़ें, और पुश करें:

git clone https://origin.cursor.com/{owner}/{repo}.git
cd {repo}
echo "# {repo}" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

यदि Git, WSL में /mnt के अंतर्गत .git/config.lock परमिशन त्रुटि रिपोर्ट करता है, तो इसकी बजाय ~ के अंतर्गत क्लोन करें। मेरे टेस्ट में इससे त्रुटि ठीक हो गई।

पुश के बाद, Codebase खोलें और जाँचें कि कमिट दिख रहा है। Code टैब फ़ाइल ट्री और कमिट हिस्ट्री दिखाता है। T दबाएँ Go to file के लिए, या सर्च फ़ील्ड से कोड सर्च करें।

मौजूदा Git रिपॉजिटरी को Origin पर पुश करना

यदि आपके पास पहले से Git हिस्ट्री वाला प्रोजेक्ट है, तो पहले git remote -v चलाएँ। नीचे दिया कमांड तभी लागू है जब रिपॉजिटरी में पहले से origin नाम का रिमोट न हो:

git remote add origin https://origin.cursor.com/{owner}/{repo}.git
git push -u origin main

यदि origin पहले से GitHub की ओर पॉइंट कर रहा है, तो मौजूदा URL बदलने के बजाय cursor जैसा कोई और रिमोट नाम उपयोग करें। Origin CLI कमांड्स उस नाम से रिपॉजिटरी इन्फर नहीं करेंगे, इसलिए उन्हें चलाते समय -R owner/repo पास करें।

Cursor Origin में GitHub रिपॉजिटरी कैसे मिरर करें

मिरर, मौजूदा GitHub प्रोजेक्ट को Origin में कॉपी करता है और दोनों सेवाओं को कनेक्टेड रखता है।

Cursor Origin GitHub मिररिंग आवश्यकताएँ

आपको Origin एक्सेस, उस ऑर्गनाइज़ेशन या अकाउंट से जुड़ा Cursor GitHub ऐप जो रिपॉजिटरी का ओनर है, और उस रिपॉजिटरी पर GitHub एडमिन एक्सेस चाहिए। केवल राइट एक्सेस काफ़ी नहीं है।

Cursor Origin GitHub मिरर शुरू करना

cursor.com/codebase से, Sync from GitHub चुनें, ऑर्गनाइज़ेशन और रिपॉजिटरी चुनें, और कन्फर्म करें। CLI विकल्प origin repo create-mirrored owner/repo है, जो Cursor के मिररिंग डॉक्स में कवर है।

Cursor Origin, GitHub से क्या मिरर करता है

Origin Git डेटा को मिरर करता है, लेकिन हर GitHub फीचर नहीं:

GitHub Actions GitHub पर ही चलते रहते हैं। Depot और Buildkite इंटीग्रेशन Origin-होस्टेड रिपॉजिटरी पर लागू होते हैं, मिरर कॉपी पर नहीं।

जब GitHub सोर्स ऑफ़ ट्रुथ बना रहता है

जब तक रिपॉजिटरी मिरर की गई है, Origin के जरिए किए गए पुश GitHub तक पास-थ्रू होते हैं। Detach from GitHub, रिपॉजिटरी Settings में, Origin कॉपी को स्टैंडअलोन बना देता है, GitHub रिपॉजिटरी बदले बिना।

Cursor Origin पुल रिक्वेस्ट कैसे खोलें और रिव्यू करें

Origin पुल रिक्वेस्ट, अन्य Git होस्ट्स जैसे ही ब्रांच, पुश, और रिव्यू क्रम का उपयोग करते हैं। हमारा पुल रिक्वेस्ट कैसे काम करते हैं गाइड उस क्रम को समझाता है।

ब्रांच बनाना और बदलाव पुश करना

वर्किंग ब्रांच बनाएँ और पुश करें:

git checkout -b my-change
echo "Example change" >> README.md
git add README.md
git commit -m "Add example change"
git push -u origin my-change

Git ने अपना काम कर दिया; अगला कमांड Origin का है।

Origin CLI से पुल रिक्वेस्ट खोलना

रिपॉजिटरी कमांड्स लक्ष्य को origin नामक Git रिमोट से इन्फर करते हैं। origin pr create चलाएँ, या रिपॉजिटरी सीधे सेट करने के लिए -R owner/repo पास करें। कमांड डिफ़ॉल्ट रूप से एक ड्राफ्ट बनाता है; रिव्यू के लिए तैयार PR के लिए --status open पास करें।

Cursor Origin पुल रिक्वेस्ट की समीक्षा

CLI में origin pr list, origin pr view, origin pr diff, और origin pr checks शामिल हैं। बिना किसी CI ऐप के, origin pr checks ने मेरे टेस्ट में No checks reported. प्रिंट किया और कोड 1 के साथ एग्ज़िट किया।

यह एग्ज़िट कोड उन शेल स्क्रिप्ट्स में मायने रखता है जो set -e उपयोग करती हैं, क्योंकि खाली Checks टैब स्क्रिप्ट को रोक सकता है जबकि पुल रिक्वेस्ट खुद ठीक है।

चार टैब्स वाला पुल रिक्वेस्ट रिव्यू। चित्र: लेखक।

वेब व्यू में, हर पुल रिक्वेस्ट के चार टैब होते हैं: Activity, Commits, Checks, और Files Changed, साथ ही समीक्षक अनुरोध, इनलाइन टिप्पणियाँ, और मर्ज बटन। वेब पेज मर्ज कॉन्फ्लिक्ट दिखाता है, और origin pr status --conflict-status उन्हें टर्मिनल से रिपोर्ट करता है।

टर्मिनल origin pr merge को भी सपोर्ट करता है। Origin-होस्टेड रिपॉजिटरी पर बनाए गए पुल रिक्वेस्ट Origin पर ही रहते हैं, जबकि मिरर की गई रिपॉजिटरी पर की गई गतिविधि GitHub पर भेजी जाती है।

Cursor Origin टीम एक्सेस और रिपॉजिटरी परमिशन

Origin परमिशन, codebase और रिपॉजिटरी दोनों स्तरों पर मौजूद हैं।

Codebase सेटिंग्स बनाम रिपॉजिटरी सेटिंग्स

Codebase सेटिंग्स टीम-स्तरीय होती हैं: कौन Origin ऑन कर सकता है, रिपॉजिटरी बना सकता है, और ऐप्स इंस्टॉल कर सकता है। रिपॉजिटरी सेटिंग्स एक रिपॉजिटरी तक सीमित होती हैं और General, Permissions, Rules और Protections, और Apps को कवर करती हैं, हालांकि Cursor के डॉक्स चेतावनी देते हैं कि Permissions और Rules स्क्रीन फिर से डिज़ाइन की जा रही हैं।

यदि कोई टीममेट Origin का उपयोग कर सकता है लेकिन एक रिपॉजिटरी नहीं खोल पा रहा, तो टीम-स्तरीय सेटिंग्स के बजाय उस रिपॉजिटरी की परमिशन जाँचें।

Internal बनाम Private रिपॉजिटरी

प्रतिबंधित एक्सेस वाली दो तरह की रिपॉज़िटरी हैं:

• Internal रिपॉजिटरी codebase एक्सेस वाले टीम मेंबर्स को दिखाई देती हैं। 
• Private रिपॉजिटरी केवल सीधे एक्सेस दिए गए या codebase परमिशन के माध्यम से एक्सेस प्राप्त मेंबर्स को दिखाई देती हैं। रिपॉजिटरी को private में स्विच करने से बदलाव करने वाला व्यक्ति एडमिन बना रहता है।

Cursor Origin रिपॉजिटरी एक्सेस कैसे जाँचें

कमांड origin repo list मौजूदा अकाउंट को दिखाई देने वाली हर रिपॉजिटरी दिखाता है। किसी एक रिपॉजिटरी तक किसकी पहुँच है, यह रिव्यू करने के लिए Settings खोलें, फिर Permissions।

Cursor Origin सर्वोत्तम प्रथाएँ

Origin के साथ काम करते समय तीन बातें ध्यान में रखना बहुत ज़रूरी है:

• किसी रिपॉजिटरी को डिलीट या री-कॉन्फ़िगर करने से पहले, पूरा owner/repo मान कन्फर्म करें और उसके रिमोट्स जाँचें। 

• लक्ष्य वेरिफ़ाई होने तक -y से बचें। 

• Cursor के परमिशन पेज परस्पर-विरोधी हैं, इसलिए एक्सेस बदलाव ऑटोमेट करने से पहले मौजूदा डॉक्स जाँचें।

Cursor Origin बनाम GitHub: फ़ीचर तुलना

Origin, Cursor के एजेंट वर्कफ़्लो से जुड़ा है, जबकि GitHub व्यापक रिपॉजिटरी इकोसिस्टम कवर करता है।

Git होस्टिंग, पुल रिक्वेस्ट, और CI/CD

हर सेक्शन दोहराने के बजाय, यहाँ फ़ीचर स्प्लिट का छोटा वर्ज़न है:

एजेंट वाली पंक्ति वह है जिसे संदर्भ चाहिए।

एजेंट वर्कफ़्लो के लिए Cursor Origin बनाम GitHub

दोनों प्लेटफ़ॉर्म एजेंट्स को रिपॉजिटरीज़ पर काम करने देते हैं। Origin उस लूप को Cursor के भीतर रखता है; GitHub इसे अपने Agents पैनल और Copilot टूल्स के जरिए देता है, जिसमें GA CLI भी शामिल है।

Cursor Origin, GitHub, या दोनों का इस्तेमाल कब करें

• Origin का उपयोग करें जब रिपॉजिटरी internal या private हो, ज़्यादातर एजेंट काम पहले से Cursor के भीतर होता हो, और आपका डिप्लॉयमेंट या CI सेटअप Vercel, Depot, या Buildkite के जरिए चल सकता हो।
• GitHub को प्राथमिक होस्ट रखें जब प्रोजेक्ट पब्लिक हो, Issues और Actions रोज़मर्रा के वर्कफ़्लो का हिस्सा हों, या टीम GitHub के ऐप मार्केटप्लेस पर निर्भर हो।
• दोनों का उपयोग करें जब आप Origin की कोड ब्राउज़िंग और एजेंट वर्कफ़्लो चाहते हों बिना सोर्स रिपॉजिटरी को मूव किए। मिरर, पुश और पुल रिक्वेस्ट गतिविधि को GitHub से जोड़े रखता है जबकि वही कोड Origin में उपलब्ध कराता है।

अंतिम विचार

मैंने एक ताज़ा WSL इंस्टॉल से Origin पर एक खुली पुल रिक्वेस्ट तक, वही ब्रांच, कमिट, और पुश फ्लो से गया जो मैं GitHub के साथ उपयोग करता हूँ। CLI ने Git के काम करने का तरीका नहीं बदला; Origin के फर्क होस्टिंग, परमिशन, और मिररिंग के आस-पास दिखे।

इस्तेमाल के बाद, मैं Origin को GitHub के साथी के रूप में ट्रीट करूँगा, पूर्ण विकल्प के रूप में नहीं। मौजूदा रिपॉजिटरी के लिए मिररिंग सबसे व्यावहारिक एंट्री पॉइंट है क्योंकि GitHub प्राधिकृत बना रह सकता है। पब्लिक प्रोजेक्ट्स और Actions-हेवी वर्कफ़्लो के पास अभी भी मूव करने का कम कारण है।

संबंधित रीडिंग के लिए, हमारा Cursor Automations गाइड उन एजेंट टास्क्स को कवर करता है जो मौजूदा रिपॉजिटरी के खिलाफ चलते हैं। हमारा GitHub क्या है और इसका उपयोग कैसे करें गाइड GitHub वर्कफ़्लो को और विस्तार से समझाता है।