পোর্টেবল সেটআপ কিট দিয়ে এক্সিকিউশন-ফার্স্ট Codex CLI ওয়ার্কস্পেস তৈরি করুন

Codex CLI Portable Setup Kit যা করে

Codex CLI Portable Setup Kit হলো OpenAI Codex CLI-এর জন্য কমিউনিটি-পরিচালিত একটি কনফিগারেশন ও ইনস্টলার। এটি নিজে Codex নয় এবং OpenAI-এর কোনো আনুষ্ঠানিক পণ্যও নয়।

এই কিটটি রিপোজিটরির কাজের প্রতি Codex-এর দৃষ্টিভঙ্গি পরিবর্তন করে। এর নির্দেশনায় ওয়ার্কস্পেস পরিদর্শন, উপলভ্য টুল ব্যবহার, অনুরোধ করা পরিবর্তন করা, যাচাই চালানো, ব্যর্থতার কারণ নির্ণয় এবং যাচাইকৃত ফলাফল জানানোকে গুরুত্ব দেওয়া হয়। পোর্টেবিলিটি হলো সরবরাহের মাধ্যম; মূল পণ্য হলো এই execution-first পরিচালনাপদ্ধতি।

গুরুত্বপূর্ণ: TURBO মোড উন্নত, non-interactive আচরণ সক্রিয় করে, যার মধ্যে approval_policy = "never" রয়েছে। এটি কেবল বিশ্বস্ত ওয়ার্কস্পেসে এবং প্যাকেজ পর্যালোচনা করার পর ব্যবহার করুন। স্ট্যান্ডার্ড পাবলিক কনফিগারেশন অপেক্ষাকৃত নিরাপদ on-request approval এবং workspace-write sandboxing দিয়ে শুরু হয়।

প্রধান বৈশিষ্ট্য

• Execution-first নির্দেশনা: সাধারণ পরামর্শ বা পরিকল্পনা দেওয়ার পর থেমে না গিয়ে, প্রকৃত লক্ষ্যে কাজ করার জন্য Codex-কে নির্দেশ দেওয়া হয়।
• এক-ক্লিক TURBO চালু: TURBO.cmd ওয়ার্কস্পেস যাচাই করে, উন্নত execution policy কনফিগার করে, নেটিভ model settings গ্রহণ করে এবং Codex চালু করে।
• Transactional installation: ইনস্টলার SHA-256 manifest যাচাই করে, টাইমস্ট্যাম্পযুক্ত ব্যাকআপ তৈরি করে, অপারেশন জার্নাল সংরক্ষণ করে এবং rollback receipt তৈরি করে।
• Deterministic analysis tools: বিশুদ্ধ Python-ভিত্তিক re-toolkit PE32 ও PE32+ পরিদর্শন, x86 ও x64 disassembly, AOB scanning, micro-emulation, Protobuf ও TLV analysis, Frida hook generation এবং binary differences পরিচালনা করে।
• Dual-stage processing: placeholder artifact এবং নিম্নমানের দীর্ঘ-ফর্ম আউটপুট কমাতে structural planning-কে high-fidelity rendering থেকে আলাদা করা হয়েছে।
• একাধিক agent format: প্যাকেজটি Codex CLI, OpenCode, Claude Code, Cursor, Windsurf এবং ChatGPT App-এর জন্য নির্দেশনা বা preset সরবরাহ করে।
• Continuity support: দীর্ঘ কাজের সময় যাচাইকৃত state ধরে রাখতে hooks ও context tools সহায়তা করে।
• Reversible Git integration: ইনস্টলার core.hooksPath-কে প্যাকেজে থাকা pre-commit guard-এর সঙ্গে যুক্ত করতে পারে এবং rollback-এর সময় আগের মান পুনরুদ্ধার করতে পারে।

প্রয়োজনীয়তা ও প্রস্তুতি

রিপোজিটরিতে Windows 10 ও 11, PowerShell 5.1 বা 7 এবং Python 3.10 বা পরবর্তী সংস্করণকে সমর্থিত উপাদান হিসেবে উল্লেখ করা হয়েছে। প্রধান workflow-এর জন্য Codex CLI প্রয়োজন, তবে Codex না থাকলে ইনস্টলার compatibility-pinned global @openai/codex package যোগ করতে পারে।

