iCode کے ساتھ آغاز: AI ایجنٹ ٹرمینل چلائیں اور ترتیب دیں

iCode کیا ہے؟

iCode ایک اوپن سورس ٹرمینل ایپلی کیشن ہے جو AI ایجنٹس اور ورک فلو کو ترتیب دینے کے لیے استعمال ہوتی ہے۔ یہ گفتگو، ماڈل پروفائلز، ایجنٹ کی تشکیل، شیل تک رسائی، فائل کے فرق، واپسی کے کنٹرولز اور عمل درآمد کے تجزیے کو ایک ہی انٹرفیس میں یکجا کرتی ہے۔

کام جاری ہے: iCode کے انٹرفیس، فائل فارمیٹس اور ڈیفالٹس ریلیزز کے درمیان تبدیل ہو سکتے ہیں۔

iCode میں کوئی AI ماڈل شامل نہیں ہے۔ اس کے بجائے، آپ خود ماڈل فراہم کنندگان سے کنیکٹ ہوتے ہیں اور منتخب کرتے ہیں کہ ایجنٹ کو کون سا تشکیل شدہ پروفائل استعمال کرنا چاہیے۔

اہم خصوصیات

• ٹرمینل چیٹ: بھرپور Markdown جوابات دیکھیں، جن میں فارمیٹ شدہ فہرستیں اور ڈایاگرام شامل ہیں۔
• قابل تشکیل ایجنٹس: ایجنٹ کا کوڈ لکھے بغیر ہدایات، ٹولز، ذیلی ایجنٹس، مہارتیں، MCP سرورز اور میموری کی تعریف کریں۔
• متعدد ماڈل پروفائلز: مختلف فراہم کنندگان کے پروفائلز تشکیل دیں اور گفتگو کے دوران ماڈلز تبدیل کریں۔
• ورک فلو کی بصری نمائندگی: ورک فلو کو نوڈ بہ نوڈ دیکھیں اور ہر ایجنٹ نوڈ کے ماڈل، ٹول کالز اور ٹوکن کے استعمال کا جائزہ لیں۔
• تبدیلیوں کا جائزہ: ایجنٹ کی جانب سے تبدیل کی گئی ہر فائل کا متحد یا تقسیم شدہ فرق کے منظر میں معائنہ کریں۔
• واپسی: پچھلا ٹرن منتخب کریں، واپس کی جانے والی تبدیلیوں کا جائزہ لیں اور اس نقطے کے بعد کی گفتگو حذف کریں۔
• ٹریکٹری تجزیہ: وقت، ٹوکن، کیش اور متوازی عمل کی تفصیلات کے ساتھ ماڈل کالز، ہکس اور ٹول کالز کا جائزہ لیں۔
• مربوط شیل: iCode کے اندر حقیقی ٹرمینل چلائیں، بشمول فل اسکرین ایپلی کیشنز کے۔

ضروریات

واحد لازمی پیشگی ضرورت uv ہے۔ یہ پروجیکٹ کے لیے Python 3.14 فراہم کرتا ہے، اس لیے آپ کو Python کا یہ ورژن الگ سے انسٹال کرنے کی ضرورت نہیں۔

بہترین تجربے کے لیے جدید ٹرمینل استعمال کریں۔ README میں Windows پر Windows Terminal یا macOS اور Linux پر Ghostty استعمال کرنے کی تجویز دی گئی ہے۔

iCode انسٹال اور چلائیں

ریپوزٹری کی مقامی چیک آؤٹ سے آغاز کریں۔ اس کی روٹ ڈائریکٹری میں ٹرمینل کھولیں اور تمام مطلوبہ اضافی پیکجز کے ساتھ پروجیکٹ کو ہم آہنگ کریں:

uv sync --extra all

--extra all کو عین اسی طرح استعمال کریں۔ پروجیکٹ خاص طور پر بغیر آپشن کے uv sync استعمال کرنے یا اس آپشن کو --all-extras سے تبدیل کرنے سے منع کرتا ہے۔

اگلا مرحلہ وینڈَر کیا گیا ripgrep بائنری ڈاؤن لوڈ کرنا ہے۔ macOS یا Linux پر چلائیں:

./scripts/fetch_rg.sh

Windows پر اس کے بجائے PowerShell اسکرپٹ چلائیں:

.\scripts\fetch_rg.ps1

آخر میں iCode لانچ کریں:

uv run icode

پروجیکٹ کا کوڈ نام Chrys ہے، اس لیے یہ کمانڈ بھی وہی ایپلی کیشن شروع کرتی ہے:

uv run chrys

اپنا پہلا ماڈل تشکیل دیں

