ٹربل شوٹنگ: ٹرمینلز

ٹرمینل کے عام مسائل حل کریں — خالی آؤٹ پٹ، ٹائپنگ کے مسائل، AI ایجنٹ کی خرابیاں۔

ٹرمینل کھل جاتا ہے مگر ٹائپ کرنے پر کوئی آؤٹ پٹ نہیں آتا

علامات: آپ کیز دباتے ہیں لیکن ٹرمینل میں کچھ ظاہر نہیں ہوتا، یا ٹرمینل خالی اسکرین کے ساتھ کھلتا ہے اور ویسا ہی رہتا ہے۔

ممکنہ وجوہات اور حل:

Shell 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 منتخب کریں تاکہ اس کے اندر چلنے والی ہر چیز زبردستی ختم ہو جائے۔

اگر پراسیس کوئی بے قابو dev server یا بلڈ ٹول ہے، تو اسے ختم کر کے اپنی معمول کی اسٹارٹ کمانڈ سے دوبارہ شروع کرنا محفوظ ہے۔