Modo

IDE ذكي مفتوح المصدر يخطط قبل أن يكتب الشيفرة.

MIT License · بداية سريعة · ما يضيفه Modo · المساهمة

أردت ميزة صغيرة في أداة برمجة ذكية. لم أجد طريقة لاقتراحها. فسألت نفسي: ما مدى صعوبة بناء شيء مثل Kiro أو Cursor أو Windsurf؟

اتضح — ليس بالصعوبة التي تظنها. بدءًا من محرر Void (وهو بدوره فرع من VS Code)، وصلت إلى حوالي 60–70% مما تقدمه تلك الأدوات في فترة قصيرة من البناء. كان الأمر ممتعًا حقًا.

هذا هو Modo. IDE سطح مكتب مستقل حيث تتحول الأوامر إلى خطط منظمة قبل أن تتحول إلى شيفرة. مفتوح المصدر، مرخص بموجب MIT، يمكنك التعديل عليه.

ما يضيفه Modo

كل ما يلي بُني فوق الدردشة الذكية الموجودة في Void، والتحرير المضمن (Cmd+K)، والإكمال التلقائي، ودعم مزودي LLM المتعددين، واستخدام الأدوات، وتكامل MCP. إليك ما هو جديد:

التطوير الموجه بالمواصفات

معظم أدوات الذكاء الاصطناعي تذهب: أمر → شيفرة. Modo يذهب: أمر → متطلبات → تصميم → مهام → شيفرة.

المواصفات موجودة في .modo/specs/<name>/ كثلاثة ملفات Markdown:

.modo/specs/auth-flow/
├── requirements.md     # قصص المستخدمين، معايير القبول
├── design.md           # الهندسة، المكونات، نماذج البيانات
└── tasks.md            # قائمة مرجعية لخطوات التنفيذ

أنشئ واحدة باستخدام Cmd+Shift+S أو باختيار وضع Spec في منتقي الجلسات. اختر ميزة أو إصلاح عطل، ثم سير عمل يعتمد على المتطلبات أولاً أو التصميم أولاً. يقوم الوكيل بملء كل مستند، تراجعه أنت، ثم ينفذ المهام واحدة تلو الأخرى — ويحددها كمكتملة وهو يعمل.

المهام تُحفظ على القرص. أغلق IDE، عد، واستأنف من حيث توقفت.

CodeLens للمهام

افتح أي tasks.md وسيظهر لكل مهمة معلقة زر قابل للنقر "▶ Run Task" ضمنيًا. زر "Run All Pending Tasks" يظهر في الأعلى. المهام الجارية تظهر دائرة تحميل، والمكتملة تظهر علامة صح. الوكيل يحدد - [ ] → - [~] → - [x] أثناء العمل.

ملفات التوجيه

مستندات Markdown في .modo/steering/ تحقن قواعد المشروع في كل تفاعل مع الذكاء الاصطناعي — دون حاجة لتكرار نفسك.

---
inclusion: always
---
# قواعد المشروع
- استخدم TypeScript strict mode
- جميع النقاط النهائية تحتاج التحقق من الإدخال

ثلاثة أنماط للإدراج:

• always — كل تفاعل
• fileMatch — عندما يتطابق الملف النشط مع نمط glob
• manual — يُشار إليه عبر أوامر / في الدردشة

يدعم مراجع #[[file:path]] لربط مواصفات OpenAPI أو مخططات GraphQL أو أي مستند مشروع.

هوك الوكيل (Agent Hooks)

إعدادات JSON في .modo/hooks/ تؤتمت الإجراءات حول دورة حياة الوكيل.

{
  "name": "Lint on Save",
  "version": "1.0.0",
  "when": { "type": "fileEdited", "patterns": ["**/*.ts"] },
  "then": { "type": "runCommand", "command": "npx eslint --fix ${filePath}" }
}

