Obszary robocze i agenci w Cloud

Obszar roboczy Cloud działa jak lokalny obszar roboczy cmux, ale jego terminale działają na maszynie w chmurze. Ta strona opisuje trwałe terminale, uruchamianie agentów, powiadomienia i narzędzia zainstalowane na każdej maszynie.

Trwałe terminale

Terminale działają w demonie maszyny, a nie na Twoim Macu. Działają dalej, gdy zamkniesz panel, zakończysz cmux, stracisz Wi-Fi lub zamkniesz laptopa. Otwórz maszynę ponownie z dowolnego zalogowanego Maca, a terminal nadal będzie miał swoje dane wyjściowe i działający proces.

Jeśli połączenie zostanie przerwane, panel pokazuje Cloud session disconnected z przyciskiem Reconnect, a cmux samodzielnie ponawia próby.

Jeśli demon maszyny się zrestartuje, cmux przywróci układ obszaru roboczego, ale procesy, które działały, nie przetrwają restartu.

Zamknięcie obszaru roboczego pozostawia jego terminale uruchomione w stanie odłączonym. Usunięcie obszaru roboczego zatrzymuje jego terminale.

Uruchamianie agentów kodujących

Claude Code, Codex, OpenCode i Pi są zainstalowane na każdej maszynie. Otwórz obszar roboczy Cloud i uruchom agenta tak jak lokalnie. Hooki agentów są już skonfigurowane, więc stan agentów i powiadomienia docierają na Twojego Maca.

cmux vm agent uruchamia agenta na maszynie z poziomu Twojego Maca. Z promptem używa jednorazowego trybu agenta. Dodaj --sync, aby najpierw przesłać bieżący katalog, oraz --wait, aby poczekać na wynik.

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 instaluje umiejętność cmux Cloud dla Twojego lokalnego agenta i wypisuje prompt, który uczy go korzystać z maszyn Cloud.

cmux vm prompt --open claude

Uruchamianie poleceń

cmux vm run uruchamia polecenie na maszynie i zwraca jego kod wyjścia. Pierwsze uruchomienie z danego katalogu wybiera maszynę i zapamiętuje ją dla tego katalogu na 14 dni. Dodaj --sync, aby najpierw przesłać katalog, oraz --pull, aby pobrać wynik.

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

cmux vm exec uruchamia krótkie polecenie bez terminala. Służy do szybkich sprawdzeń. Domyślny limit czasu to 30 sekund, a maksymalny to 5 minut. Do dłuższej pracy użyj cmux vm run, cmux vm agent lub terminala w obszarze roboczym.

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

Uruchamianie serwera deweloperskiego

cmux vm dev przesyła projekt, ustala, jak go uruchomić, i otwiera go w obszarze roboczym z serwerem i przeglądarką. Wykrywa projekty z package.json, Cargo, Go, cele dev w Makefile, Django, uv, pyproject, requirements.txt oraz statyczne strony z index.html. Użyj --dry-run, aby najpierw zobaczyć plan.

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

Powiadomienia

cmux notify uruchomione na maszynie wyświetla na Twoim Macu powiadomienie dla tego terminala. Hooki agentów wysyłają powiadomienia, gdy agent kończy pracę, potrzebuje zatwierdzenia, zadaje pytanie lub napotyka błąd. Tytuły są ograniczone do 128 bajtów, treść do 1 KB, a serie powiadomień podlegają limitowi częstotliwości.

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

Wklejanie obrazów

Naciśnij ⌘V z obrazem w schowku w terminalu Cloud. cmux przesyła obraz na maszynę i wkleja zdalną ścieżkę, dzięki czemu Claude Code i Codex mogą go odczytać. Obsługiwane są formaty PNG, JPEG, GIF i WebP, do 20 MB każdy i do 8 obrazów naraz.

Układy i terminale z poziomu CLI

cmux vm workspace tworzy, otwiera, zmienia nazwy, zamyka i usuwa obszary robocze na maszynie. cmux vm terminal wysyła tekst, odczytuje dane wyjściowe i czeka na tekst lub zakończenie. cmux vm tree pokazuje obszary robocze i terminale maszyny. cmux vm layout export i apply używają tego samego JSON co 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

Zainstalowane oprogramowanie

Maszyny działają na Ubuntu 24.04. Pracujesz jako użytkownik cmux z sudo bez hasła, a nie jako root. Docker uruchamia się podczas startu systemu.

• Języki i narzędzia: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, narzędzia do kompilacji, vim, nano i rsync.
• Przeglądarka i pulpit: Chrome, agent-browser, pulpit VNC i Ghostty.
• Agenci: Claude Code, Codex, OpenCode i Pi. Są przypięci do przetestowanych wersji i aktualizują się, gdy aktualizowany jest obraz maszyny.

Jeśli polecenie agenta nie zostanie znalezione zaraz po utworzeniu maszyny, konfiguracja wciąż trwa. Dziennik konfiguracji znajduje się w /tmp/cmux/provision.log.

Dostęp do modeli

Agenci na maszynie mogą korzystać z routingu modeli cmux bez klucza na maszynie. Prawdziwe dane uwierzytelniające są dodawane poza maszyną, więc w VM nie jest przechowywany żaden token konta. Możesz też zalogować się do agenta na maszynie lub przesłać konta dla swojego zespołu za pomocą cmux ai-accounts upload.

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

Dokumentacja CodeRouter: obsługiwane konta, udostępnianie i zużycie

CLI cmux wewnątrz maszyny

Wewnątrz maszyny polecenie cmux steruje sesją tej maszyny. Obsługuje tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url i self. cmux self pokazuje właściciela, maszynę i Twoje pozostałe maszyny. cmux vm verb peer steruje Twoimi pozostałymi maszynami z wnętrza maszyny.

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

Logowanie, przesyłanie kont AI i polecenia cyklu życia maszyny, takie jak new, delete, checkpoint, fork, resize, pause, domains, open i vpn, działają tylko na Twoim Macu.

iPhone

Aplikacja cmux na iOS nie zarządza maszynami Cloud. Maszyna, która się uruchamia, jest wyświetlana jako karta zastępcza.