AI تشخیص اور Autopilot

جانیں کہ ایجنٹ کیوں اٹک گیا ہے، سیٹ اس کے بیک اپ کے حوالے کریں، اور Autopilot کو ان ایجنٹس کو دوبارہ شروع کرنے دیں جو ٹاسک کے بیچ میں کریش ہو گئے یا جن کا کنکشن ٹوٹ گیا۔

ایک ایجنٹ دو طرح سے کام کرنا بند کر سکتا ہے۔ وہ زندہ رہ سکتا ہے مگر اٹکا ہوا: اسکرین پر کوئی quota کی رکاوٹ، sign-in پرامپٹ یا upsell modal موجود ہو اور آپ کا پیغام پہنچتا ہی نہیں۔ یا وہ مکمل طور پر بند ہو سکتا ہے: کنکشن ٹوٹ جاتا ہے یا CLI ٹاسک کے بیچ میں باہر نکل جاتی ہے۔ AI Diagnosis پہلا معاملہ سنبھالتی ہے اور Autopilot دوسرا۔ دونوں ایک ہی جگہ رہتے ہیں۔

اوپر والے بار سے Orchestration Dashboard کھولیں، یا Command Palette سے Open Orchestration Dashboard چلائیں، پھر Advanced → AI Diagnosis منتخب کریں۔ Tutorials → How-to → Autopilot سیدھا وہیں لے جاتا ہے۔

Diagnose & restore stuck agents

جب کسی ایجنٹ ٹرمینل تک ڈیلیوری تقریباً دو منٹ تک ناکام رہتی ہے، تو انسٹال شدہ AI CLI اس ٹرمینل کی اسکرین کا متن پڑھ کر بتاتا ہے کہ مسئلہ کیا ہے۔ ڈیلیوری ہر 15 سیکنڈ بعد دوبارہ کی جاتی ہے، اور آٹھویں ناکامی تشخیص کو متحرک کر دیتی ہے۔ اگر ٹرمینل کسی چارٹ سیٹ میں بیک اپ ایجنٹس کے ساتھ بیٹھا ہو تو سیٹ خود بخود تبدیل ہو جاتی ہے۔ باقی ہر ٹرمینل کو تشخیص ایک نوٹیفکیشن کی صورت میں ملتی ہے تاکہ آپ کارروائی کر سکیں۔ صحت مند ٹرمینلز کبھی چیک نہیں کیے جاتے۔

Diagnose & restore stuck agents بطور ڈیفالٹ آن ہے اور پوری ایپ پر لاگو ہوتی ہے — ہر ٹیم، چارٹ اور لنک شدہ ٹرمینل پر۔ How to restore کے تحت منتخب کریں:

With AI (recommended): ایک چیکر AI پہلے اٹکے ہوئے ٹرمینل کی اسکرین پڑھتا ہے، اور صرف تصدیق شدہ quota یا sign-in رکاوٹ ہی بحالی کو متحرک کرتی ہے۔ یہ کسی مصروف ایجنٹ کو کبھی پریشان نہیں کرتا۔
Manual timer — no AI: صرف وقت کی میعاد ختم ہونا ہی بحالی کرتا ہے۔ یہ تیز ہے اور مکمل طور پر مقامی، مگر یہ اٹکے ہوئے ایجنٹ اور طویل ٹاسک پر مصروف ایجنٹ میں فرق نہیں کر سکتا۔

چیکر ایجنٹس، ترتیب کے ساتھ

