Troubleshooting: Terminals

Terminal کھلتا ہے لیکن ٹائپ کرنے پر کوئی Output نہیں

علامات: آپ keys دباتے ہیں لیکن Terminal میں کچھ ظاہر نہیں ہوتا، یا Terminal blank screen کے ساتھ کھلتا ہے اور ایسا ہی رہتا ہے۔

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

Shell init فائل میں error۔ آپ کی shell startup فائل (.zshrc، .bashrc، یا .bash_profile) میں syntax error یا کوئی command ہو سکتی ہے جو hang ہو جاتی ہے۔ 1DevTool میں ایک plain Bash Terminal کھولیں اور چلائیں:

cat ~/.zshrc

واضح errors تلاش کریں — کوئی missing closing quote، undefined variable، یا source command جو ایسی فائل کی طرف point کر رہی ہو جو موجود نہیں۔ Env Manager یا text editor میں error ٹھیک کریں، پھر Terminal دوبارہ کھولیں۔

غلط Terminal قسم۔ اگر آپ نے "Claude Code" Terminal منتخب کیا لیکن claude CLI install نہیں ہے، تو Terminal کھلے گا لیکن shell agent launch کرنے میں ناکام ہوگا۔ پہلے Claude Code install کریں (npm install -g @anthropic-ai/claude-code)، یا Terminal قسم plain Bash یا Zsh Session میں تبدیل کریں۔

Quick reset۔ Terminal tab میں کہیں بھی right-click کریں اور Restart Terminal منتخب کریں۔ یہ current shell process kill کرتا ہے اور پینل بند کیے بغیر ایک نیا شروع کرتا ہے۔

AI Agent Input کا جواب نہیں دیتا

علامات: آپ agent Terminal میں prompt ٹائپ کرتے ہیں لیکن کچھ نہیں ہوتا — کوئی spinner نہیں، کوئی response نہیں، کوئی acknowledgement نہیں۔

سب سے عام وجہ یہ ہے کہ agent کا interface ایک sub-mode میں ہے جہاں یہ آپ کا input نہیں پڑھ رہا۔ مثال کے طور پر، اگر agent نے Terminal کے اندر vim یا nano جیسا text editor کھول لیا ہے، تو keypresses اس editor کو جاتی ہیں نہ کہ agent کو۔

حل:

• agent جو کر رہا ہے اسے cancel کرنے اور اسے اپنے main prompt پر واپس لانے کے لیے ایک یا دو بار Ctrl+C دبائیں۔ پھر اپنا message دوبارہ ٹائپ کریں۔
• Terminal میں directly ٹائپ کرنے کی بجائے Agent Input Overlay استعمال کریں۔ ایک dedicated input box کھولنے کے لیے Cmd+I (یا Windows/Linux پر Ctrl+I) دبائیں جو آپ کا prompt cleanly agent کو بھیجتا ہے، کسی Terminal state issues کو bypass کرتے ہوئے۔
• اگر agent مکمل طور پر frozen نظر آئے، تو Terminal tab پر right-click کریں اور نیا agent Session شروع کرنے کے لیے Restart Terminal منتخب کریں۔

Agent Response کے بعد Scrollback Cut Off ہو جاتی ہے

علامات: agent کے لمبے response کے بعد، آپ اوپر scroll کرتے ہیں لیکن صرف ایک خاص حد تک جا سکتے ہیں۔ پہلے کا output غائب ہو گیا ہے۔

حل:

• Terminal header میں Expand scrollback بٹن کلک کریں (Terminal پینل کے اوپر دائیں کونے میں arrow آئیکن)۔ یہ عارضی طور پر view میں زیادہ history load کرتا ہے۔
• مستقل fix کے لیے، scrollback limit بڑھائیں: Settings → Terminal → Scrollback Lines پر جائیں۔ Default 10,000 lines ہے۔ آپ اسے 100,000 تک بڑھا سکتے ہیں۔ نوٹ کریں کہ بہت بڑے scrollback buffers زیادہ memory استعمال کرتے ہیں۔

Terminal "[detached]" Message دکھاتا ہے

آپ کو Terminal کے اوپر [detached (from session main)] جیسی لائن نظر آ سکتی ہے۔ یہ tmux سے ایک message ہے، وہ Terminal multiplexer جو 1DevTool background میں sessions زندہ رکھنے کے لیے استعمال کرتا ہے۔

اس کا مطلب ہے کہ display عارضی طور پر running Session سے disconnect ہوئی اور پھر reconnect ہوئی۔ یہ بالکل normal ہے — یہ عموماً اس وقت ہوتا ہے جب آپ projects switch کریں، Terminal hide اور reopen کریں، یا app minimized state سے restore ہو۔ آپ کی Session اور تمام running processes بالکل ٹھیک ہیں۔

Hidden Terminal نیا Session شروع کرتا ہے بجائے Resume کرنے کے

علامات: آپ کسی دوسری طرف کلک کر کے یا پینل بند کر کے Terminal hide کرتے ہیں، پھر اسے دوبارہ کھولتے ہیں، اور Terminal fresh شروع ہوتا ہے — آپ کے پچھلے commands اور running processes غائب ہیں۔

وجہ: 1DevTool terminal sessions background میں زندہ رکھنے کے لیے tmux استعمال کرتا ہے۔ اگر tmux install نہیں ہے یا آپ کے shell کے PATH میں نہیں ہے، تو Session persist نہیں ہو سکتی اور ہر بار scratch سے restart ہوتی ہے۔

حل: tmux install کریں اور 1DevTool restart کریں۔

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

install کے بعد، 1DevTool مکمل طور پر بند کریں اور دوبارہ launch کریں۔ نئی terminal sessions اب hidden ہونے پر persist ہوں گی۔

Terminals سے High CPU Usage

اگر آپ کی مشین گرم ہو رہی ہے یا fans زور سے چل رہے ہیں، تو Terminal process ضرورت سے زیادہ CPU استعمال کر رہی ہو سکتی ہے۔

ذریعہ identify کرنے کے لیے: ہر Terminal tab پر hover کریں۔ ایک active tab spinning indicator دکھائے گا۔ آپ Terminal کھول کر top یا htop بھی چلا سکتے ہیں دیکھنے کے لیے کہ کون سا process ذمہ دار ہے۔

اسے روکنے کے لیے:

• running process interrupt کرنے کے لیے Terminal میں Ctrl+C دبائیں۔
• یا Terminal tab پر right-click کریں اور اس کے اندر چلنے والی چیز force-terminate کرنے کے لیے Kill Process منتخب کریں۔

اگر process ایک runaway dev سرور یا build ٹول ہے، تو اسے kill کرنا اور اپنے normal start command سے دوبارہ شروع کرنا safe ہے۔