پورٹیبل سیٹ اپ کٹ کے ساتھ عمل درآمد پر مبنی Codex CLI ورک اسپیس بنائیں

Codex CLI Portable Setup Kit کیا کرتا ہے

Codex CLI Portable Setup Kit OpenAI Codex CLI کے لیے کمیونٹی کے زیر انتظام کنفیگریشن اور انسٹالر ہے۔ یہ خود Codex نہیں ہے اور نہ ہی OpenAI کی کوئی سرکاری پروڈکٹ ہے۔

یہ کِٹ اس طریقے کو تبدیل کرتا ہے جس سے Codex ریپوزٹری کے کام انجام دیتا ہے۔ اس کی ہدایات ورک اسپیس کا جائزہ لینے، دستیاب ٹولز استعمال کرنے، مطلوبہ تبدیلیاں کرنے، چیکس چلانے، ناکامیوں کی تشخیص کرنے اور تصدیق شدہ نتائج بتانے پر زور دیتی ہیں۔ پورٹیبلٹی صرف ترسیل کا ذریعہ ہے؛ اصل پروڈکٹ عملدرآمد پر مبنی یہ طریقۂ کار ہے۔

اہم: TURBO موڈ میں بلند مراعات والا غیر تعاملی رویہ فعال ہوتا ہے، جس میں approval_policy = "never" شامل ہے۔ اسے صرف ایسی ورک اسپیس میں استعمال کریں جس پر آپ کو اعتماد ہو اور پیکیج کا جائزہ لینے کے بعد۔ معیاری عوامی کنفیگریشن زیادہ محفوظ، درخواست پر منظوری اور workspace-write سینڈ باکسنگ سے شروع ہوتی ہے۔

اہم خصوصیات

• عملدرآمد پر مبنی ہدایات: Codex کو ہدایت دی جاتی ہے کہ عمومی مشورے یا منصوبے پر رکنے کے بجائے اصل ہدف پر کام کرے۔
• ایک کلک سے TURBO لانچ: TURBO.cmd ورک اسپیس کی توثیق کرتا ہے، بلند مراعات والی عملدرآمد پالیسیز ترتیب دیتا ہے، مقامی ماڈل سیٹنگز برقرار رکھتا ہے اور Codex شروع کرتا ہے۔
• ٹرانزیکشنل انسٹالیشن: انسٹالر SHA-256 مینی فیسٹس کی تصدیق کرتا ہے، ٹائم اسٹیمپ والے بیک اپ بناتا ہے، آپریشنز کا جرنل محفوظ کرتا ہے اور رول بیک رسید تیار کرتا ہے۔
• متعین تجزیاتی ٹولز: خالص Python پر مبنی re-toolkit PE32 اور PE32+ معائنہ، x86 اور x64 ڈس اسمبلی، AOB اسکیننگ، مائیکرو ایمولیشن، Protobuf اور TLV تجزیہ، Frida ہُک جنریشن اور بائنری اختلافات سنبھالتا ہے۔
• دو مرحلوں کی پروسیسنگ: پلیس ہولڈر کے باقی رہ جانے والے نمونے اور کم معیار کے طویل متن کے آؤٹ پٹ کو کم کرنے کے لیے ساختی منصوبہ بندی کو اعلیٰ معیار کی رینڈرنگ سے الگ رکھا گیا ہے۔
• ایجنٹ کے متعدد فارمیٹس: پیکیج Codex CLI، OpenCode، Claude Code، Cursor، Windsurf اور ChatGPT App کے لیے ہدایات یا پری سیٹس فراہم کرتا ہے۔
• تسلسل کی معاونت: ہُکس اور کانٹیکسٹ ٹولز طویل کاموں کے دوران تصدیق شدہ حالت برقرار رکھنے میں مدد دیتے ہیں۔
• قابل واپسی Git انٹیگریشن: انسٹالر core.hooksPath کو پیکیج شدہ pre-commit guard سے منسلک کر سکتا ہے اور رول بیک کے دوران پچھلی قدر بحال کر سکتا ہے۔

تقاضے اور تیاری

