Capri ٹیوٹوریل: Windows کے AI ایجنٹ سے فائلوں، پروجیکٹس اور کوڈ کو کنٹرول کریں

Capri کیا ہے؟

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

Capri انٹرفیس اور ٹول کی تہہ کے طور پر کام کرتا ہے، جبکہ ایک بیرونی اسسٹنٹ AI کی دلیل فراہم کرتا ہے۔ یہ پہلے سے Claude Code، Codex اور Antigravity کو سپورٹ کرتا ہے۔ دیگر اسسٹنٹس کو کسٹم اڈاپٹرز کے ذریعے منسلک کیا جا سکتا ہے۔

Capri ایک آزاد، غیر سرکاری مداحوں کا پروجیکٹ ہے جو سائبرپنک صنف اور Cyberpunk: Edgerunners سے متاثر ہے۔ اس کا CD PROJEKT RED، Netflix، Studio Trigger، Anthropic، OpenAI یا Google سے کوئی تعلق یا توثیق نہیں ہے۔

اہم خصوصیات

• متعدد AI انجن: Claude Code، Codex، Antigravity یا کسی دوسرے اسسٹنٹ کو کسٹم اڈاپٹر کے ذریعے منسلک کریں۔
• مقامی ونڈوز انٹرفیس: براہِ راست ٹرمینل میں کام کرنے کے بجائے انسٹال شدہ ڈیسک ٹاپ ایپلیکیشن استعمال کریں۔
• فائل اور پروجیکٹ ٹولز: فائلوں یا مکمل پروجیکٹ فولڈرز کو تلاش، پڑھ، منظم اور ترمیم کریں۔
• ایجنٹ ورک فلو: Capri کسی کام کی منصوبہ بندی، ٹولز کی درخواست، نتیجے کی جانچ اور انجام دیے گئے کام کی رپورٹ کر سکتا ہے۔
• کوڈ معاونت: منتخب انجن سے کوڈ لکھنے، ری فیکٹر کرنے، ڈیبگ کرنے اور چلانے کی درخواست کریں۔
• منظوری کے کنٹرولز: حساس کارروائیوں کا جائزہ لیں اور Capri کے سسٹم میں تبدیلی کرنے سے پہلے انہیں منظور یا مسترد کریں۔
• قابلِ ترتیب دائرہ کار: رسائی کو منتخب فولڈرز تک محدود کریں اور پوچھنے، خودکار یا صرف پڑھنے کے اجازت رویے کا انتخاب کریں۔

ضروریات

Capri کے لیے فی الحال Windows 10 یا اس کے بعد کا ورژن درکار ہے۔ یہ ونڈوز کے .exe انسٹالر کے طور پر تقسیم کیا جاتا ہے۔ macOS اور Linux ورژن پروجیکٹ کے روڈمیپ میں شامل ہیں، لیکن فی الحال دستیاب نہیں۔

آپ کو اپنا معاونت یافتہ AI اسسٹنٹ اکاؤنٹ یا API کلید بھی درکار ہے۔ Capri خود MIT License کے تحت اوپن سورس ہے، لیکن منسلک AI فراہم کنندہ اپنی قیمتوں کے مطابق استعمال کی فیس لے سکتا ہے۔

ونڈوز پر Capri انسٹال کریں

1. انسٹالر ڈاؤن لوڈ کریں

Capri کی تازہ ترین ریلیز کھولیں اور Capri-Setup.exe ڈاؤن لوڈ کریں۔ کسی نامعلوم تیسرے فریق کے ڈاؤن لوڈ ماخذ کے بجائے سرکاری ریپوزٹری کا ریلیز صفحہ استعمال کریں۔

2. سیٹ اپ وزرڈ چلائیں

1. Capri-Setup.exe کھولیں۔
2. انسٹالیشن وزرڈ کی ہدایات پر عمل کریں۔
3. انسٹالیشن کے بعد، ونڈوز اسٹارٹ مینو سے Capri کھولیں۔

چونکہ Capri ایک نئی ایپلیکیشن ہے جس کی ڈاؤن لوڈ ساکھ ابھی زیادہ مضبوط نہیں ہو سکتی، اس لیے Windows SmartScreen ایک انتباہ دکھا سکتا ہے۔ اگر آپ نے انسٹالر سرکاری ریلیز صفحے سے حاصل کیا ہے تو جاری رکھنے کے لیے More info اور پھر Run anyway منتخب کریں۔

