مساحات عمل Cloud والوكلاء

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

الطرفيات الدائمة

تعيش الطرفيات في الخادم الخلفي للجهاز، لا على جهاز Mac. تستمر في العمل عند إغلاق لوح أو إنهاء cmux أو فقدان Wi-Fi أو إغلاق حاسوبك المحمول. افتح الجهاز مجدداً من أي جهاز Mac مسجَّل الدخول وستجد الطرفية لا تزال تحتفظ بمخرجاتها وعمليتها العاملة.

إذا انقطع الاتصال، يعرض اللوح Cloud session disconnected مع زر Reconnect، ويعيد cmux المحاولة تلقائياً.

إذا أُعيد تشغيل الخادم الخلفي للجهاز، يستعيد cmux تخطيط مساحة العمل، لكن العمليات التي كانت تعمل لا تنجو من إعادة التشغيل.

إغلاق مساحة عمل يُبقي طرفياتها تعمل منفصلة. إزالة مساحة عمل توقف طرفياتها.

تشغيل وكلاء البرمجة

Claude Code وCodex وOpenCode وPi مثبتة على كل جهاز. افتح مساحة عمل Cloud وابدأ الوكيل كما تفعل محلياً. خطافات الوكلاء مُعدَّة مسبقاً، لذا تصل حالة الوكيل وإشعاراته إلى جهاز Mac.

يبدأ cmux vm agent وكيلاً على جهاز من جهاز Mac. مع موجّه، يستخدم وضع التنفيذ لمرة واحدة الخاص بالوكيل. أضف --sync لرفع المجلد الحالي أولاً و--wait لانتظار النتيجة.

cmux vm agent --agent claude --machine brave-otter -- "add tests for the parser"
cmux vm agent --agent codex --machine brave-otter --sync --wait -- "fix the build"
cmux vm agent --agent opencode --new --size 16g -- "profile the importer"

يثبّت cmux vm prompt مهارة cmux Cloud لوكيلك المحلي ويطبع موجّهاً يعلّمه استخدام أجهزة Cloud.

cmux vm prompt --open claude

تشغيل الأوامر

يشغّل cmux vm run أمراً على جهاز ويعيد رمز الخروج الخاص به. أول تشغيل من مجلد يختار جهازاً ويتذكره لذلك المجلد لمدة 14 يوماً. أضف --sync لرفع المجلد أولاً و--pull لتنزيل نتيجة.

cmux vm run -- npm test
cmux vm run --sync --pull dist -- npm run build
cmux vm route --json

يشغّل cmux vm exec أمراً قصيراً دون طرفية. وهو مخصص للفحوص السريعة. مهلته 30 ثانية افتراضياً و5 دقائق كحد أقصى. استخدم cmux vm run أو cmux vm agent أو طرفية مساحة عمل للأعمال الطويلة.

cmux vm exec brave-otter -- uname -a
cmux vm exec --timeout 120 brave-otter -- docker ps

تشغيل خادم تطوير

يرفع cmux vm dev مشروعاً، ويكتشف طريقة تشغيله، ويفتحه في مساحة عمل مع الخادم ومتصفح. يكتشف مشاريع package.json وCargo وGo وأهداف dev في Makefile وDjango وuv وpyproject وrequirements.txt والمواقع الثابتة ذات index.html. استخدم --dry-run لرؤية الخطة أولاً.

cmux vm dev brave-otter --dry-run
cmux vm dev brave-otter . --port 3000

الإشعارات

يعرض cmux notify داخل جهاز إشعاراً على جهاز Mac لتلك الطرفية. ترسل خطافات الوكلاء إشعارات عندما ينتهي الوكيل أو يحتاج إلى موافقة أو يطرح سؤالاً أو يفشل. تقتصر العناوين على 128 بايت والنصوص على 1 KB، وتُقيَّد الدفعات المتتالية.

# Inside a Cloud machine
cmux notify --title "Build" --body "Tests passed"

