कमिट और पुश

फ़ाइलें स्टेज करें, कमिट मैसेज हाथ से लिखें या AI एजेंट से लिखवाएँ, और कुछ ही क्लिक में अपने रिमोट पर पुश करें।

जब आप diff की समीक्षा कर चुके हों और AI एजेंट के किए बदलावों से संतुष्ट हों, तो अब कमिट और पुश करने का समय है। यह गाइड स्टेजिंग से लेकर आपके रिमोट रिपॉज़िटरी पर पुश करने तक का पूरा वर्कफ़्लो समझाती है।

बदलाव स्टेज करें

स्टेजिंग से आप तय करते हैं कि इस कमिट में ठीक-ठीक कौन-से बदलाव जाएँगे। उदाहरण के लिए, आप फ़ीचर का कोड और config का बदलाव अलग-अलग कमिट करना चाह सकते हैं।

Git पैनल में, हर बदली हुई फ़ाइल Unstaged Changes सेक्शन में दिखती है:

  • किसी फ़ाइल को अलग से स्टेज करने के लिए उसके बगल का चेकबॉक्स चुनें
  • सभी बदली हुई फ़ाइलें एक साथ स्टेज करने के लिए Stage All पर क्लिक करें
  • किसी फ़ाइल को अनस्टेज करने के लिए चेकबॉक्स हटा दें — वह वापस Unstaged में चली जाती है

स्टेज की गई फ़ाइलें साइडबार में सबसे ऊपर Staged Changes सेक्शन में चली जाती हैं। कमिट में केवल स्टेज की गई फ़ाइलें ही शामिल होंगी।

आप पूरी फ़ाइल की जगह अलग-अलग hunks (फ़ाइल के हिस्से) भी स्टेज कर सकते हैं। diff व्यू में किसी hunk पर माउस ले जाएँ और दिखने वाले + बटन पर क्लिक करें, तो सिर्फ़ वही हिस्सा स्टेज होगा। यह तब काम आता है जब एक फ़ाइल में दो असंबंधित बदलाव हों और आप अभी उनमें से केवल एक कमिट करना चाहते हों।

बदलाव फ़ोल्डर ट्री के रूप में देखें

एजेंट चौड़े और उथले diff बनाते हैं — चार डायरेक्टरी और अठारह फ़ाइलों को छूने वाला बदलाव आम बात है। फ़्लैट सूची इसे लगभग एक जैसे पाथ की अठारह पंक्तियों में बदल देती है।

Filter बॉक्स के बगल का टॉगल Changes सूची को फ़्लैट सूची और VS Code जैसे फ़ोल्डर ट्री के बीच बदलता है, और आपका चुनाव अगली बार डायलॉग खोलने पर भी बना रहता है।

फ़ोल्डर-ट्री मोड में Git Changes डायलॉग: scripts, src/main/database/adapters और renderer/components के अंतर्गत नेस्ट की गई 18 बदली हुई फ़ाइलें, हर डायरेक्टरी पंक्ति पर प्रति-फ़ोल्डर स्टेजिंग चेकबॉक्स के साथ

  • फ़ोल्डर का चेकबॉक्स उसके नीचे की हर चीज़ को एक क्लिक में स्टेज या अनस्टेज कर देता है, इसलिए क्षेत्र के हिसाब से समीक्षा करना और क्षेत्र के हिसाब से स्टेज करना एक ही क्रिया बन जाती है।
  • फ़ोल्डर पर डैश का मतलब है कि वह आंशिक रूप से स्टेज है। आंशिक स्टेजिंग अनजाने में हो जाना आसान है और फ़्लैट सूची में लगभग दिखती ही नहीं; तीन-स्थिति वाला चेकबॉक्स इसे डायरेक्टरी स्तर पर सामने ला देता है।
  • सब समेटें / सब फैलाएँ कई डायरेक्टरी में फैले बदलावों को संभालना आसान बनाते हैं।

फ़्लैट सूची जैसी थी वैसी ही है और हर पंक्ति पर पूरा पाथ दिखाती है, उन मौकों के लिए जब बदलाव इतने कम हों कि ग्रुपिंग बस एक अतिरिक्त क्लिक बन जाए।

कमिट मैसेज लिखें

फ़ाइलें स्टेज होने के बाद, Git पैनल के नीचे दिए टेक्स्ट फ़ील्ड में अपना कमिट मैसेज लिखें।

