समस्या निवारण: टर्मिनल

टर्मिनल की आम समस्याएँ ठीक करें — खाली आउटपुट, टाइपिंग की दिक्कतें और AI एजेंट की गड़बड़ियाँ।

टर्मिनल खुलता है लेकिन टाइप करने पर कोई आउटपुट नहीं आता

लक्षण: आप कीज़ दबाते हैं लेकिन टर्मिनल में कुछ दिखाई नहीं देता, या टर्मिनल खाली स्क्रीन के साथ खुलता है और वैसा ही रहता है।

संभावित कारण और समाधान:

शेल init फ़ाइल में त्रुटि। आपकी शेल स्टार्टअप फ़ाइल (.zshrc, .bashrc या .bash_profile) में सिंटैक्स त्रुटि हो सकती है या कोई ऐसा कमांड हो सकता है जो अटक जाता है। 1DevTool में एक सामान्य Bash टर्मिनल खोलें और चलाएँ:

bash
cat ~/.zshrc

स्पष्ट त्रुटियाँ ढूँढें — बंद न किया गया कोट, अपरिभाषित वेरिएबल, या ऐसा source कमांड जो किसी ऐसी फ़ाइल की ओर इशारा करता है जो मौजूद नहीं है। त्रुटि को Env Manager या किसी टेक्स्ट एडिटर में ठीक करें, फिर टर्मिनल दोबारा खोलें।

गलत टर्मिनल प्रकार। अगर आपने “Claude Code” टर्मिनल चुना है लेकिन claude CLI इंस्टॉल नहीं है, तो टर्मिनल खुल जाएगा पर शेल एजेंट को लॉन्च नहीं कर पाएगा। पहले Claude Code इंस्टॉल करें (npm install -g @anthropic-ai/claude-code), या टर्मिनल प्रकार को सामान्य Bash या Zsh सेशन में बदल दें।

त्वरित रीसेट। टर्मिनल टैब पर कहीं भी राइट-क्लिक करें और Restart Terminal चुनें। इससे मौजूदा शेल प्रोसेस बंद हो जाता है और पैनल बंद किए बिना नया शेल शुरू हो जाता है।


AI एजेंट इनपुट का जवाब नहीं देता

लक्षण: आप एजेंट टर्मिनल में प्रॉम्प्ट टाइप करते हैं लेकिन कुछ नहीं होता — न स्पिनर, न जवाब, न कोई पावती।

सबसे आम कारण यह है कि एजेंट का इंटरफ़ेस किसी सब-मोड में है जहाँ वह आपका इनपुट नहीं पढ़ रहा। उदाहरण के लिए, अगर एजेंट ने टर्मिनल के अंदर vim या nano जैसे टेक्स्ट एडिटर में कोई फ़ाइल खोली है, तो कीप्रेस एजेंट के बजाय उस एडिटर में जाते हैं।

समाधान:

  • एजेंट जो भी कर रहा है उसे रद्द करने और मुख्य प्रॉम्प्ट पर लौटाने के लिए Ctrl+C एक या दो बार दबाएँ। फिर अपना संदेश दोबारा टाइप करें।
  • सीधे टर्मिनल में टाइप करने के बजाय Agent Input Overlay का उपयोग करें। एक समर्पित इनपुट बॉक्स खोलने के लिए Cmd+I (Windows/Linux पर Ctrl+I) दबाएँ, जो टर्मिनल की किसी भी स्थिति की समस्या को दरकिनार करके आपका प्रॉम्प्ट साफ़-सुथरे ढंग से एजेंट तक भेजता है।
  • अगर एजेंट पूरी तरह फ़्रीज़ लगे, तो टर्मिनल टैब पर राइट-क्लिक करके Restart Terminal चुनें और नया एजेंट सेशन शुरू करें।

एजेंट के जवाब के बाद स्क्रोलबैक कट जाता है

लक्षण: एजेंट के लंबा जवाब देने के बाद आप ऊपर स्क्रोल करते हैं लेकिन केवल एक निश्चित दूरी तक ही जा पाते हैं। पहले का आउटपुट गायब हो गया है।