iCode ماڈل پروفائلز کے بغیر فراہم کیا جاتا ہے۔ پہلی بار لانچ کرنے پر F4 دبائیں تاکہ Model Configuration کھلے، پھر اپنے زیر استعمال ماڈل فراہم کنندہ کے لیے پروفائل شامل کریں۔

پروفائلز تشکیل دینے کے بعد، آپ مختلف فراہم کنندگان کے پروفائلز کو ساتھ رکھ سکتے ہیں اور گفتگو کے دوران ان کے درمیان تبدیل ہو سکتے ہیں۔ چونکہ iCode خود کوئی ماڈل فراہم نہیں کرتا، اس لیے آپ کی تشکیل کردہ فراہم کنندہ کنکشن یہ طے کرتی ہے کہ ماڈل کی درخواستیں کہاں بھیجی جائیں گی۔

بنیادی استعمال

ان پٹ بار سے نیویگیٹ کریں

ہوم اسکرین موجودہ ایجنٹ، ماڈل، منظوری کے موڈ اور سیشن کو نمایاں رکھتی ہے۔ کئی سابقے اہم افعال تک فوری رسائی فراہم کرتے ہیں:

• # ایجنٹس تک رسائی دیتا ہے۔
• $ ماڈلز تک رسائی دیتا ہے۔
• / کمانڈز تک رسائی دیتا ہے۔
• @ فائلوں تک رسائی دیتا ہے۔
• ! شیل تک رسائی دیتا ہے۔

گفتگو شروع کریں

ایک ایجنٹ اور تشکیل شدہ ماڈل منتخب کریں، پھر ان پٹ بار میں اپنی درخواست درج کریں۔ جوابات براہِ راست ٹرمینل میں بھرپور Markdown کے طور پر ظاہر ہوتے ہیں۔ جب کوئی ایجنٹ فائلوں میں تبدیلی کرتا ہے، تو iCode ان تبدیلیوں کو ریکارڈ کرتا ہے تاکہ آپ ہر ٹرن کے لحاظ سے یا مجموعی طور پر ان کا جائزہ لے سکیں۔

ایجنٹ تشکیل دیں

Agent Configuration کھولنے کے لیے F2 دبائیں۔ ایجنٹ ایپلی کیشن کوڈ کے بجائے ایک تشکیل ہوتا ہے۔ اس اسکرین سے آپ اس کی ہدایات، ٹولز، ذیلی ایجنٹس، مہارتیں، MCP سرورز اور میموری میں ترمیم کر سکتے ہیں۔

ایجنٹ کی ہدایات کو اس کے مقصد کے مطابق رکھیں اور صرف مطلوبہ ٹولز اور انضمامات فعال کریں۔ رازداری کے لیے بھی یہ اہم ہے، کیونکہ بیرونی ٹولز اور سرورز ڈیٹا کو آزادانہ طور پر سنبھال سکتے ہیں۔

فائل کی تبدیلیوں کا جائزہ لیں

ایجنٹ کی جانب سے تبدیل کی گئی فائلوں کا معائنہ کرنے کے لیے فرق دیکھنے والا ٹول استعمال کریں۔ آپ تبدیلیوں کا ایک وقت میں ایک ٹرن کے لحاظ سے جائزہ لے سکتے ہیں یا انہیں مجموعی منظر میں جمع کر سکتے ہیں۔ متحد اور تقسیم شدہ دونوں انداز دستیاب ہیں۔

ورک فلو چلائیں اور ان کا معائنہ کریں

ورک فلو موڈ آپ کو ورک فلو کے نوڈ بہ نوڈ عمل درآمد کو دیکھنے دیتا ہے۔ ہر ایجنٹ نوڈ کے لیے iCode منتخب شدہ ماڈل، اس کی ٹول کالز اور ٹوکن کے استعمال کو دکھا سکتا ہے۔

یہ منظر اس وقت مفید ہوتا ہے جب کسی کام میں متعدد مراحل یا ایجنٹس شامل ہوں۔ عمل درآمد کو ایک واحد مبہم جواب سمجھنے کے بجائے، آپ دیکھ سکتے ہیں کہ کام گراف کے ذریعے کیسے آگے بڑھتا ہے۔

اعلیٰ درجے کی تجاویز

خراب مرحلے سے جاری رکھنے سے پہلے رول بیک استعمال کریں

اگر کسی گفتگو کے نتیجے میں ناپسندیدہ ترامیم ہو جائیں تو پہلے والے مرحلے کو منتخب کرکے رول بیک کھولیں۔ iCode رول بیک لاگو کرنے سے پہلے دکھاتا ہے کہ کن فائل تبدیلیوں کو واپس کیا جائے گا۔ اس کے بعد یہ منتخب مرحلے کے بعد گفتگو کے حصے کو حذف کر دیتا ہے۔

