Back to Cmux

README.Ar

README.ar.md

1.38.115.0 KB
Original Source

تمت هذه الترجمة بواسطة Claude. إذا كانت لديك اقتراحات للتحسين، يرجى فتح PR.

<h1 align="center">cmux</h1> <p align="center">تطبيق طرفية لنظام macOS مبني على Ghostty مع علامات تبويب عمودية وإشعارات لوكلاء البرمجة بالذكاء الاصطناعي</p> <p align="center"> <a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg"> </a> </p> <p align="center"> <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.it.md">Italiano</a> | <a href="README.da.md">Dansk</a> | <a href="README.pl.md">Polski</a> | <a href="README.ru.md">Русский</a> | <a href="README.bs.md">Bosanski</a> | العربية | <a href="README.no.md">Norsk</a> | <a href="README.pt-BR.md">Português (Brasil)</a> | <a href="README.th.md">ไทย</a> | <a href="README.tr.md">Türkçe</a> | <a href="README.km.md">ភាសាខ្មែរ</a> </p> <p align="center"> <a href="https://x.com/manaflowai"></a> <a href="https://discord.gg/xsgFEVrWCZ"></a> </p> <p align="center"> </p> <p align="center"> <a href="https://www.youtube.com/watch?v=i-WxO5YUTOs">▶ فيديو توضيحي</a> · <a href="https://cmux.com/blog/zen-of-cmux">فلسفة cmux</a> </p>

الميزات

<table> <tr> <td width="40%" valign="middle"> <h3>حلقات الإشعارات</h3> تحصل الأجزاء على حلقة زرقاء وتضيء علامات التبويب عندما يحتاج وكلاء البرمجة انتباهك </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>لوحة الإشعارات</h3> عرض جميع الإشعارات المعلقة في مكان واحد، والانتقال إلى أحدث إشعار غير مقروء </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>متصفح مدمج</h3> قسّم متصفحًا بجانب الطرفية مع API قابل للبرمجة مأخوذ من <a href="https://github.com/vercel-labs/agent-browser">agent-browser</a> </td> <td width="60%"> </td> </tr> <tr> <td width="40%" valign="middle"> <h3>علامات تبويب عمودية + أفقية</h3> يعرض الشريط الجانبي فرع git وحالة/رقم طلب السحب المرتبط ومجلد العمل والمنافذ المستمعة وآخر نص إشعار. تقسيم أفقي وعمودي. </td> <td width="60%"> </td> </tr> </table>
  • قابل للبرمجة — CLI وsocket API لإنشاء مساحات العمل وتقسيم الأجزاء وإرسال ضغطات المفاتيح وأتمتة المتصفح
  • تطبيق macOS أصلي — مبني بـ Swift وAppKit، وليس Electron. بدء تشغيل سريع واستهلاك ذاكرة منخفض.
  • متوافق مع Ghostty — يقرأ إعداداتك الحالية من ~/.config/ghostty/config للسمات والخطوط والألوان
  • تسريع GPU — مدعوم بـ libghostty لعرض سلس

التثبيت

DMG (مستحسن)

<a href="https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg"> </a>

افتح ملف .dmg واسحب cmux إلى مجلد التطبيقات. يتم تحديث cmux تلقائيًا عبر Sparkle، لذا تحتاج للتحميل مرة واحدة فقط.

Homebrew

bash
brew tap manaflow-ai/cmux
brew install --cask cmux

للتحديث لاحقًا:

bash
brew upgrade --cask cmux

عند التشغيل الأول، قد يطلب منك macOS تأكيد فتح تطبيق من مطور معروف. انقر فتح للمتابعة.

لماذا cmux؟

أقوم بتشغيل الكثير من جلسات Claude Code وCodex بالتوازي. كنت أستخدم Ghostty مع مجموعة من الأجزاء المقسمة، وأعتمد على إشعارات macOS الأصلية لمعرفة متى يحتاجني وكيل ما. لكن نص إشعار Claude Code يكون دائمًا مجرد "Claude is waiting for your input" بدون أي سياق، ومع فتح عدد كافٍ من علامات التبويب لم أعد قادرًا حتى على قراءة العناوين.