अच्छा कमिट मैसेज आपकी हिस्ट्री को पढ़ने लायक बनाता है — आपके भविष्य के स्वयं के लिए और प्रोजेक्ट पर काम करने वाले हर किसी के लिए। कुछ सुझाव:

  • आज्ञार्थक (imperative) रूप का उपयोग करें — "Add login form" लिखें, "Added login form" या "Adding login form" नहीं
  • बताएँ कि क्या बदला और क्यों — "Fix null check in user.ts" केवल "fix bug" से कहीं ज़्यादा उपयोगी है
  • पहली पंक्ति 72 अक्षरों से कम रखें — ज़्यादातर git टूल लिस्ट व्यू में लंबे मैसेज काट देते हैं
  • ज़रूरत हो तो बॉडी जोड़ें — पहली पंक्ति के बाद दो बार Enter दबाकर नीचे लंबा विवरण जोड़ें

साफ़ कमिट मैसेज के उदाहरण:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

एजेंट से लिखवाएँ

कमिट सारांश में मौजूद स्पार्कल बटन आपका diff इंस्टॉल किए गए किसी AI CLI को सौंपता है और उससे मैसेज माँगता है।

  • तय करें कि कौन-सा एजेंट लिखे, या 1DevTool को आपके इंस्टॉल किए पहले एजेंट का उपयोग करने दें। Kimi Code बाकी एजेंटों के साथ सूची में मौजूद है। कई एजेंट इंस्टॉल होने पर मेन्यू विंडो में समा जाता है और स्क्रॉल होता है।
  • एक स्टाइल चुनें: Conventional, Plain, या Gitmoji।
  • अगर अभी कुछ भी स्टेज नहीं है, तो यह वर्किंग-ट्री diff पर वापस आ जाता है — इसलिए आप क्या स्टेज करना है यह तय करने से पहले ही मैसेज पा सकते हैं।

नतीजा संदेश फ़ील्ड में सामान्य, संपादन-योग्य टेक्स्ट के रूप में आता है। यह एक ड्राफ़्ट है, कमिट नहीं।

कमिट करें

मैसेज फ़ील्ड के नीचे दिए Commit बटन पर क्लिक करें। स्टेज किए गए बदलाव आपकी लोकल git हिस्ट्री में नए कमिट के रूप में सेव हो जाते हैं, और स्टेज की गई फ़ाइलों का सेक्शन खाली हो जाता है।

कमिट अब आपकी ब्रांच हिस्ट्री में दिखाई देता है। अगर आपको इसे पूर्ववत करना हो, तो हिस्ट्री व्यू में उस कमिट पर राइट-क्लिक करें और Undo Commit चुनें — इससे बदलाव बिना खोए आपकी unstaged फ़ाइलों में वापस आ जाते हैं।

रिमोट पर पुश करें

कमिट बदलावों को लोकल रूप से सेव करता है। उन्हें GitHub, GitLab या अपने किसी अन्य रिमोट पर भेजने के लिए:

  1. Git पैनल टूलबार में Push बटन (ऊपर-तीर वाला आइकन) पर क्लिक करें
  2. अगर ब्रांच रिमोट पर पहले से मौजूद है, तो आपके कमिट तुरंत पुश हो जाते हैं
  3. अगर यह नई ब्रांच है जो रिमोट पर अभी नहीं है, तो Publish Branch पर क्लिक करें — इससे रिमोट पर ब्रांच बनती है और आपके कमिट पुश हो जाते हैं

अगर क्रेडेंशियल माँगे जाएँ, तो आप उन्हें दर्ज कर सकते हैं या SSH key ऑथेंटिकेशन पर स्विच कर सकते हैं। अपना GitHub अकाउंट कनेक्ट करने का तरीका जानने के लिए Git Accounts देखें, ताकि क्रेडेंशियल अपने-आप संभल जाएँ।

नई ब्रांच पुश करना

बदलाव पुल करें

रिमोट से बदलाव लाने के लिए (उदाहरण के लिए, अगर किसी साथी ने कुछ पुश किया हो):

  1. टूलबार में Pull बटन (नीचे-तीर वाला आइकन) पर क्लिक करें
  2. रिमोट के बदलाव फ़ेच होकर आपकी लोकल ब्रांच में मर्ज हो जाते हैं

अगर मर्ज कॉन्फ़्लिक्ट हों, तो Git पैनल कॉन्फ़्लिक्ट वाली फ़ाइलों को हाइलाइट करता है। हर फ़ाइल खोलकर कॉन्फ़्लिक्ट सुलझाएँ, फिर समाधान को स्टेज और कमिट करें।

git जोड़ने का क्विक बटन

पुश करने के बाद, आपके बदलाव रिमोट पर होते हैं और आपकी टीम के लिए उपलब्ध या पुल रिक्वेस्ट के लिए तैयार रहते हैं। Git पैनल दिखाता है कि आपकी ब्रांच रिमोट के साथ अप-टू-डेट है।