چیکرز ایک ایک کر کے آزمائے جاتے ہیں۔ اگر کوئی چیکر انسٹال نہ ہو، اپنی حد تک پہنچ جائے یا ٹائم آؤٹ ہو جائے تو اگلا اس کی جگہ سنبھال لیتا ہے۔ اٹکے ہوئے ٹرمینل کا اپنا provider ہمیشہ نظرانداز کیا جاتا ہے، تاکہ کوئی ایجنٹ خود کو جانچ نہ دے۔ Claude، Codex، Gemini، OpenCode، Qwen، Kimi، Grok اور Hermes سب چیکر بن سکتے ہیں، ایک وقت میں زیادہ سے زیادہ چار۔ + Add checker، ترتیب بدلنے کے لیے تیر والے بٹن، اور Remove استعمال کر کے فہرست تشکیل دیں۔ اگر آپ کوئی نہ چنیں تو اسی ترتیب میں پہلی انسٹال شدہ CLI استعمال ہوتی ہے۔

ہر چیکر کا اپنا ماڈل ہوتا ہے (v1.75.0 سے)۔ ایجنٹ کے ساتھ والے ڈراپ ڈاؤن سے کوئی منتخب کریں، یا CLI کا ڈیفالٹ استعمال کرنے کے لیے اسے Default model پر چھوڑ دیں۔

چیکرز headless چلتے ہیں، محدود اجازتوں اور ایک غیر جانب دار ڈائریکٹری میں۔ وہ اسکرین کی درجہ بندی کرتے ہیں اور JSON کی ایک سطر میں جواب دیتے ہیں، اور آپ کے پروجیکٹ کو کبھی ہاتھ نہیں لگاتے۔ اسکرین کا متن کسی چیکر کو صرف اس وقت بھیجا جاتا ہے جب آپ ایک مرتبہ کی اسکرین پڑھنے کی رضامندی دے چکے ہوں۔

Autopilot (failed tasks)

Autopilot اس ایجنٹ کو دوبارہ شروع کرتا ہے جو ٹاسک کے دوران بند ہو گیا یا جس کا کنکشن ٹوٹ گیا۔ یہ ایجنٹ کا سیشن بحال کرتا ہے یا ٹاسک سیٹ کے بیک اپ کو منتقل کر دیتا ہے۔ یہ کبھی سوالات کے جواب نہیں دیتا اور کبھی کسی picker میں کچھ نہیں ٹائپ کرتا۔ یہ بطور ڈیفالٹ بند ہے۔ Autopilot (failed tasks) کارڈ کو On پر لگائیں۔ اسے آن کرنا وہی اسکرین پڑھنے کی رضامندی بھی دے دیتا ہے جسے AI Diagnosis استعمال کرتی ہے۔

آن ہونے کے بعد کارڈ پر لکھا ہوتا ہے Watching. Acts only when a running task goes quiet, its process exits, or a message to it stalls. Idle tabs are never checked. اینیمیٹڈ واک تھرو کے لیے How it works دبائیں۔

یہ کب کارروائی کرتا ہے

Autopilot صرف ان ٹرمینلز کو دیکھتا ہے جو آپ کے بھیجے ہوئے کسی پرامپٹ پر کام کر رہے ہوں۔ تین چیزیں اسے متحرک کرتی ہیں:

محرک	کیا شمار ہوتا ہے
پراسیس باہر نکل جاتا ہے	پرامپٹ ابھی ادھورا ہو اور CLI کسی خرابی کے ساتھ باہر نکل جائے۔ `/exit` یا Ctrl-D سے جان بوجھ کر بند کرنا صاف طریقے سے باہر نکلنا ہے اور اسے چھوا نہیں جاتا۔
ٹاسک خاموش ہو جاتا ہے	ایک چلتا ہوا ٹاسک آؤٹ پٹ دینا بند کر دیتا ہے، اور ایک چیکر اسکرین پڑھ کر تصدیق کرتا ہے کہ وہ واقعی اٹکا ہوا ہے۔
پیغام رک جاتا ہے	ڈیلیوری مسلسل ناکام رہتی ہے اور AI Diagnosis ٹوٹے ہوئے کنکشن کی رپورٹ دیتا ہے۔

یہ کیا کرتا ہے