جربت بعض منظمات البرمجة لكن معظمها كانت تطبيقات Electron/Tauri وأداؤها كان يزعجني. كما أنني أفضل الطرفية لأن منظمات GUI تحبسك في سير عملها. لذا بنيت cmux كتطبيق macOS أصلي بـ Swift/AppKit. يستخدم libghostty لعرض الطرفية ويقرأ إعدادات Ghostty الحالية للسمات والخطوط والألوان.

الإضافات الرئيسية هي الشريط الجانبي ونظام الإشعارات. يحتوي الشريط الجانبي على علامات تبويب عمودية تعرض فرع git وحالة/رقم طلب السحب المرتبط ومجلد العمل والمنافذ المستمعة وآخر نص إشعار لكل مساحة عمل. يلتقط نظام الإشعارات تسلسلات الطرفية (OSC 9/99/777) ولديه CLI (cmux notify) يمكنك ربطه بخطافات الوكلاء لـ Claude Code وOpenCode وغيرها. عندما ينتظر وكيل ما، يحصل جزؤه على حلقة زرقاء وتضيء علامة التبويب في الشريط الجانبي، حتى أتمكن من معرفة أيها يحتاجني عبر الأقسام وعلامات التبويب. Cmd+Shift+U ينتقل إلى أحدث إشعار غير مقروء.

المتصفح المدمج لديه API قابل للبرمجة مأخوذ من agent-browser. يمكن للوكلاء التقاط شجرة إمكانية الوصول والحصول على مراجع العناصر والنقر وملء النماذج وتنفيذ JS. يمكنك تقسيم جزء متصفح بجانب الطرفية وجعل Claude Code يتفاعل مع خادم التطوير مباشرة.

كل شيء قابل للبرمجة عبر CLI وsocket API — إنشاء مساحات العمل/علامات التبويب، تقسيم الأجزاء، إرسال ضغطات المفاتيح، فتح عناوين URL في المتصفح.

فلسفة cmux

cmux لا يفرض على المطورين طريقة استخدام أدواتهم. إنه طرفية ومتصفح مع واجهة سطر أوامر، والباقي متروك لك.

cmux هو لبنة أساسية وليس حلًا جاهزًا. يمنحك طرفية ومتصفحًا وإشعارات ومساحات عمل وأقسامًا وعلامات تبويب وواجهة سطر أوامر للتحكم في كل ذلك. cmux لا يجبرك على طريقة محددة لاستخدام وكلاء البرمجة. ما تبنيه باستخدام هذه اللبنات الأساسية هو ملكك.

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

أعطِ مليون مطور لبنات أساسية قابلة للتركيب وسيجدون بشكل جماعي أكثر سير العمل كفاءة أسرع مما يمكن لأي فريق منتج تصميمه من الأعلى إلى الأسفل.

التوثيق

لمزيد من المعلومات حول كيفية إعداد cmux، توجه إلى وثائقنا.

اختصارات لوحة المفاتيح

مساحات العمل

