الأساسياتالبدء
الأساسيات

البدء

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

التثبيت

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

Homebrew

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

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

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

التحقق من التثبيت

افتح cmux ويجب أن ترى:

  • نافذة طرفية مع شريط تبويب عمودي على اليسار
  • مساحة عمل أولية مفتوحة بالفعل
  • طرفية Ghostty جاهزة للإدخال

إعداد واجهة الأوامر

يتضمن cmux أداة سطر أوامر للأتمتة. داخل طرفيات cmux تعمل تلقائياً. لاستخدامها من طرفيات أخرى، افتح لوحة الأوامر (⌘⇧P) وشغّل أمر الصدفة: تثبيت 'cmux' في PATH. يربط هذا الأمر واجهة الأوامر المضمّنة في /usr/local/bin ويطلب كلمة مرور المسؤول إذا احتاج المجلد إليها.

أو أنشئ الرابط الرمزي بنفسك:

sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux

ثم يمكنك تشغيل أوامر مثل:

cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"

اجعل cmux طرفيتك الافتراضية

لفتح روابط ssh:// ونصوص الصدفة من Finder في cmux بدلاً من Terminal، اختر cmux > جعل cmux الطرفية الافتراضية من شريط القوائم، أو شغّل جعل cmux الطرفية الافتراضية من لوحة الأوامر.

التحديثات التلقائية

يتحقق cmux من التحديثات تلقائياً عبر Sparkle. عندما يتوفر تحديث سترى مؤشر تحديث في شريط العنوان. يمكنك أيضاً التحقق يدوياً عبر cmux > التحقق من التحديثات في شريط القوائم.

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

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

cmux لا يستعيد حالة العمليات الحية بعد. جلسات تطبيقات الطرفية النشطة مثل Claude Code وtmux وvim لا تُستأنف بعد إعادة تشغيل التطبيق.

See the session restore guide for agent hook setup and the supported resume matrix.

المتطلبات

  • macOS 14.0 أو أحدث
  • Mac بمعالج Apple Silicon أو Intel
هل كانت هذه الصفحة مفيدة؟
الإبلاغ عن مشكلة