10 أنواع أحداث: fileEdited, fileCreated, fileDeleted, promptSubmit, agentStop, preToolUse, postToolUse, preTaskExecution, postTaskExecution, userTriggered. نوعان من الإجراءات: askAgent أو runCommand. هوك ما قبل الأداة يمكنه منع التنفيذ. كشف التبعيات الدائرية مدمج.

تبديل الطيار الآلي / الخاضع للإشراف

قرص في شريط الحالة يبدل بين Autopilot (الوكيل يعمل بشكل مستقل) و Supervised (الوكيل يتوقف للموافقة). موصول مباشرة بإعدادات الموافقة التلقائية للتعديلات والأوامر الطرفية وأدوات MCP.

جلسات دردشة متوازية

جلسات دردشة متعددة كعلامات تبويب. لكل منها مسارها الخاص، وسياقها، وتاريخها. افتح جديدة، وأغلق القديمة، أو شغلها جميعًا مرة واحدة. لوحة تاريخ قابلة للبحث تسمح بالعثور على المحادثات السابقة.

وضعي Vibe و Spec

ابدأ جلسة في وضع Vibe للاستكشاف الحر، أو وضع Spec للتطوير المنظم. في وضع Spec، يؤدي أمرك إلى تشغيل سير عمل كامل: المتطلبات → التصميم → المهام. يتم حقن محتوى المواصفات النشط تلقائيًا في موجه النظام للـ LLM.

الوكلاء الفرعيون (Subagents)

أطلق وكلاء متوازيين لمهام فرعية مستقلة. لكل منها مساره الخاص ووصول للأدوات. تتبع الحالة، ألغ المهام الجارية، أو امسح المكتملة.

القوى (Powers)

حزم معرفة قابلة للتثبيت تجمع توثيقًا وملفات توجيه وإعدادات MCP. قوى مدمجة لـ TypeScript و React و Testing و API Design و Docker. تُفعَّل بناءً على كلمات مفتاحية في أوامرك. ثبّت قوى مخصصة من روابط URL.

لوحة المستكشف المخصصة

شريط جانبي بأقسام قابلة للطي لـ Specs (مع أشرطة تقدم وأعداد المهام)، و Agent Hooks (تظهر تدفق الحدث → الإجراء)، و Steering (تظهر وضع الإدراج)، و Powers.

أوامر الشرطة المائلة (Slash Commands)

اكتب / في الدردشة للوصول إلى الهوك اليدوي، وملفات التوجيه، والأوامر المدمجة: إنشاء مواصفات، تشغيل المهام، تصدير المحادثة، تهيئة مساحة العمل.

حقن السياق

يتم إدراج ملفات التوجيه والمواصفات النشطة تلقائيًا في بداية كل تفاعل مع LLM. يتبع الوكيل قواعد مشروعك ويعرف ما يبنيه دون الحاجة لإخباره في كل مرة.

سمة داكنة مخصصة

سمة "Modo Dark" مصممة خصيصًا مع لمسات زرقاء مخضرة، وإبراز نحوي مضبوط، وألوان طرفية.

شخصية مصاحبة

يظهر رمز Modo قبل كل رد مع تعابير عشوائية أثناء التدفق وتعبير هادئ بعد الإكمال.

إعادة تسمية كاملة

