# البدء

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

## التثبيت

### DMG (موصى به)

[تحميل لنظام Mac](https://cmux.com/ar/download/confirmation?dl=1)

افتح ملف .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](https://cmux.com/ar/docs/session-restore) for agent hook setup and the supported resume matrix.

## المتطلبات

-   macOS 14.0 أو أحدث
-   Mac بمعالج Apple Silicon أو Intel

Canonical: https://cmux.com/ar/docs/getting-started

Documentation index: https://cmux.com/llms.txt