coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp` হলো একটি Agent Hypervisor এবং সার্বজনীন Model Context Protocol (MCP) গেটওয়ে, যা স্বায়ত্তশাসিত CLI কোডিং এজেন্টদের অর্কেস্ট্রেট করার জন্য ডিজাইন করা হয়েছে। এটি AI সুপারভাইজার, IDE (যেমন Cursor এবং Windsurf) এবং ডেস্কটপ অ্যাসিস্ট্যান্টদের (যেমন Claude Desktop এবং Google Antigravity) Anthropic-এর Claude Code, Google-এর Antigravity, OpenAI-এর Codex এবং Cursor Agent-সহ অধীনস্থ কোডিং এজেন্ট পরিচালনা করার সুযোগ দেয়। ## মূল দর্শন প্রকল্পটি নির্ভরযোগ্য সরলতা এবং macOS, Linux ও Windows জুড়ে কঠোর ক্রস-প্ল্যাটফর্ম সমতার উপর জোর দেয়। প্রধান আর্কিটেকচারাল বৈশিষ্ট্যগুলোর মধ্যে রয়েছে: * **Zero Daemon / Zero Root:** একটি বিশুদ্ধ, আনপ্রিভিলেজড Node.js stdio প্রসেস হিসেবে কাজ করে। কোনো Docker daemon, root privilege বা ব্যাকগ্রাউন্ড সার্ভিসের প্রয়োজন নেই। * **Git Worktrees-এর মাধ্যমে সার্বজনীন স্যান্ডবক্সিং:** ডেডিকেটেড ব্রাঞ্চে বিচ্ছিন্ন, ক্ষণস্থায়ী Git worktree-তে এজেন্ট রান চালায়। এটি ফাইল churn এবং lock contention দূর করে, নিরাপদ merge বা discard অপারেশন সক্ষম করে। * **ক্রস-OS সামঞ্জস্য:** ভঙ্গুর OS-নির্দিষ্ট virtualization silo প্রত্যাখ্যান করে। সমস্ত isolation, safety এবং delegation বৈশিষ্ট্য স্ট্যান্ডার্ড Git এবং Node.js primitive ব্যবহার করে সব অপারেটিং সিস্টেমে অভিন্নভাবে চলে। * **প্রসেস সেফটি:** Unix-এ স্ট্যান্ডার্ড POSIX process group এবং Windows-এ `taskkill` ব্যবহার করে orphan-proof process reclamation প্রয়োগ করে, যাতে পরিষ্কার teardown নিশ্চিত হয়। ## প্রধান সক্ষমতা 1. **Agent Hypervisor Paradigm:** একটি goal-oriented substrate প্রদান করে, যেখানে সুপারভাইজিং মডেল intent, invariant এবং acceptance criteria নির্ধারণ করে, আর অধীনস্থ এজেন্ট স্বায়ত্তশাসিতভাবে micro-decision সম্পাদন করে। 2. **Stateful Sessions:** শূন্য token wire overhead-সহ কলগুলোর মধ্যে স্বয়ংক্রিয়ভাবে multi-turn conversation memory সংরক্ষণ করে। 3. **Inter-Agent Handoffs:** কাঁচা transcript-এর বদলে structured packet (objective, file manifest, git diff) ব্যবহার করে বিভিন্ন মডেলের মধ্যে কাজ স্থানান্তর করে, যা context window explosion প্রতিরোধ করে। 4. **Multi-Agent Orchestration:** `architect_builder`, `peer_review` এবং স্বয়ংক্রিয় rollback ও diff verification-সহ কাস্টম DAG-এর মতো বিল্ট-ইন declarative topology সমর্থন করে। 5. **Ephemeral Sandboxing:** এজেন্ট রান আলাদা করতে detached worktree ব্যবহার করে, যাতে পরিবর্তন স্পষ্টভাবে merge না হওয়া পর্যন্ত মূল workspace পরিষ্কার থাকে। ## সমর্থিত এজেন্ট | এজেন্ট | CLI বাইনারি | স্ট্যাটাস | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | সমর্থিত | | Google Antigravity | `agy` | সমর্থিত | | OpenAI Codex CLI | `codex` | Adapter Ready | | Cursor Agent | `cursor` | Adapter Ready | ## টুলসেট রেফারেন্স গেটওয়ে delegation, inspection এবং orchestration-এর জন্য বেশ কিছু টুল প্রকাশ করে: * **Core Delegation:** স্বায়ত্তশাসিত pair programming-এর জন্য `delegate_task`, read-only query-এর জন্য `delegate_ask` এবং workspace inspection-এর জন্য `delegate_diff`। * **Session Management:** conversation state পরিচালনার জন্য `delegate_sessions` এবং `delegate_reset`। * **Worktree Management:** বিচ্ছিন্ন sandbox তালিকাভুক্ত, পরিদর্শন, merge বা discard করার জন্য `delegate_worktree`। * **Orchestration:** multi-agent workflow-এর জন্য `delegate_pipeline` এবং structured task transfer-এর জন্য `delegate_handoff`। * **Messaging:** এজেন্টদের মধ্যে অ্যাসিঙ্ক্রোনাস সমন্বয়ের জন্য `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 লাইসেন্সের অধীনে।