3. AI انجن منسلک کریں

پہلی بار چلانے پر Capri آپ سے اسسٹنٹ منتخب کرنے کو کہتا ہے۔ Claude Code، Codex، Antigravity یا کسی دوسرے معاونت یافتہ آپشن کا انتخاب کریں، پھر سائن اِن کریں یا مطلوبہ API کلید فراہم کریں۔

آپ کی درخواستیں اس اسسٹنٹ کے ذریعے پراسیس ہوتی ہیں جسے آپ منسلک کرتے ہیں۔ اس لیے اس پراسیسنگ پر فراہم کنندہ کی شرائط، رازداری کی پالیسی، قیمتیں اور اکاؤنٹ کے قواعد لاگو ہوتے ہیں۔

Capri کسی کام کو کیسے سنبھالتا ہے

1. آپ مقصد بیان کرتے ہیں: ڈیسک ٹاپ ایپلیکیشن میں سادہ زبان کی درخواست درج کریں۔
2. Capri انجن منتخب کرتا ہے: درخواست آپ کے تشکیل دیے گئے AI اسسٹنٹ کو بھیجی جاتی ہے۔
3. انجن منصوبہ بناتا ہے: اسسٹنٹ طے کرتا ہے کہ کون سے مراحل اور ٹولز درکار ہیں۔
4. Capri حساس کارروائیاں پیش کرتا ہے: آپ کی اجازتوں کے مطابق، آپ مطلوبہ فائل یا سسٹم آپریشنز کا جائزہ لے سکتے ہیں۔
5. آپ منظور یا مسترد کرتے ہیں: منظور شدہ کارروائیاں Capri کی ٹول تہہ کے ذریعے انجام دی جاتی ہیں۔
6. Capri نتیجے کی رپورٹ دیتا ہے: ایجنٹ نتیجے کی جانچ کرتا ہے اور اپنے کیے گئے کام کا خلاصہ پیش کرتا ہے۔

بنیادی استعمال کی مثالیں

فولڈر منظم کریں

کسی فولڈر کو صاف کرنے کے لیے مطلوبہ مقام کی نشاندہی کریں اور مطلوبہ تنظیم بیان کریں:

میرے Downloads فولڈر کو صاف کریں اور فائلوں کو قسم کے لحاظ سے گروپ کریں۔ کچھ منتقل کرنے سے پہلے مجھے منصوبہ دکھائیں۔

Capri فولڈر اسکین کر سکتا ہے، منصوبہ تجویز کر سکتا ہے اور فائلیں منتقل کرنے سے پہلے منظوری طلب کر سکتا ہے۔ آپریشن قبول کرنے سے پہلے منزل کے فولڈرز اور فائل ناموں کا احتیاط سے جائزہ لیں۔

کوڈ کی جانچ اور اصلاح کریں

متعلقہ پروجیکٹ فولڈر کھولیں یا اس تک رسائی دیں، پھر Capri کو مرکوز درخواست دیں:

اس پروجیکٹ میں بگ تلاش کریں، وجہ سمجھائیں، اسے درست کریں اور دستیاب چیکس چلائیں۔

منتخب AI انجن کوڈ کا معائنہ، ممکنہ مسئلے کی نشاندہی، متعلقہ فائلوں میں ترمیم اور چیکس چلا سکتا ہے۔ زیادہ محفوظ جائزے کے لیے، پروجیکٹ میں ترمیم کی اجازت دینے سے پہلے Capri سے مجوزہ تبدیلی کی وضاحت کرنے کو کہیں۔

دستاویزات کا خلاصہ بنائیں

Capri کسی مجاز فولڈر میں متعدد فائلوں کے ساتھ کام کر سکتا ہے۔ مثال کے طور پر:

اس فولڈر میں موجود ہر PDF کا خلاصہ بنائیں اور ایک مشترکہ خلاصہ دستاویز لکھیں۔