Resume the session. Autopilot اسی ٹرمینل میں اس CLI کے اپنے resume کمانڈ سے ایجنٹ کو دوبارہ شروع کرتا ہے، تاکہ وہی سیشن اور ٹرانسکرپٹ واپس آ جائے۔ یہ Claude Code، Codex، Gemini، Cursor، OpenCode، Grok، Kimi، Qwen، Amp، Cline، Hermes، Antigravity اور Qoder کے لیے کام کرتا ہے۔
Ask it to continue. After a resume, ask the agent to continue آن ہونے پر (جو ڈیفالٹ ہے)، بحال شدہ ایجنٹ کو ایک ہدایت ملتی ہے: وہیں سے جاری رکھنا جہاں چھوڑا تھا، مکمل شدہ مراحل دوبارہ نہ کرنا، اور کسی روکے ہوئے مرحلے کو دہرانے سے پہلے اس کا نتیجہ چیک کرنا۔
Switch to backup. اگر ٹیب بحال نہیں ہو سکتا — کسی مہلک خرابی کی وجہ سے یا اس لیے کہ بحال کرنے کے لیے کوئی سیشن موجود نہیں — تو بیک اپ ایجنٹ والی چارٹ سیٹ ٹاسک اپنے بریف کے ساتھ سنبھال لیتی ہے۔ پرانا ٹیب کھلا رہتا ہے۔
Wait for you. اگر اسکرین پر کوئی سوال، picker، آدھا ٹائپ شدہ مسودہ یا sign-in رکاوٹ ہو، یا کچھ اور غیر واضح ہو، تو کچھ ٹائپ نہیں کیا جاتا۔ سوالات، pickers اور مسودے بس ویسے ہی چھوڑ دیے جاتے ہیں۔ Sign-in رکاوٹیں اور غیر واضح اسکرینیں آپ کو نوٹیفکیشن بھیجتی ہیں۔

دوبارہ کوشش کی حدیں

Autopilot پہلی بار دوبارہ شروع کرنے سے پہلے 5 سیکنڈ انتظار کرتا ہے۔ اگر وہی پرامپٹ پھر ناکام ہو تو دوسری بار 20 سیکنڈ اور تیسری بار 60 سیکنڈ انتظار کرتا ہے۔ اس کے بعد وہ رک جاتا ہے اور ایک Activity کارڈ سے آپ کو خبر کرتا ہے جس پر لکھا ہوتا ہے Stopped retrying "…" after 3 resumes; waiting on you. آپ کی طرف سے نیا پرامپٹ گنتی ری سیٹ کر دیتا ہے۔ کسی ٹرمینل کو ایک گھنٹے میں 6 سے زیادہ بار کبھی دوبارہ نہیں شروع کیا جاتا۔

Recent decisions

Recent decisions اس مشین پر آخری 5 کارروائیوں کی فہرست دیتا ہے۔ ہر سطر وقت، پرامپٹ، پروجیکٹ اور وجہ دکھاتی ہے، ساتھ ایک بیج: Resumed، Switched to backup، Couldn't resume، Continued، Stopped retrying یا Waiting on you۔ Activity کارڈز پر ایک Autopilot چپ ہوتی ہے۔ مکمل کھاتہ append-only ہے اور ~/.1devtool/orchestration/autopilot-ledger.jsonl میں لکھا جاتا ہے۔

Pause یا Off

Pause آپ کے unpause کرنے تک Autopilot کو کسی بھی چیز کو بحال یا تبدیل کرنے سے روک دیتا ہے۔ Diagnose & restore stuck agents کی بیک اپ سوئچنگ چلتی رہتی ہے۔
Off Autopilot کو بند کر دیتا ہے اور کسی بھی pause کو صاف کر دیتا ہے۔

صرف ایک لانچ کے لیے Autopilot بند کرنے کے لیے — سیٹنگ بدلے بغیر — 1DevTool کو ONEDEVTOOL_AUTOPILOT=off کے ساتھ شروع کریں۔ اس کے بعد کارڈ پر لکھا ہوتا ہے Off for this launch.