ریپوزٹری Windows 10 اور 11، PowerShell 5.1 یا 7، اور Python 3.10 یا اس کے بعد کے ورژنز کو معاون اجزا کے طور پر درج کرتی ہے۔ بنیادی ورک فلو کے لیے Codex CLI درکار ہے، تاہم Codex موجود نہ ہونے کی صورت میں انسٹالر مطابقت کے لیے مخصوص عالمی @openai/codex پیکیج شامل کر سکتا ہے۔

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

آپشن 1: TURBO موڈ سے شروع کریں

مختصر ترین سیٹ اپ کے لیے ریلیز نکالیں اور اس فائل پر ڈبل کلک کریں:

TURBO.cmd

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

چونکہ یہ سیٹنگز تصدیق کی رکاوٹیں کم کرتی ہیں، اس لیے TURBO موڈ صرف نظرثانی شدہ کوڈ اور قابل اعتماد ورک اسپیسز کے لیے مخصوص رکھیں۔ زیادہ قابو میں انسٹالیشن کے لیے ذیل میں دیا گیا دستی طریقۂ کار استعمال کریں۔

آپشن 2: دستی ٹرانزیکشنل انسٹالیشن کریں

نکالی گئی کِٹ ڈائریکٹری میں PowerShell کھولیں۔ موجودہ PowerShell عمل کے لیے انسٹالیشن اسکرپٹ کو عارضی طور پر اجازت دیں، پھر اپنی ہدف ورک اسپیس کا مطلق راستہ فراہم کریں:

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1 -ProjectRoot 'C:\path\to\your-workspace' -KeysmithPreset unrestricted -SkipPlugins

یہ مثال unrestricted Keysmith پری سیٹ منتخب کرتی ہے اور اختیاری پلگ انز چھوڑ دیتی ہے۔ اپنے ماحول میں استعمال سے پہلے ان انتخاب کا جائزہ لیں۔

انسٹالیشن کے دوران کِٹ ٹرانزیکشنل سلسلے کی پیروی کرتی ہے:

1. پروجیکٹ روٹ کی توثیق کریں۔
2. ماخذ پیکیج کی SHA-256 مینی فیسٹ کے مطابق تصدیق کریں۔
3. ٹائم اسٹیمپ والا بیک اپ اور آپریشن جرنل بنائیں۔
4. صارف کی فائلیں، اسکلز، پروجیکٹ فائلیں، کانٹیکسٹ ٹولز اور re-toolkit انسٹال کریں۔
5. منزل کے ماحول کے لیے درکار راستے تبدیل کریں۔
6. پروجیکٹ ٹرسٹ اور ریپوزٹری Git ہُک پاتھ ترتیب دیں۔
7. درخواست کیے جانے پر اختیاری پلگ ان سیٹ اپ کی کوشش کریں، مگر پلگ ان کی ناکامی کو مہلک نہ سمجھیں۔
8. receipt.json اور last-receipt.txt لکھیں۔

ہر تبدیلی سے پہلے اسے ریکارڈ کیا جاتا ہے۔ اگر انسٹالیشن کا کوئی بعد کا مرحلہ ناکام ہو جائے تو انسٹالر آپریشنز کی فہرست کو الٹی ترتیب سے دوبارہ چلاتا ہے اور پچھلی Git ہُک بائنڈنگ بحال کرتا ہے۔

انسٹالر کیا شامل کرتا ہے

• Codex صارف کی تشکیل: %CODEX_HOME% یا ~/.codex کے تحت موجود فائلیں، جن میں config.toml، AGENTS.md، ہدایات، ابتدائی قواعد اور مہارتیں شامل ہیں۔
• صارف کی سطح کی ایجنٹ مہارتیں: ~/.agents کے تحت دوبارہ استعمال کے قابل مہارتیں۔
• پروجیکٹ کی تشکیل: AGENTS.md، CLAUDE.md، .codex، .agents، .gitignore، کانٹیکسٹ ورک فلو، ہُکس اور ریورس انجینئرنگ ٹول کِٹ۔
• مقامی Git تشکیل: منتخب ریپوزٹری کے لیے core.hooksPath=.agents/git-hooks۔
• Codex CLI: مطابقت کے لیے مخصوص عالمی npm تنصیب، جب Codex پہلے سے دستیاب نہ ہو۔
• اختیاری پلگ اِنز: دستیاب ہونے کی صورت میں Browser، Visualize اور Sites سپورٹ۔

