منصوبے کے بارے میں

# coding-agents-mcp `coding-agents-mcp` ایک Agent Hypervisor اور یونیورسل Model Context Protocol (MCP) گیٹ وے ہے جو خودمختار CLI کوڈنگ ایجنٹس کو آرکسٹریٹ کرنے کے لیے ڈیزائن کیا گیا ہے۔ یہ AI سپروائزرز، IDEs (جیسے Cursor اور Windsurf)، اور ڈیسک ٹاپ اسسٹنٹس (جیسے Claude Desktop اور Google Antigravity) کو ماتحت کوڈنگ ایجنٹس بشمول Anthropic's Claude Code، Google's Antigravity، OpenAI's Codex، اور Cursor Agent کے انتظام کی اجازت دیتا ہے۔ ## بنیادی فلسفہ یہ پروجیکٹ قابل اعتماد سادگی اور macOS، Linux، اور Windows پر سخت کراس پلیٹ فارم برابری پر زور دیتا ہے۔ اہم آرکیٹیکچرل خصوصیات میں شامل ہیں: * **زیرو ڈیمون / زیرو روٹ:** ایک خالص، غیر مراعات یافتہ Node.js stdio پروسیس کے طور پر کام کرتا ہے۔ کسی Docker ڈیمون، روٹ مراعات، یا پس منظر کی خدمات کی ضرورت نہیں ہے۔ * **Git Worktrees کے ذریعے یونیورسل سینڈ باکسنگ:** ایجنٹ رنز کو الگ تھلگ، عارضی Git worktrees میں مخصوص برانچوں پر چلاتا ہے۔ یہ فائل کی بے ترتیبی اور لاک تنازعہ کو ختم کرتا ہے، جس سے محفوظ merge یا discard آپریشنز ممکن ہوتے ہیں۔ * **کراس-OS مستقل مزاجی:** کمزور OS مخصوص ورچوئلائزیشن سائلوز کو مسترد کرتا ہے۔ تمام آئسولیشن، حفاظت، اور تفویض کی خصوصیات معیاری Git اور Node.js primitives کا استعمال کرتے ہوئے آپریٹنگ سسٹمز میں یکساں طور پر چلتی ہیں۔ * **پروسیس سیفٹی:** Unix پر معیاری POSIX پروسیس گروپس اور Windows پر `taskkill` کا استعمال کرتے ہوئے یتیم پروف پروسیس ری کلیمیشن کو نافذ کرتا ہے تاکہ صاف ٹیر ڈاؤن کو یقینی بنایا جا سکے۔ ## اہم صلاحیتیں 1. **Agent Hypervisor پیراڈائم:** ایک مقصد پر مبنی سبسٹریٹ فراہم کرتا ہے جہاں نگران ماڈلز ارادہ، انویریئنٹس، اور قبولیت کے معیار کا تعین کرتے ہیں، جبکہ ماتحت ایجنٹس خودمختاری سے مائیکرو فیصلے کرتے ہیں۔ 2. **اسٹیٹفل سیشنز:** کالز کے دوران ملٹی ٹرن گفتگو کی میموری کو خودکار طور پر محفوظ رکھتا ہے بغیر کسی ٹوکن وائر اوور ہیڈ کے۔ 3. **ایجنٹس کے درمیان ہینڈ آفز:** خام ٹرانسکرپٹس کے بجائے ساختی پیکٹس (مقاصد، فائل مینی فیسٹس، git diffs) کا استعمال کرتے ہوئے مختلف ماڈلز کے درمیان کام منتقل کرتا ہے، جس سے کانٹیکسٹ ونڈو کے پھٹنے کو روکا جاتا ہے۔ 4. **ملٹی ایجنٹ آرکسٹریشن:** بلٹ ان ڈیکلریٹو ٹوپولوجیز جیسے `architect_builder`، `peer_review`، اور حسب ضرورت DAGs کی خودکار رول بیک اور diff تصدیق کے ساتھ معاونت کرتا ہے۔ 5. **عارضی سینڈ باکسنگ:** ایجنٹ رنز کو الگ تھلگ کرنے کے لیے ڈیٹیچڈ worktrees استعمال کرتا ہے، جس سے یہ یقینی بنایا جاتا ہے کہ مرکزی ورک اسپیس صاف رہے جب تک کہ تبدیلیاں واضح طور پر merge نہ ہو جائیں۔ ## معاون ایجنٹس | ایجنٹ | CLI بائنری | حیثیت | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | معاون | | Google Antigravity | `agy` | معاون | | OpenAI Codex CLI | `codex` | اڈاپٹر تیار | | Cursor Agent | `cursor` | اڈاپٹر تیار | ## ٹول سیٹ حوالہ گیٹ وے تفویض، معائنہ، اور آرکسٹریشن کے لیے کئی ٹولز فراہم کرتا ہے: * **بنیادی تفویض:** خودمختار پیئر پروگرامنگ کے لیے `delegate_task`، صرف پڑھنے کے سوالات کے لیے `delegate_ask`، اور ورک اسپیس معائنہ کے لیے `delegate_diff`۔ * **سیشن مینجمنٹ:** گفتگو کی حالت کا انتظام کرنے کے لیے `delegate_sessions` اور `delegate_reset`۔ * **Worktree مینجمنٹ:** الگ تھلگ سینڈ باکسز کی فہرست، معائنہ، merge، یا discard کرنے کے لیے `delegate_worktree`۔ * **آرکسٹریشن:** ملٹی ایجنٹ ورک فلو کے لیے `delegate_pipeline` اور ساختی کام کی منتقلی کے لیے `delegate_handoff`۔ * **میسجنگ:** ایجنٹس کے درمیان غیر متزامن کوآرڈینیشن کے لیے `agent_mailbox`۔ ## فوری آغاز `npx` کے ذریعے براہ راست چلائیں: ```bash npx -y coding-agents-mcp ``` ### کنفیگریشن کی مثالیں **Claude Desktop (`claude_desktop_config.json`):** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Cursor (`~/.cursor/mcp.json`):** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Google Antigravity Sidecar:** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp", "--compat=agy"] } } } ``` ## ڈیولپمنٹ مقامی طور پر بنانے اور جانچنے کے لیے: ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` یہ پروجیکٹ MIT کے تحت لائسنس یافتہ ہے۔