کام کی منظوری سے پہلے تصدیق کریں کہ Capri کون سا فولڈر پڑھے گا اور تیار کردہ دستاویز کہاں محفوظ کرنے کا ارادہ رکھتا ہے۔

ویب پروجیکٹ بنائیں

آپ مکمل ڈیولپمنٹ ورک فلو کی درخواست بھی کر سکتے ہیں:

اس فولڈر میں نئی ویب ایپ بنائیں، اس کی dependencies انسٹال کریں اور اسے شروع کریں۔

اس قسم کی درخواست میں فائلیں بنانا، پیکیجز ڈاؤن لوڈ کرنا، شیل کمانڈز چلانا اور کوئی پراسیس شروع کرنا شامل ہو سکتا ہے۔ منظوری سے پہلے مجوزہ فریم ورک، کمانڈز اور ہدف ڈائریکٹری کا معائنہ کریں۔

اجازتوں اور دائرہ کار کی تشکیل

README درج ذیل مثالی کنفیگریشن فراہم کرتی ہے:

engine: claude-code

permissions:
  mode: ask
  allowed_folders:
    - ~/Documents
    - ~/Projects

interface:
  theme: cyberpunk

engine کی قدر منسلک اسسٹنٹ کا انتخاب کرتی ہے۔ دستاویزی اقدار میں claude-code، codex، antigravity، اور custom شامل ہیں۔

permissions سیکشن میں تین دستاویزی موڈز شامل ہیں:

• ask: Capri کارروائی سے پہلے پوچھتا ہے۔ ایجنٹ کے رویے کو سمجھنے کے دوران آغاز کے لیے یہ بہترین انتخاب ہے۔
• auto: کارروائیاں خودکار طور پر جاری رہ سکتی ہیں۔ اسے صرف اسی وقت استعمال کریں جب آپ کام کو سمجھتے ہوں اور اس کا دائرہ سختی سے محدود کر چکے ہوں۔
• read-only: ترامیم کی اجازت دیے بغیر معائنہ اور تجزیے کے لیے Capri استعمال کریں۔

allowed_folders فہرست ان مقامات کو محدود کرتی ہے جن تک ایجنٹ رسائی حاصل کر سکتا ہے۔ پوری ڈرائیو یا صارف پروفائل کے بجائے کسی مخصوص ورکنگ ڈائریکٹری تک رسائی دینے کو ترجیح دیں۔

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

واضح حدود کے ساتھ پرامپٹس لکھیں

ہدف فولڈر، مطلوبہ نتیجہ، توثیق کا طریقہ، اور وہ کارروائیاں بیان کریں جن کے لیے تصدیق درکار ہے۔ واضح درخواست ابہام کم کرتی ہے:

Review the project in my Projects folder. Identify the cause of the failing tests, explain your proposed edits, and wait for approval before changing files. After approval, run the existing test suite.

آغاز صرف پڑھنے کے موڈ میں کریں

نامانوس ریپوزٹری یا دستاویزات کے مجموعے کے لیے read-only رسائی سے آغاز کریں۔ Capri سے مواد کا معائنہ کرنے اور منصوبہ تجویز کرنے کو کہیں۔ اجازت کا موڈ صرف اس وقت تبدیل کریں جب آپ ترامیم کی اجازت دینے کے لیے تیار ہوں۔

الگ تھلگ پروجیکٹ فولڈر استعمال کریں

تجرباتی کام کو ایک مخصوص فولڈر میں کاپی کریں اور Capri کو صرف اسی ڈائریکٹری تک رسائی دیں۔ اس سے حادثاتی ترامیم محدود ہوتی ہیں اور نتیجے میں فائلوں کے فرق کا جائزہ لینا آسان ہو جاتا ہے۔

منصوبہ بندی اور عمل درآمد الگ رکھیں

بڑے کاموں کے لیے پہلے بغیر ترامیم کے منصوبہ طلب کریں۔ مراحل کا جائزہ لیں، پھر دوسری ہدایت میں صرف منظور شدہ حصے کے لیے اجازت دیں۔ یہ بڑی تعداد میں فائلوں پر کارروائی، انحصارات کی تنصیب، یا وسیع ری فیکٹرنگ کے لیے خاص طور پر مفید ہے۔

موزوں وقت پر انجن تبدیل کریں