لصق الصور

اضغط ⌘V وفي الحافظة صورة داخل طرفية Cloud. يرفع cmux الصورة إلى الجهاز ويلصق المسار البعيد، فيستطيع Claude Code وCodex قراءتها. الصيغ المدعومة هي PNG وJPEG وGIF وWebP، بحد أقصى 20 MB لكل صورة و8 صور في المرة الواحدة.

التخطيطات والطرفيات من CLI

ينشئ cmux vm workspace مساحات العمل على جهاز ويفتحها ويعيد تسميتها ويغلقها ويزيلها. يرسل cmux vm terminal نصاً ويقرأ المخرجات وينتظر نصاً أو الخروج. يعرض cmux vm tree مساحات عمل الجهاز وطرفياته. يستخدم cmux vm layout export وapply صيغة JSON نفسها التي يستخدمها cmux new-workspace --layout.

cmux vm tree brave-otter
cmux vm workspace new brave-otter --name review
cmux vm terminal send brave-otter term_2f9c "npm run dev" --keys enter
cmux vm terminal wait brave-otter term_2f9c --pattern "ready" --timeout 60
cmux vm terminal read brave-otter term_2f9c
cmux vm layout export brave-otter review > layout.json
cmux vm layout apply brave-otter layout.json --open

ما هو مثبَّت

تعمل الأجهزة بنظام Ubuntu 24.04. تعمل بصفة المستخدم cmux مع sudo دون كلمة مرور، وليس بصفة root. يبدأ Docker عند الإقلاع.

• اللغات والأدوات: Node.js LTS وBun وPython 3.12 وuv وDocker وgit وGitHub CLI وripgrep وfd وfzf وjq وtmux وsqlite3 وأدوات البناء وvim وnano وrsync.
• المتصفح وسطح المكتب: Chrome وagent-browser وسطح مكتب VNC وGhostty.
• الوكلاء: Claude Code وCodex وOpenCode وPi. هي مثبتة على إصدارات مختبرة وتتحدث عند تحديث صورة الجهاز.

إذا لم يُعثر على أمر وكيل مباشرة بعد إنشاء جهاز، فالإعداد لا يزال جارياً. سجل الإعداد موجود في /tmp/cmux/provision.log.

الوصول إلى النماذج

يمكن للوكلاء على الجهاز استخدام توجيه النماذج في cmux دون مفتاح على الجهاز. تُضاف بيانات الاعتماد الحقيقية خارج الجهاز، فلا يُخزَّن أي رمز حساب داخل الآلة الافتراضية. يمكنك أيضاً تسجيل الدخول إلى وكيل داخل الجهاز، أو رفع حسابات لفريقك باستخدام cmux ai-accounts upload.

cmux ai-accounts list
cmux ai-accounts upload claude
cmux coderouter status

وثائق CodeRouter: الحسابات المدعومة والمشاركة والاستخدام

أداة cmux CLI داخل الجهاز

داخل الجهاز، يتحكم الأمر cmux في جلسة ذلك الجهاز. وهو يدعم tree وnew-workspace وnew-split وsend وsend-key وread-screen وterminal وlayout وenv وnotify وopen-url وself. يعرض cmux self المالك والجهاز وأجهزتك الأخرى. يتحكم cmux vm verb peer في أجهزتك الأخرى من داخل جهاز.

# Inside a Cloud machine
cmux tree
cmux new-split right
cmux self peers
cmux vm exec calm-heron -- git status

تعمل أوامر تسجيل الدخول ورفع حسابات الذكاء الاصطناعي ودورة حياة الجهاز مثل new وdelete وcheckpoint وfork وresize وpause وdomains وopen وvpn على جهاز Mac فقط.

iPhone

لا يدير تطبيق cmux لنظام iOS أجهزة Cloud. يظهر الجهاز الذي قيد البدء كبطاقة مؤقتة.