اطلب ميزة
صِف المشكلة التي تريد حلّها، وما تفعله اليوم للالتفاف عليها. المشكلة الواضحة أسهل في النقاش من حلّ جاهز.
تُفتح كـissue عامة على GitHub، حيث يستطيع المشرفون والمستخدمون الآخرون قراءتها والإضافة إليها.
للمطوّرين
يعرض Project Orchestrator كل ما يفعله التطبيق في صورة أدوات MCP وواجهة REST API وتدفقَي WebSocket. ويحفظ خادم Rust الشيفرة والخطط والقرارات والملاحظات في رسم Neo4j البياني وفي Meilisearch.
تبحث عن المنتج نفسه؟ ارجع إلى الصفحة الرئيسية.
project(action: "sync", slug: "my-app")
code(
action: "analyze_impact",
target: "src/session.rs",
project_slug: "my-app"
)
plan(action: "run", plan_id: "<uuid>")الربط
يجب أن يكون تطبيق سطح المكتب أو الخادم قيد التشغيل. بعدها يسجّل أمر واحد PO في Claude Code، أو تضيف الإدخال يدويًا لأي عميل MCP آخر.
يحتاج الخادم إلى Neo4j وMeilisearch. وNATS اختياري. يتضمن المستودع ملف docker-compose.yml للثلاثة.
orchestrator serve
# needs Neo4j and Meilisearch: docker compose up -dbrew install this-rs/tap/project-orchestratororchestrator serve --port 8080يكتب هذا الأمر إدخال MCP بنمط stdio، مع عنوان هذا الخادم وسرّ المصادقة الخاص به، ويعتمد الأدوات مسبقًا.
orchestrator setup-claude
orchestrator setup-claude --port 8080يضيف setup-claude أيضًا mcp__project-orchestrator__* إلى الأدوات المسموح بها في ~/.claude/settings.json، حتى لا يسألك Claude Code قبل كل استدعاء.
في Claude Code، شغّل /mcp: يجب أن يظهر project-orchestrator في القائمة. ثم اطلب قائمة المشاريع: يستدعي Claude الأداة project(action: "list").
Claude Code
# in Claude Code/mcp# then ask: "List all registered projects"# Claude calls: project(action: "list")mcp_server وكيل خفيف: يتحدث MCP عبر stdio ويمرّر كل استدعاء إلى REST API. ولا يتصل بـ Neo4j بنفسه أبدًا. اضبط PO_AUTH_TOKEN، أو PO_JWT_SECRET ليولّد رمزًا عند بدء التشغيل.
~/.claude/mcp.json
{ "mcpServers": { "project-orchestrator": { "command": "/path/to/mcp_server", "env": { "PO_SERVER_URL": "http://127.0.0.1:8080", "PO_AUTH_TOKEN": "<jwt-session-token>" } } }}يجيب الخادم أيضًا بـ MCP على POST /mcp، خلف المصادقة نفسها المستخدمة في REST API. يُعاد معرّف الجلسة في الترويسة Mcp-Session-Id ويجب إرساله مع كل طلب.
Claude Code
claude mcp add --transport http project-orchestrator http://127.0.0.1:8080/mcp \ --header "Authorization: Bearer <token>"يجيب الخادم أيضًا بـ MCP على POST /mcp، خلف المصادقة نفسها المستخدمة في REST API. يُعاد معرّف الجلسة في الترويسة Mcp-Session-Id ويجب إرساله مع كل طلب.
HTTP
POST /mcpAuthorization: Bearer <token>Content-Type: application/json{"jsonrpc":"2.0","id":1,"method":"tools/list"}جرّب: بدّل بين stdio وClaude Code وطلب HTTP خام، ثم انسخ الكتلة
أدوات MCP
تقبل كل أداة معاملًا اسمه action وتوجّهه إلى عملية واحدة. ابحث بالأداة أو الإجراء أو المعامل، ثم انسخ الاستدعاء كما هو.
33 أداة
Plans with dependency graph, waves, critical path, and the autonomous runner.
التخطيط والتسليم 27 الإجراءات
مثال على الاستدعاء
plan( action: "create", title: "Migrate session store to Redis", priority: 8)plan_idproject_idtitledescriptionpriorityconstraintsstatussearchlimitoffsetsort_bysort_orderpriority_minpriority_maxcwdproject_slugtrigger_idtrigger_typeconfigcooldown_secsrun_idrun_idstask_idparent_session_idcustom_sectionsprovidermodeltask_class
جرّب: ابحث عن أداة، واستعمل مفاتيح الأسهم في القائمة، وافتح الأمثلة وانسخ أي استدعاء
قيم الوسائط مثل <uuid> عناصر نائبة. وأسماء الإجراءات والمعاملات مأخوذة من شيفرة الخادم المصدرية.
البنية
لا تلمس العملاء قواعد البيانات أبدًا. بل تتحدث إلى الخادم، وهو الذي يحلّل الشيفرة ويقدّم API ويبث الأحداث.
اختر مكوّنًا لترى دوره والتدفقات التي تصل إليه، أو تابع استدعاء أداة عبر النظام.
جرّب: مرّر المؤشر على مكوّن أو اختره، أو تابع طلبًا خطوة بخطوة
تحليل الشيفرة
يُحلَّل كل ملف إلى دوال وبُنى وسمات وتعدادات واستيرادات وكتل impl وروابط استدعاء، ثم يُخزَّن في الرسم البياني.
17 لغة
مرّر المؤشر على لغة أو ركّز عليها أو انقر عليها لترى نوع الرموز التي يستخرجها PO منها.
جرّب: مرّر المؤشر على لغة أو انقر عليها
لكل ملف: الدوال والبُنى والسمات والتعدادات والاستيرادات وكتل impl واستدعاءات الدوال مع درجة ثقة.
تُقرأ ملفات JavaScript (.js و.jsx و.mjs و.cjs) بقواعد TypeScript.
واجهة API والأحداث
الخطط والشيفرة والملاحظات وغيرها JSON عادي عبر HTTP. وتُدفع التغييرات عبر WebSockets.
معظم المسارات خلف وسيط المصادقة. وحين لا يُضبط قسم المصادقة تكون API مفتوحة.
| GET | /health | Liveness |
| GET | /api/version | Server version |
| GET | /api/projects | List projects (POST creates) |
| POST | /api/projects/{slug}/sync | Parse a project into the graph |
| GET | /api/plans/{plan_id}/waves | Parallel waves of a plan |
| POST | /api/plans/{plan_id}/run | Start the runner on a plan |
| GET | /api/code/search | Search code |
| GET | /api/code/impact | Impact analysis |
| GET | /api/notes/search | Search notes |
| GET | /api/decisions/search | Search decisions |
| POST | /api/reason | Reasoning over the graph |
| POST | /mcp | MCP over Streamable HTTP |
/ws/events
كل إنشاء وتحديث وحذف وربط وفكّ ربط وتغيير حالة، في حدث JSON واحد. رشّح بمعاملات الاستعلام entity_types وproject_id وlayers.
/ws/chat/{session_id}
محادثة مع المساعد. أرسِل user_message وinterrupt وpermission_response وinput_response وset_permission_mode وset_model (يتغيّر النموذج مباشرةً، أو عند الاستئناف التالي إذا كانت الجلسة خاملة)، واستقبل أحداث المحادثة، وتصلك مُعادةً من last_event بعد إعادة الاتصال.
/ws/run/{run_id}
تدفق واحد لتشغيل خطة: أحداث المشغّل (بدأت مهمة، بدأت دفعة...) وأحداث المحادثة لكل جلسة فرعية.
تُصادق المتصفحات بملف تعريف ارتباط، أو بتذكرة لمرة واحدة من POST /auth/ws-ticket تُمرَّر في المعامل ticket.
الشكل هو الشكل الحقيقي (CrudEvent على /ws/events). والأحداث نفسها مختلقة لهذا التوضيح.
عُرض 10 حدثًا من أصل 10 وصلت
رسالة /ws/events
/ws/events
{ "entity_type": "task", "action": "status_changed", "entity_id": "<uuid>", "payload": { "old_status": "pending", "new_status": "in_progress" }, "timestamp": "2026-10-05T10:00:00Z", "project_id": "<uuid>"}جرّب: صفِّ حسب النوع، وأوقِف التدفق مؤقتًا، واختر حدثًا لترى رسالته
التوسعة
الطرق الثلاث متاحة عبر أدوات MCP نفسها.
عرّف آلة حالات منتهية بحالات وانتقالات، وابدأ تشغيلًا، ودع المساعدين يقدّمونه عبر أداة protocol.
المهارات تجمعات من الملاحظات والشيفرة تنشأ من الاستخدام؛ وتفعّلها أداة skill وتصدّرها وتستورها بين المشاريع والنسخ.
يربط mcp_federation خوادم MCP خارجية عبر stdio أو sse أو streamable_http، فتصبح أدواتها في متناول PO.
ساهم
Project Orchestrator مشروع مفتوح المصدر. تُفتح الأفكار وتقارير الأخطاء كلتاهما كـissue على GitHub، حيث يستطيع أي شخص قراءتها.
صِف المشكلة التي تريد حلّها، وما تفعله اليوم للالتفاف عليها. المشكلة الواضحة أسهل في النقاش من حلّ جاهز.
تُفتح كـissue عامة على GitHub، حيث يستطيع المشرفون والمستخدمون الآخرون قراءتها والإضافة إليها.
أخبرنا بما فعلته، وما كنت تتوقعه، وما حدث بدلًا منه. كلما كانت الخطوات أدق، كان إعادة إنتاج المشكلة أسهل.
تُفتح كـissue عامة على GitHub، حيث يستطيع المشرفون والمستخدمون الآخرون قراءتها والإضافة إليها.