أيقونة تطبيق مخصصة، عنوان نافذة، شعار علامة مائية، هوية المنتج، بروتوكول URL (modo://)، وأدلة البيانات (.modo-editor/). تم استبدال جميع إشارات Void في الواجهة بمكافئات Modo.

تهيئة مساحة العمل

Modo: Initialize Workspace ينشئ هيكل الدليل .modo/ بالكامل مع ملفات توجيه افتراضية وقوالب إعدادات.

التصدير

تصدير أي محادثة كـ Markdown إلى الحافظة من لوحة الأوامر.

مبني على

لن يكون Modo موجودًا بدون هذه المشاريع:

Void نفسه يوفر: دعم مزودين متعددين (Anthropic, OpenAI, Gemini, Ollama, Mistral, Groq, OpenRouter)، شريط دردشة جانبي، تحرير مضمن عبر Cmd+K، إكمال تلقائي، تطبيق سريع/بطيء، استدعاء أدوات، تكامل MCP، تكامل SCM، ونظام الإعدادات.

Modo يضيف كل ما في قسم ما يضيفه Modo فوق هذه الأساسيات.

بداية سريعة

git clone https://github.com/mohshomis/modo.git
cd modo
npm install          # يتطلب Node 20
npm run buildreact   # تجميع واجهة React
npm run watch        # تجميع TypeScript (استمر في التشغيل في طرفية)
./scripts/code.sh    # تشغيل Modo

في أول تشغيل، إرشادات البدء ترشدك لتوصيل مزود نموذج. الطبقة المجانية من Gemini هي أسرع طريقة للبدء.

هيكل المشروع

.modo/                          # إعدادات لكل مشروع (يتم إنشاؤها بواسطة "Initialize Workspace")
├── steering/                   # قواعد markdown تُحقن في سياق الذكاء الاصطناعي
├── specs/                      # سير عمل منظم للميزات/إصلاح الأخطاء
├── hooks/                      # أتمتة أحداث JSON → إجراء
└── settings/                   # إعدادات MCP وغيرها

src/vs/workbench/contrib/void/
├── common/
│   ├── modoSpecService.ts      # CRUD للمواصفات، تحليل المهام، بناء السياق
│   ├── modoSteeringService.ts  # تحميل ملفات التوجيه، تحليل front-matter، تجميع السياق
│   ├── modoHookService.ts      # تحميل الهوك، التحقق، مطابقة الأحداث، الإطلاق
│   ├── modoPowersService.ts    # سجل القوى، التفعيل، مطابقة الكلمات المفتاحية
│   └── modoSubagentService.ts  # إطلاق وكلاء متوازيين وإدارة دورة الحياة
├── browser/
│   ├── modoExplorerPane.ts     # عروض الشريط الجانبي للمواصفات، الهوك، التوجيه، القوى
│   ├── modoSpecActions.ts      # أوامر إنشاء مواصفات، تشغيل مهام، فتح ملفات
│   ├── modoTaskCodeLens.ts     # أزرار "Run Task / Done" المضمنة في tasks.md
│   ├── modoSlashCommands.ts    # منتقي أوامر /، تصدير، إدارة الجلسات
│   ├── modoStatusBar.ts        # تبديل الطيار الآلي، مؤشر المواصفات النشطة
│   ├── modoHookWiring.ts       # أحداث تغيير الملف → نظام الهوك
│   └── react/src/
│       ├── sidebar-tsx/         # علامات تبويب الجلسات، التاريخ، وضعي vibe/spec، مفتاح الطيار الآلي
│       ├── modo-spec-panel/     # واجهة React لإدارة المواصفات
│       └── modo-hooks-panel/    # واجهة React لإدارة الهوك
└── extensions/
    └── modo-theme/              # سمة داكنة مخصصة مع لمسات زرقاء مخضرة

الأوامر

المساهمة

هذا المشروع يُصان بواسطة المجتمع. بنيته كتجربة تعليمية — لا أُصونه بفاعلية وفق جدول. إذا كنت تريد إصلاح شيء أو إضافة شيء، أفضل طريق هو تفريع المشروع (fork) وتقديم طلب سحب (PR).

npm run watch        # تجميع TypeScript (استمر في التشغيل)
npm run buildreact   # واجهة React (شغّل بعد تغيير ملفات .tsx)
./scripts/code.sh    # تشغيل IDE

الخدمات الأساسية: src/vs/workbench/contrib/void/common/. المنطق في جانب المتصفح: browser/. مكونات React: browser/react/src/.

المساهمون الجادون الذين يريدون صلاحية الالتزام (commit access) — افتح مشكلة (issue). انظر CONTRIBUTING.md للتفاصيل.

PRs مرحب بها. مرخصة بموجب MIT.

الترخيص

MIT