ریلیز میں جان بوجھ کر اسناد اور مشین سے منسلک حالت شامل نہیں کی گئی۔ یہ کسی دوسرے کمپیوٹر سے توثیقی ڈیٹا، OAuth ڈیٹا، سیشنز، تاریخیں، لاگز، کیشز، SQLite ڈیٹابیسز، کوکیز، API کیز، نجی کیز، براؤزر رَن ٹائم ڈیٹا، ڈیسک ٹاپ بائنری راستے یا کانٹیکسٹ رَن ٹائم حالت منتقل نہیں کرتی۔

پیکیج اور تنصیب کی توثیق کریں

سیٹ اپ پر بھروسا کرنے سے پہلے پیکیج کی توثیقی اسکرپٹ چلائیں:

.\verify.ps1

کسی مخصوص ورک اسپیس میں نصب فائلوں کی توثیق کرنے کے لیے -Installed اور پروجیکٹ کا راستہ شامل کریں:

.\verify.ps1 -Installed -ProjectRoot 'C:\path\to\your-workspace'

توثیق ڈیزائن کا ایک اہم حصہ ہے۔ انسٹالر لکھنے سے پہلے مینی فیسٹ چیک کرتا ہے اور مینی فیسٹ میں راستے کے ذریعے غیر مجاز رسائی کو روکتا ہے۔ ریپوزٹری ریلیز ٹیسٹنگ کے لیے استعمال ہونے والے نو مراحل پر مشتمل Test-All.ps1 سوٹ بھی بیان کرتی ہے۔

Codex کے ساتھ بنیادی استعمال

تنصیب کے بعد، تشکیل شدہ ریپوزٹری میں TURBO.cmd یا اپنے معمول کے Codex CLI ورک فلو کے ذریعے Codex شروع کریں۔ اسے عمومی مشورے کی درخواست کے بجائے ریپوزٹری کا کوئی ٹھوس کام دیں۔

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

ایک موزوں کام اس طرح لکھا جا سکتا ہے:

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

اس پروفائل کا مقصد Codex کو پہلے فائلوں اور ٹیسٹ آؤٹ پٹ کا معائنہ کرنے، اصل پروجیکٹ میں ترمیم کرنے، ناکام جانچ دوبارہ آزمانے اور پھر آپ کے ہاتھ سے چلانے کے لیے ٹیوٹوریل دینے کے بجائے مختصر نتیجہ فراہم کرنے کی ترغیب دینا ہے۔

بلٹ اِن re-toolkit استعمال کریں

ٹول کِٹ پروجیکٹ کے اندر .agents/tools/re-toolkit/ میں نصب ہے۔ اس کا متحدہ داخلی نقطۂ آغاز cli.py ہے۔ --json کو سپورٹ کرنے والے کمانڈز خاص طور پر اس وقت مفید ہیں جب کسی دوسری اسکرپٹ یا ایجنٹ کو ساخت یافتہ آؤٹ پٹ درکار ہو۔

بائنری کی خودکار ابتدائی جانچ

python .agents/tools/re-toolkit/cli.py auto target.dll --json

یہ ہدف کی خودکار فارمیٹ دریافت اور ابتدائی جانچ کرتا ہے۔

PE فائل کا معائنہ

python .agents/tools/re-toolkit/cli.py parse-pe sample.exe --json

PE پارسر PE32 اور PE32+ فائلوں کے ہیڈرز، سیکشن ٹیبلز، درآمد شدہ DLLs، برآمد شدہ سمبلز اور RVA ترجمے کی معلومات کا معائنہ کر سکتا ہے۔

AOB پیٹرن اسکین کریں

python .agents/tools/re-toolkit/cli.py pattern-scan target.bin --pattern "48 89 ?? 24 ?? 55" --json

جب بائٹس مختلف بائنریز یا ورژنز میں تبدیل ہو سکتی ہوں تو وائلڈ کارڈ کے طور پر ?? استعمال کریں۔

اسٹرنگز اخذ کریں

