Troubleshooting: Terminals

Common terminal issues fix करें — blank output, typing problems, AI agent glitches।

Terminal खुलता है पर Typing पर Output नहीं

Symptoms: keys press करते हैं पर terminal में कुछ नहीं दिखता, या terminal blank screen के साथ खुलता है और वैसा ही रहता है।

Possible causes और fixes:

Shell init file error। आपकी shell startup file (.zshrc, .bashrc, या .bash_profile) में syntax error या ऐसा command हो सकता है जो hang करे। 1DevTool में plain Bash terminal खोलें और चलाएं:

bash
cat ~/.zshrc

Obvious errors देखें — missing closing quote, undefined variable, या source command जो ऐसी file point करे जो exist नहीं करती। Env Manager या text editor में error fix करें, फिर terminal दोबारा खोलें।

Wrong terminal type। "Claude Code" terminal select किया पर claude CLI installed नहीं है तो terminal खुलेगा पर shell agent launch नहीं कर पाएगा। पहले Claude Code install करें (npm install -g @anthropic-ai/claude-code), या terminal type को plain Bash या Zsh session में बदलें।

Quick reset। Terminal tab में कहीं भी right-click करें और Restart Terminal चुनें। Current shell process kill होता है और fresh one start होता है बिना panel बंद किए।

AI Agent Input पर Respond नहीं करता

Symptoms: agent terminal में prompt type करते हैं पर कुछ नहीं होता — कोई spinner नहीं, कोई response नहीं।

सबसे common cause है agent का interface sub-mode में होना जहां वो input नहीं पढ़ रहा। जैसे agent ने terminal के अंदर vim या nano जैसा text editor खोल लिया हो, keypresses agent की बजाय editor को जाते हैं।

Fixes:

  • Ctrl+C एक-दो बार दबाएं agent जो कर रहा हो cancel करके main prompt पर वापस लाएं। फिर message दोबारा type करें।
  • Terminal में directly type करने की बजाय Agent Input Overlay use करें। Cmd+I (Windows/Linux पर Ctrl+I) दबाएं एक dedicated input box खोलने के लिए जो prompt cleanly agent को भेजता है।
  • Agent completely frozen लगे तो terminal tab पर right-click करें और Restart Terminal चुनें नया agent session शुरू करने के लिए।

Scrollback Agent Response के बाद Cut Off हो जाता है

Symptoms: agent long response produce करने के बाद scroll up करते हैं पर एक certain distance तक ही जा पाते हैं। पुराना output गायब हो गया।

Fixes:

  • Terminal header में Expand scrollback button click करें (terminal panel के top right पर arrow icon)। यह temporarily view में ज़्यादा history load करता है।
  • Permanent fix के लिए scrollback limit बढ़ाएं: Settings → Terminal → Scrollback Lines पर जाएं। Default 10,000 lines है। 100,000 तक बढ़ा सकते हैं। Note: बहुत large scrollback buffers ज़्यादा memory use करते हैं।

Terminal "[detached]" Message दिखाता है

Terminal के ऊपर [detached (from session main)] जैसी line दिख सकती है। यह tmux का message है, वो terminal multiplexer जो 1DevTool background में sessions alive रखने के लिए use करता है।

इसका मतलब display temporarily running session से disconnect हुई और फिर reconnect। यह बिल्कुल normal है — आमतौर पर projects switch करने, terminal hide और reopen करने, या app minimized state से restore होने पर होता है। Session और सभी running processes unaffected हैं।

Hidden Terminal Resume की बजाय New Session शुरू करता है

Symptoms: terminal hide करते हैं, फिर reopen करते हैं, और terminal fresh start होता है — previous commands और running processes गए।

Cause: 1DevTool terminal sessions को background में alive रखने के लिए tmux use करता है। tmux installed नहीं है या shell के PATH में नहीं है तो session persist नहीं हो सकती।

Fix: tmux install करें और 1DevTool restart करें।

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

Install करने के बाद 1DevTool completely quit करके relaunch करें। नए terminal sessions अब hide होने पर persist करेंगे।

Terminals से High CPU Usage

Machine hot चल रही हो या fans ज़ोर से spin कर रहे हों, कोई terminal process excessive CPU consume कर रहा हो सकता है।

Source identify करने के लिए: हर terminal tab पर hover करें। Active tab spinning indicator दिखाएगा। Terminal खोलकर top या htop भी चला सकते हैं।

रोकने के लिए:

  • Terminal में Ctrl+C दबाएं running process interrupt करने के लिए।
  • या terminal tab पर right-click करें और Kill Process चुनें अंदर जो चल रहा है उसे force-terminate करने के लिए।

Process runaway dev server या build tool है तो kill करना safe है और normal start command से restart करें।