1. একটি release ZIP ডাউনলোড করুন অথবা রিপোজিটরি clone করুন।
2. ZIP ডাউনলোড করলে সেটি একটি স্থানীয় directory-তে extract করুন।
3. Codex যে repository পরিচালনা করবে, সেটি নির্বাচন করুন।
4. উন্নত বা unrestricted execution সক্রিয় করার আগে অন্তর্ভুক্ত script ও configuration পর্যালোচনা করুন।
5. ইনস্টলার transactional backup তৈরি করলেও বিশেষ গুরুত্বপূর্ণ workspace data স্বাধীনভাবে ব্যাকআপ করুন।

বিকল্প ১: TURBO মোড দিয়ে শুরু

সবচেয়ে সংক্ষিপ্ত setup পদ্ধতির জন্য release extract করে ডাবল-ক্লিক করুন:

TURBO.cmd

লঞ্চারটি workspace যাচাই করে, উন্নত execution profile কনফিগার করে, আপনার native model settings ব্যবহার করে এবং কাজের জন্য প্রস্তুত Codex খুলে দেয়। এই মোড runtime tools-কে আগেই অনুমোদন করে, workspace-কে fully trusted হিসেবে চিহ্নিত করে এবং non-interactive approval আচরণ ব্যবহার করে।

এই সেটিংগুলো confirmation barrier কমিয়ে দেয়, তাই পর্যালোচিত code এবং বিশ্বস্ত workspace-এর জন্য TURBO মোড সংরক্ষণ করুন। আরও নিয়ন্ত্রিত installation-এর জন্য নিচের manual procedure ব্যবহার করুন।

বিকল্প ২: Manual Transactional Installation সম্পন্ন করুন

Extract করা kit directory-তে PowerShell খুলুন। বর্তমান PowerShell process-এর জন্য সাময়িকভাবে installation script অনুমোদন করুন, তারপর target workspace-এর absolute path দিন:

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

উদাহরণটি unrestricted Keysmith preset নির্বাচন করে এবং ঐচ্ছিক plugin বাদ দেয়। আপনার environment-এ ব্যবহারের আগে এই পছন্দগুলো পর্যালোচনা করুন।

Installation চলাকালে কিটটি একটি transactional sequence অনুসরণ করে:

1. Project root যাচাই করা।
2. SHA-256 manifest-এর সঙ্গে source package যাচাই করা।
3. টাইমস্ট্যাম্পযুক্ত backup এবং operation journal তৈরি করা।
4. User files, skills, project files, context tools এবং re-toolkit install করা।
5. Destination environment-এর জন্য প্রয়োজনীয় path প্রতিস্থাপন করা।
6. Project trust এবং repository Git hook path কনফিগার করা।
7. অনুরোধ করা হলে optional plugin setup চেষ্টা করা, তবে plugin ব্যর্থতাকে fatal হিসেবে গণ্য না করা।
8. receipt.json এবং last-receipt.txt লেখা।

প্রতিটি প্রতিস্থাপন ঘটার আগে তা রেকর্ড করা হয়। Installation-এর পরবর্তী কোনো ধাপ ব্যর্থ হলে, ইনস্টলার operation list-টি উল্টো ক্রমে replay করে এবং আগের Git hook binding পুনরুদ্ধার করে।

ইনস্টলার যা যোগ করে

• Codex ব্যবহারকারীর কনফিগারেশন: %CODEX_HOME% অথবা ~/.codex-এর অধীনে থাকা ফাইল, যার মধ্যে config.toml, AGENTS.md, নির্দেশনা, স্টার্টার নিয়ম এবং স্কিল অন্তর্ভুক্ত।
• ব্যবহারকারী-স্তরের এজেন্ট স্কিল: ~/.agents-এর অধীনে পুনর্ব্যবহারযোগ্য স্কিল।
• প্রকল্প কনফিগারেশন: AGENTS.md, CLAUDE.md, .codex, .agents, .gitignore, কনটেক্সট ওয়ার্কফ্লো, হুক এবং রিভার্স-ইঞ্জিনিয়ারিং টুলকিট।
• স্থানীয় Git কনফিগারেশন: নির্বাচিত রিপোজিটরির জন্য core.hooksPath=.agents/git-hooks।
• Codex CLI: Codex আগে থেকে উপলভ্য না থাকলে সামঞ্জস্যতা-নির্ধারিত গ্লোবাল npm ইনস্টলেশন।
• ঐচ্ছিক প্লাগইন: উপলভ্য থাকলে 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+ ফাইলের হেডার, সেকশন টেবিল, আমদানি করা DLL, রপ্তানি করা সিম্বল এবং 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 wire-format ডেটা পরিদর্শন করে। সাবসিস্টেমটিতে 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 মোড সক্রিয় করুন।