الاختصارالإجراء
⌘ Nمساحة عمل جديدة
⌘ 1–8الانتقال إلى مساحة العمل 1–8
⌘ 9الانتقال إلى آخر مساحة عمل
⌃ ⌘ ]مساحة العمل التالية
⌃ ⌘ [مساحة العمل السابقة
⌘ ⇧ Wإغلاق مساحة العمل
⌘ ⇧ Rإعادة تسمية مساحة العمل
⌘ Bتبديل الشريط الجانبي

الأسطح

الاختصارالإجراء
⌘ Tسطح جديد
⌘ ⇧ ]السطح التالي
⌘ ⇧ [السطح السابق
⌃ Tabالسطح التالي
⌃ ⇧ Tabالسطح السابق
⌃ 1–8الانتقال إلى السطح 1–8
⌃ 9الانتقال إلى آخر سطح
⌘ Wإغلاق السطح

الأجزاء المقسمة

الاختصارالإجراء
⌘ Dتقسيم لليمين
⌘ ⇧ Dتقسيم للأسفل
⌥ ⌘ ← → ↑ ↓التركيز على الجزء حسب الاتجاه
⌘ ⇧ Hوميض الجزء المركّز عليه

المتصفح

اختصارات أدوات المطور في المتصفح تتبع إعدادات Safari الافتراضية ويمكن تخصيصها في الإعدادات ← اختصارات لوحة المفاتيح.

الاختصارالإجراء
⌘ ⇧ Lفتح المتصفح في قسم
⌘ Lالتركيز على شريط العنوان
⌘ [للخلف
⌘ ]للأمام
⌘ Rإعادة تحميل الصفحة
⌥ ⌘ Iتبديل أدوات المطور (إعداد Safari الافتراضي)
⌥ ⌘ Cعرض وحدة تحكم JavaScript (إعداد Safari الافتراضي)

الإشعارات

الاختصارالإجراء
⌘ Iعرض لوحة الإشعارات
⌘ ⇧ Uالانتقال إلى أحدث إشعار غير مقروء

البحث

الاختصارالإجراء
⌘ Fبحث
⌘ G / ⌘ ⇧ Gالبحث التالي / السابق
⌘ ⇧ Fإخفاء شريط البحث
⌘ Eاستخدام التحديد للبحث

الطرفية

الاختصارالإجراء
⌘ Kمسح سجل التمرير
⌘ Cنسخ (مع التحديد)
⌘ Vلصق
⌘ + / ⌘ -تكبير / تصغير حجم الخط
⌘ 0إعادة تعيين حجم الخط

النافذة

الاختصارالإجراء
⌘ ⇧ Nنافذة جديدة
⌘ ,الإعدادات
⌘ ⇧ ,إعادة تحميل الإعدادات
⌘ Qإنهاء

الإصدارات الليلية

تحميل cmux NIGHTLY

cmux NIGHTLY هو تطبيق منفصل بمعرّف حزمة خاص به، لذا يعمل بجانب الإصدار المستقر. يُبنى تلقائيًا من أحدث commit على فرع main ويتم تحديثه تلقائيًا عبر Sparkle الخاص به.

استعادة الجلسة (السلوك الحالي)

عند إعادة التشغيل، يستعيد cmux حاليًا تخطيط التطبيق والبيانات الوصفية فقط:

  • تخطيط النوافذ/مساحات العمل/الأجزاء
  • مجلدات العمل
  • سجل تمرير الطرفية (أفضل جهد)
  • عنوان URL للمتصفح وسجل التنقل

cmux لا يستعيد حالة العمليات الحية داخل تطبيقات الطرفية. على سبيل المثال، جلسات Claude Code/tmux/vim النشطة لا يتم استئنافها بعد إعادة التشغيل بعد.

تاريخ النجوم

<a href="https://star-history.com/#manaflow-ai/cmux&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=manaflow-ai/cmux&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=manaflow-ai/cmux&type=Date" /> </picture> </a>

المساهمة

طرق للمشاركة:

المجتمع

إصدار المؤسسين

cmux مجاني ومفتوح المصدر وسيظل كذلك دائمًا. إذا كنت ترغب في دعم التطوير والحصول على وصول مبكر لما هو قادم:

احصل على إصدار المؤسسين

  • أولوية لطلبات الميزات/إصلاح الأخطاء
  • وصول مبكر: ذكاء اصطناعي لـ cmux يمنحك سياقًا عن كل مساحة عمل وعلامة تبويب ولوحة
  • وصول مبكر: تطبيق iOS مع مزامنة الطرفيات بين سطح المكتب والهاتف
  • وصول مبكر: أجهزة افتراضية سحابية
  • وصول مبكر: وضع الصوت
  • iMessage/WhatsApp الشخصي الخاص بي

الرخصة

هذا المشروع مرخص بموجب رخصة GNU Affero العامة الإصدار 3.0 أو أحدث (AGPL-3.0-or-later).

راجع LICENSE للنص الكامل.