تجویز کردہ فائل واپسیوں کی تصدیق سے پہلے احتیاط سے جائزہ لیں، خاص طور پر جب متعدد مراحل میں ایک ہی فائلوں میں ترمیم کی گئی ہو۔

Trajectory کے ذریعے عمل درآمد کا تجزیہ کریں

Trajectory منظر کھولنے کے لیے F12 دبائیں۔ اس کا جائزہ بتاتا ہے کہ وقت اور ٹوکن کہاں صرف ہوئے، اور ماڈل کی سرگرمی، ٹول کے عمل درآمد اور انتظار کو الگ الگ دکھاتا ہے۔ یہ ہر مرحلے کے ٹوکن اور کیش کے استعمال کے ساتھ متوازی عمل درآمد کی معلومات بھی فراہم کرتا ہے۔

ٹائم لائن کسی مرحلے کے اندر انفرادی ماڈل کالز، ہُکس اور ٹول کالز کی تفصیل دکھاتی ہے۔ مہنگے یا سست تعاملات کی چھان بین اور کارروائیوں کی ترتیب سمجھنے کے لیے اسے استعمال کریں۔

ضم شدہ شیل استعمال کریں

! کے ذریعے شیل میں داخل ہوں۔ یہ محدود کمانڈ آؤٹ پٹ پینل کے بجائے ایک حقیقی ٹرمینل ہے، اس لیے فل اسکرین پروگرام اسی جگہ چل سکتے ہیں اور ہر کی اسٹروک وصول کر سکتے ہیں۔

یاد رکھیں کہ کمانڈز، اسکل اسکرپٹس اور ورک فلو آپ کے نیٹ ورک تک رسائی رکھنے والے آزاد پروگرام ہیں۔ انہیں چلانے سے پہلے ان کے کام کا جائزہ لیں، خاص طور پر حساس ماحول میں۔

مکمل صارف رہنما کھولیں

بلٹ اِن صارف رہنما کھولنے کے لیے iCode کے اندر F8 دبائیں۔ یہی دستاویزات ریپوزٹری کی docs/ ڈائریکٹری میں انگریزی اور آسان چینی زبان میں بھی دستیاب ہیں۔

رازداری اور بیرونی روابط

iCode میں کوئی ٹیلی میٹری، تجزیاتی نظام یا کریش رپورٹنگ نہیں ہے اور یہ آپ کا ڈیٹا جمع نہیں کرتا۔ پہلے سے طے شدہ طور پر یہ پروجیکٹ یا دیگر فریقِ ثالث کو کچھ بھی نہیں بھیجتا، بشمول استعمال کا ڈیٹا۔

اس کے باوجود ڈیٹا ان مقامات پر منتقل ہو سکتا ہے جنہیں آپ ترتیب دیتے ہیں، جن میں ماڈل فراہم کنندگان، MCP سرورز، ہُکس اور OpenTelemetry ایکسپورٹرز شامل ہیں۔ ویب ٹولز پہلے سے غیر فعال ہوتے ہیں۔ فعال کیے جانے پر تلاشیں آپ کے ترتیب دیے گئے فراہم کنندہ کو بھیجی جاتی ہیں، یا جب کوئی فراہم کنندہ ترتیب نہ دیا گیا ہو تو Exa کی عوامی mcp.exa.ai سروس کو، جبکہ صفحات براہِ راست ان کی ویب سائٹس سے طلب کیے جاتے ہیں۔

تعمیل اور لائسنسنگ

iCode ایک آرکیسٹریشن ٹول ہے اور کوئی AI ماڈل فراہم نہیں کرتا۔ کاروباری یا انجینئرنگ استعمال کے لیے ماڈلز سے منسلک ہوتے وقت، EU AI Act اور دیگر قابلِ اطلاق قانونی یا ضابطہ جاتی تقاضوں کی تعمیل کی ذمہ داری آپ کی ہے۔

یہ پروجیکٹ Apache License 2.0 کے تحت اوپن سورس ہے۔ شامل کردہ فریقِ ثالث اجزا اپنے متعلقہ لائسنس برقرار رکھتے ہیں، جن کی دستاویزات ریپوزٹری کی NOTICE فائل میں موجود ہیں۔

نتیجہ

uv، ایک جدید ٹرمینل اور ترتیب دیے گئے ماڈل پروفائل کے ساتھ، آپ iCode کو ٹرمینل پر مبنی AI ایجنٹس اور ورک فلو کے مرکزی انٹرفیس کے طور پر استعمال کر سکتے ہیں۔ سادہ گفتگو سے آغاز کریں، تیار کردہ ہر فائل تبدیلی کا جائزہ لیں، پھر اپنے کام پیچیدہ ہونے کے ساتھ ایجنٹ کی ترتیب، ورک فلو، رول بیک، شیل رسائی اور Trajectory تجزیے کو آزمائیں۔