Cloud Çalışma Alanları ve Aracılar

Bir Cloud çalışma alanı yerel bir cmux çalışma alanı gibi çalışır, ancak terminalleri bir bulut makinesinde çalışır. Bu sayfa kalıcı terminalleri, aracı çalıştırmayı, bildirimleri ve her makinede kurulu araçları kapsar.

Kalıcı terminaller

Terminaller Mac'inizde değil, makinenin arka plan hizmetinde yaşar. Bir bölmeyi kapattığınızda, cmux'tan çıktığınızda, Wi-Fi bağlantınız koptuğunda veya dizüstü bilgisayarınızı kapattığınızda çalışmaya devam ederler. Makineyi oturum açılmış herhangi bir Mac'ten yeniden açtığınızda terminalin çıktısı ve çalışan işlemi hâlâ oradadır.

Bağlantı koparsa bölme, Reconnect düğmesiyle birlikte Cloud session disconnected gösterir ve cmux kendiliğinden yeniden dener.

Makinenin arka plan hizmeti yeniden başlarsa cmux çalışma alanı yerleşimini geri yükler, ancak çalışmakta olan işlemler yeniden başlatmadan sonra devam etmez.

Bir çalışma alanını kapatmak, terminallerini ayrılmış olarak çalışır durumda tutar. Bir çalışma alanını kaldırmak ise terminallerini durdurur.

Kodlama aracılarını çalıştırma

Claude Code, Codex, OpenCode ve Pi her makinede kuruludur. Bir Cloud çalışma alanı açın ve aracıyı yerelde olduğu gibi başlatın. Aracı kancaları önceden ayarlanmıştır, bu nedenle aracı durumu ve bildirimler Mac'inize ulaşır.

cmux vm agent, Mac'inizden bir makinede aracı başlatır. Bir istemle birlikte kullanıldığında aracının tek seferlik modunu kullanır. Önce geçerli dizini yüklemek için --sync, sonucu beklemek için --wait ekleyin.

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, yerel aracınız için bir cmux Cloud yeteneği kurar ve ona Cloud makinelerini kullanmayı öğreten bir istem yazdırır.

cmux vm prompt --open claude

Komut çalıştırma

cmux vm run bir makinede komut çalıştırır ve çıkış kodunu döndürür. Bir dizinden yapılan ilk çalıştırma bir makine seçer ve bunu o dizin için 14 gün boyunca hatırlar. Önce dizini yüklemek için --sync, bir sonucu indirmek için --pull ekleyin.

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

cmux vm exec terminal olmadan kısa bir komut çalıştırır. Hızlı kontroller içindir. Zaman aşımı varsayılan olarak 30 saniye, en fazla 5 dakikadır. Uzun işler için cmux vm run, cmux vm agent veya bir çalışma alanı terminali kullanın.

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

Geliştirme sunucusu başlatma

cmux vm dev bir projeyi yükler, nasıl başlatılacağını bulur ve sunucu ile tarayıcının bulunduğu bir çalışma alanında açar. package.json projelerini, Cargo, Go, Makefile dev hedeflerini, Django, uv, pyproject, requirements.txt ve statik index.html sitelerini algılar. Önce planı görmek için --dry-run kullanın.

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

Bildirimler

Bir makine içindeki cmux notify, o terminal için Mac'inizde bir bildirim gösterir. Aracı kancaları, bir aracı işini bitirdiğinde, onay beklediğinde, soru sorduğunda veya başarısız olduğunda bildirim gönderir. Başlıklar 128 bayt, gövdeler 1 KB ile sınırlıdır ve art arda gelen bildirimler hız sınırına tabidir.

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

Görüntü yapıştırma

Panoda bir görüntü varken bir Cloud terminalinde ⌘V'ye basın. cmux görüntüyü makineye yükler ve uzak yolu yapıştırır, böylece Claude Code ve Codex onu okuyabilir. PNG, JPEG, GIF ve WebP desteklenir; her biri en fazla 20 MB ve tek seferde en fazla 8 görüntü.

CLI'dan yerleşimler ve terminaller

cmux vm workspace bir makinedeki çalışma alanlarını oluşturur, açar, yeniden adlandırır, kapatır ve kaldırır. cmux vm terminal metin gönderir, çıktı okur ve bir metni veya çıkışı bekler. cmux vm tree makinenin çalışma alanlarını ve terminallerini gösterir. cmux vm layout export ve apply, cmux new-workspace --layout ile aynı JSON'u kullanır.

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

Neler kurulu

Makineler Ubuntu 24.04 çalıştırır. root olarak değil, parolasız sudo yetkisine sahip cmux kullanıcısı olarak çalışırsınız. Docker açılışta başlar.

• Diller ve araçlar: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, derleme araçları, vim, nano ve rsync.
• Tarayıcı ve masaüstü: Chrome, agent-browser, bir VNC masaüstü ve Ghostty.
• Aracılar: Claude Code, Codex, OpenCode ve Pi. Test edilmiş sürümlere sabitlenmişlerdir ve makine görüntüsü güncellendiğinde güncellenirler.

Bir makine oluşturduktan hemen sonra bir aracı komutu bulunamazsa kurulum hâlâ devam ediyordur. Kurulum günlüğü /tmp/cmux/provision.log konumundadır.

Model erişimi

Bir makinedeki aracılar, makinede bir anahtar olmadan cmux'un model yönlendirmesini kullanabilir. Gerçek kimlik bilgisi makinenin dışında eklenir, bu nedenle VM'de hiçbir hesap belirteci saklanmaz. Ayrıca makine içinde bir aracıda oturum açabilir veya cmux ai-accounts upload ile ekibiniz için hesap yükleyebilirsiniz.

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

CodeRouter belgeleri: desteklenen hesaplar, paylaşım ve kullanım

Makine içindeki cmux CLI

Bir makinenin içinde cmux komutu o makinenin oturumunu kontrol eder. tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url ve self komutlarını destekler. cmux self sahibi, makineyi ve diğer makinelerinizi gösterir. cmux vm verb peer, bir makinenin içinden diğer makinelerinizi kontrol eder.

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

Oturum açma, AI hesabı yükleme ve new, delete, checkpoint, fork, resize, pause, domains, open ve vpn gibi makine yaşam döngüsü komutları yalnızca Mac'inizde çalışır.

iPhone

cmux iOS uygulaması Cloud makinelerini yönetmez. Başlatılmakta olan bir makine yer tutucu bir kart olarak görünür.