Capri آپ کو معاون AI انجنز میں سے انتخاب کرنے دیتا ہے۔ اگر آپ کے پاس متعدد اسسٹنٹس کے اکاؤنٹس ہیں تو موجودہ کام کے لیے موزوں ترین اسسٹنٹ منتخب کریں۔ یاد رکھیں کہ ہر فراہم کنندہ کی صلاحیتیں، لاگت، اور رازداری کی شرائط الگ ہوتی ہیں۔

کسٹم اڈاپٹر احتیاط سے استعمال کریں

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

یہ فرض نہ کریں کہ روڈ میپ کی ہر خصوصیت دستیاب ہے

روڈ میپ میں پلگ اِن سسٹم، صوتی کنٹرول، ٹاسک شیڈیولر، تھیم گیلری، اور macOS اور Linux ورژنز کو مکمل ہونے کے بجائے منصوبہ بند خصوصیات کے طور پر درج کیا گیا ہے۔ ان خصوصیات پر مبنی ورک فلو بنانے سے پہلے تازہ ترین ریلیز نوٹس دیکھیں۔

حفاظتی رہنما اصول

• ہر حساس کارروائی کا جائزہ لیں: حذف کرنے، منتقل کرنے، بدلنے، شیل کمانڈز، اور انحصارات کی تنصیب پر خاص توجہ دیں۔
• فولڈر کی رسائی محدود رکھیں: موجودہ کام کے لیے درکار فائلیں ہی ظاہر کریں۔
• بیک اپ رکھیں: بڑی تعداد میں تنظیم، خودکار تدوین، یا دیگر بڑی کارروائیوں سے پہلے اہم ڈیٹا کا بیک اپ لیں۔
• اسناد محفوظ رکھیں: API کیز، اکاؤنٹ ٹوکنز، یا دیگر راز کبھی شیئر نہ کریں۔
• تیار کردہ کمانڈز چیک کریں: Capri کو چلانے کی اجازت دینے سے پہلے شیل کمانڈ کو سمجھ لیں۔
• ورژن کنٹرول استعمال کریں: کوڈ پروجیکٹس کے لیے نمایاں ترامیم کی درخواست کرنے سے پہلے موجودہ حالت کو commit کریں یا کسی اور طریقے سے محفوظ رکھیں۔

اگر آپ کو سکیورٹی کا مسئلہ ملے تو پروجیکٹ کی سکیورٹی رپورٹنگ ہدایات پر عمل کرتے ہوئے اسے نجی طور پر رپورٹ کریں۔

خرابیوں کا ازالہ اور پروجیکٹ کے وسائل

اگر انسٹالر، انجن کنکشن، یا ایجنٹ ورک فلو توقع کے مطابق کام نہ کرے تو Capri GitHub ریپوزٹری اور تازہ ترین ریلیز نوٹس دیکھیں۔ بگز اور خصوصیات سے متعلق خیالات پروجیکٹ کے مسئلہ فارموں کے ذریعے جمع کرائے جا سکتے ہیں۔

بگ رپورٹس، دستاویزات، تھیمز، خصوصیات کی تجاویز، اور انجن اڈاپٹرز جیسے شعبوں میں تعاون کا خیرمقدم ہے۔ تبدیلیاں جمع کرانے سے پہلے ریپوزٹری کی معاونتی گائیڈ کا جائزہ لیں۔

نتیجہ

Capri Windows صارفین کو معاون AI اسسٹنٹس کو فائلوں، پروجیکٹس، اور کوڈ کے ساتھ کام کرنے کی ہدایت دینے کے لیے ایک ڈیسک ٹاپ انٹرفیس فراہم کرتا ہے۔ ایپلیکیشن انسٹال کریں، اپنا پسندیدہ انجن مربوط کریں، اسے درکار فولڈرز تک رسائی محدود کریں، اور منظوری پر مبنی یا صرف پڑھنے والی اجازتوں سے آغاز کریں۔ کسی بھی AI ایجنٹ کو اپنے کمپیوٹر پر کارروائی کی اجازت دیتے وقت واضح پرامپٹس، محتاط جائزے، بیک اپس، اور رسائی کی محدود حدود ضروری ہیں۔