समाधान:

  • टर्मिनल हेडर में Expand scrollback बटन पर क्लिक करें (टर्मिनल पैनल के ऊपर दाईं ओर तीर वाला आइकन)। इससे व्यू में अस्थायी रूप से ज़्यादा हिस्ट्री लोड हो जाती है।
  • स्थायी समाधान के लिए स्क्रोलबैक सीमा बढ़ाएँ: Settings → Terminal → Scrollback Lines पर जाएँ। डिफ़ॉल्ट 10,000 लाइनें है। आप इसे 100,000 तक बढ़ा सकते हैं। ध्यान रखें कि बहुत बड़े स्क्रोलबैक बफ़र ज़्यादा मेमोरी का उपयोग करते हैं।

स्क्रोलबैक में गड़बड़ या एक-दूसरे पर चढ़ा हुआ टेक्स्ट दिखता है

लक्षण: पेन का आकार बदलने या टर्मिनल दोबारा खोलने के बाद पुरानी हिस्ट्री में आपस में मिली हुई लाइनें, बेतरतीब अक्षर या दोहराए गए ब्लॉक दिखते हैं।

समाधान: टर्मिनल पर एम्बर रंग की Repair view पिल देखें। यह तब दिखती है जब हिस्ट्री का कुछ हिस्सा उस चौड़ाई से अलग चौड़ाई पर बना था जो पेन की अभी है। उस पर क्लिक करें और व्यू टर्मिनल की अपनी चौड़ाई-सटीक पंक्तियों से दोबारा बन जाता है।


टर्मिनल में “[detached]” संदेश दिखता है

आपको किसी टर्मिनल के ऊपर [detached (from session main)] जैसी एक लाइन दिख सकती है। यह tmux का संदेश है, जो वह टर्मिनल मल्टीप्लेक्सर है जिसका उपयोग 1DevTool सेशन को बैकग्राउंड में जीवित रखने के लिए करता है।

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


छिपाया गया टर्मिनल फिर से शुरू होने के बजाय नया सेशन शुरू करता है

लक्षण: आप किसी टर्मिनल को क्लिक करके दूसरी जगह जाकर या पैनल बंद करके छिपाते हैं, फिर उसे दोबारा खोलते हैं, और टर्मिनल नए सिरे से शुरू होता है — आपके पिछले कमांड और चल रहे प्रोसेस गायब हो जाते हैं।

कारण: 1DevTool टर्मिनल सेशन को बैकग्राउंड में जीवित रखने के लिए tmux का उपयोग करता है। अगर tmux इंस्टॉल नहीं है या आपके शेल के PATH में नहीं है, तो सेशन सुरक्षित नहीं रखा जा सकता और हर बार शुरू से रीस्टार्ट होता है।

समाधान: tmux इंस्टॉल करें और 1DevTool को रीस्टार्ट करें।

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo dnf install tmux

इंस्टॉल करने के बाद 1DevTool को पूरी तरह बंद करके दोबारा लॉन्च करें। अब नए टर्मिनल सेशन छिपाए जाने पर भी बने रहेंगे।


टर्मिनल से ज़्यादा CPU उपयोग

अगर आपकी मशीन गर्म हो रही है या पंखे तेज़ आवाज़ में चल रहे हैं, तो हो सकता है कोई टर्मिनल प्रोसेस ज़रूरत से ज़्यादा CPU खा रहा हो।

स्रोत पहचानने के लिए: हर टर्मिनल टैब पर होवर करें। सक्रिय टैब पर घूमता हुआ संकेतक दिखेगा। आप टर्मिनल खोलकर top या htop भी चला सकते हैं ताकि देख सकें कि कौन सा प्रोसेस ज़िम्मेदार है।

इसे रोकने के लिए:

  • चल रहे प्रोसेस को रोकने के लिए टर्मिनल में Ctrl+C दबाएँ।
  • या टर्मिनल टैब पर राइट-क्लिक करके Kill Process चुनें, ताकि उसके अंदर जो भी चल रहा है वह ज़बरदस्ती बंद हो जाए।

अगर प्रोसेस कोई बेकाबू डेव सर्वर या बिल्ड टूल है, तो उसे बंद करना और अपने सामान्य स्टार्ट कमांड से दोबारा शुरू करना सुरक्षित है।