python .agents/tools/re-toolkit/cli.py strings sample.exe --min-len 5 --json

یہ ASCII اور UTF-16LE اسٹرنگز کو ان کے آفسیٹس سمیت اخذ کرتا ہے، جبکہ منتخب کم از کم لمبائی سے چھوٹی اسٹرنگز کو خارج کر دیتا ہے۔

آپ کوڈز ڈس اسمبلی کریں

python .agents/tools/re-toolkit/cli.py disasm 90505831C0C3 --arch x86_64

ڈس اسمبلر خام آپ کوڈز یا بائنری سیکشنز کے x86 اور x64 تجزیے کو سپورٹ کرتا ہے۔

غیر دستاویزی Protobuf پے لوڈ ڈی کوڈ کریں

python .agents/tools/re-toolkit/cli.py decode-protobuf 089601120474657374

یہ Protobuf وائر فارمیٹ ڈیٹا کا اسکیما کے بغیر معائنہ کرتا ہے۔ اس ذیلی نظام میں TLV فریم کی تحلیل بھی شامل ہے۔

ہدایات کی مختصر ترتیب کی ایمولیشن

python .agents/tools/re-toolkit/cli.py emulate --code B82A000000505BC3

مائیکرو ایمولیٹر معاون CPU سطح کے تجزیے کے لیے رجسٹر، اسٹیک اور میموری کا الگ سینڈ باکس فراہم کرتا ہے۔

Frida ہُک بنائیں

python .agents/tools/re-toolkit/cli.py gen-hook --symbol CryptHashData --module advapi32.dll --output hook.js

یہ منتخب ماڈیول اور سمبل کے لیے Frida انٹرسیپٹر اسکرپٹ بناتا ہے۔ ٹول کِٹ اینٹی ڈیبگ اسکرپٹ بنانے کو بھی سپورٹ کرتی ہے۔

بائنری فرق کا پیچ شمار کریں

python .agents/tools/re-toolkit/cli.py diff-patch --orig orig.bin --patched mod.bin --json

یہ اصل بائنری کا ترمیم شدہ نقل سے موازنہ کرتا ہے اور پیچ کی معلومات جاری کرتا ہے۔

کسی حصے کا ہیکس ڈمپ کے طور پر معائنہ

python .agents/tools/re-toolkit/cli.py hexdump target.bin --offset 0x100 --length 128

یہ آفسیٹ 0x100 سے شروع ہونے والے 128 بائٹس کو منظم ہیکساڈیسیمل ڈمپ کی صورت میں فارمیٹ کرتا ہے۔

دو مرحلہ پائپ لائن چلائیں

پروجیکٹ میں ایک دو مرحلہ پائپ لائن شامل ہے جو ساختی منصوبہ بندی کو حتمی رینڈرنگ سے الگ کرتی ہے۔ پہلا مرحلہ ساخت اور اہم مراحل تیار کرتا ہے، جبکہ دوسرا مکمل آؤٹ پٹ بناتا ہے۔ اس جدائی کا مقصد توجہ کے بکھراؤ، اختصار اور ROLE_A اور ROLE_B جیسے لفظی پلیس ہولڈر کے آثار کو کم کرنا ہے۔

python .agents/tools/re-toolkit/cli.py pipeline "Your complex scenario or system architecture prompt"

یہ ورک فلو ان پیچیدہ پرامٹس کے لیے زیادہ موزوں ہے جنہیں تفصیلی جنریشن سے پہلے واضح ساختی تیاری سے فائدہ ہوتا ہے۔

اس پیکیج میں کئی ایجنٹ ماحولیات کے لیے مقامی کنفیگریشن فائلیں شامل ہیں، جن میں Codex CLI کے لیے AGENTS.md، OpenCode کے لیے OPENCODE.md اور opencode.json، Claude Code کے لیے CLAUDE.md، Cursor کے لیے .cursorrules، اور Windsurf کے لیے .windsurfrules شامل ہیں۔

ورک اسپیس میں معاون GPT پر مبنی ایجنٹ فریم ورکس اور IDE انٹیگریشنز کو ترتیب دینے اور ہم آہنگ کرنے کے لیے یونیورسل اڈاپٹر چلائیں:

ADAPT_ALL.cmd

آپ re-toolkit کے ذریعے پری سیٹس بھی ایکسپورٹ کر سکتے ہیں:

python .agents/tools/re-toolkit/cli.py export-preset --target all

ریپوزٹری میں docs/CHATGPT_APP_PRESET.md کے تحت ایک علیحدہ ChatGPT App پری سیٹ شامل ہے۔

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

آٹومیشن کے لیے ساختی آؤٹ پٹ کو ترجیح دیں

جہاں کمانڈ معاونت کرتی ہو وہاں --json استعمال کریں۔ PE پارسنگ، پیٹرن اسکیننگ، خودکار ٹرائیج، یا بائنری اختلافات سے حاصل ہونے والے ساختی نتائج کو محفوظ کرنا، موازنہ کرنا، اور کسی دوسرے ٹول میں منتقل کرنا زیادہ آسان ہوتا ہے۔

تجزیاتی کمانڈز کو یکجا کریں

فارمیٹ کی دریافت کے لیے auto سے شروع کریں، ایگزیکیوٹیبل میٹا ڈیٹا کے لیے parse-pe جاری رکھیں، قابلِ مطالعہ اشارے تلاش کرنے کے لیے strings استعمال کریں، اور جب آپ کے پاس بائٹ سگنیچر کا ممکنہ امیدوار ہو تو pattern-scan لاگو کریں۔ مزید گہری جانچ کے لیے مرحلہ وار disasm، emulate، یا gen-hook استعمال کریں۔

قیاسی پروب احتیاط سے استعمال کریں

ٹول کِٹ انکار پر عمل روکنے اور فیل اوور کے ساتھ قیاسی دوہری ماڈل شیڈو پروب فراہم کرتی ہے:

python .agents/tools/re-toolkit/cli.py spec-probe "Reverse engineer target module and extract memory offsets" --target game.dll --json

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

رسیدیں محفوظ رکھیں

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

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

واضح طور پر منتخب کیے گئے TURBO رویے کے علاوہ، عوامی ایڈیشن کا آغاز ان قابلِ جائزہ ترتیبات سے ہوتا ہے:

approval_policy = "on-request"
sandbox_mode = "workspace-write"

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

انسٹالیشن واپس کریں

تازہ ترین ریکارڈ شدہ انسٹالیشن بحال کرنے کے لیے چلائیں:

.\rollback.ps1

کسی مخصوص ٹرانزیکشن کو بحال کرنے کے لیے اس کی رسید واضح طور پر فراہم کریں:

.\rollback.ps1 -Receipt 'C:\path\to\receipt.json'

Git Bash صارفین ریپر چلا سکتے ہیں:

./ROLLBACK.sh

رول بیک انسٹالر کی شامل کردہ فائلیں ہٹا دیتا ہے، انسٹالیشن سے پہلے موجود فائلیں بحال کرتا ہے، اور ریپوزٹری کی سابقہ core.hooksPath قدر بحال یا غیر مقرر کرتا ہے۔

مزید دستاویزات

بنیادی Codex تصورات کے لیے Codex CLI، کنفیگریشن کی بنیادی باتیں، AGENTS.md، قواعد، ہُکس، اسکلز، اور پلگ اِنز کی سرکاری دستاویزات ملاحظہ کریں۔

نتیجہ

Codex CLI Portable Setup Kit ایک ایگزیکیوشن پر مرکوز Codex پروفائل، پروجیکٹ ہدایات، ایجنٹ انٹیگریشنز، متعین تجزیاتی یوٹیلیٹیز، تصدیق، بیک اپس، اور رول بیک کو ایک قابلِ تکرار سیٹ اپ میں یکجا کرتی ہے۔ جب آپ قابلِ جائزہ کنٹرولز چاہتے ہوں تو معیاری ٹرانزیکشنل انسٹالیشن سے آغاز کریں، نتیجے کی تصدیق کریں، اور TURBO موڈ صرف اسی وقت فعال کریں جب اس کا بلند سطح کا، غیر تعاملی رویہ کسی قابلِ اعتماد ورک اسپیس کے لیے موزوں ہو۔