Cloud-arbejdsområder og agenter

Et Cloud-arbejdsområde fungerer som et lokalt cmux-arbejdsområde, men dets terminaler kører på en maskine i skyen. Denne side dækker holdbare terminaler, kørsel af agenter, notifikationer og de værktøjer, der er installeret på alle maskiner.

Holdbare terminaler

Terminalerne lever i maskinens dæmon, ikke på din Mac. De kører videre, når du lukker en rude, afslutter cmux, mister Wi-Fi eller lukker din bærbare. Åbn maskinen igen fra enhver Mac, der er logget ind, og terminalen har stadig sit output og sin kørende proces.

Hvis forbindelsen afbrydes, viser ruden Cloud session disconnected med knappen Reconnect, og cmux prøver selv igen.

Hvis maskinens dæmon genstarter, gendanner cmux arbejdsområdets layout, men processer, der kørte, overlever ikke genstarten.

Når du lukker et arbejdsområde, kører dets terminaler videre frakoblet. Når du fjerner et arbejdsområde, stoppes dets terminaler.

Kør kodningsagenter

Claude Code, Codex, OpenCode og Pi er installeret på alle maskiner. Åbn et Cloud-arbejdsområde, og start agenten, som du gør lokalt. Agent-hooks er allerede sat op, så agentstatus og notifikationer når frem til din Mac.

cmux vm agent starter en agent på en maskine fra din Mac. Med en prompt bruger den agentens engangstilstand. Tilføj --sync for først at uploade den aktuelle mappe og --wait for at vente på resultatet.

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 installerer en cmux Cloud-færdighed til din lokale agent og udskriver en prompt, der lærer den at bruge Cloud-maskiner.

cmux vm prompt --open claude

Kør kommandoer

cmux vm run kører en kommando på en maskine og returnerer dens exitkode. Første kørsel fra en mappe vælger en maskine og husker den for den mappe i 14 dage. Tilføj --sync for først at uploade mappen og --pull for at downloade et resultat.

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

cmux vm exec kører en kort kommando uden terminal. Den er beregnet til hurtige kontroller. Tidsgrænsen er som standard 30 sekunder og højst 5 minutter. Brug cmux vm run, cmux vm agent eller en terminal i et arbejdsområde til langt arbejde.

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

Start en udviklingsserver

cmux vm dev uploader et projekt, finder ud af, hvordan det startes, og åbner det i et arbejdsområde med serveren og en browser. Den genkender package.json-projekter, Cargo, Go, dev-mål i Makefile, Django, uv, pyproject, requirements.txt og statiske index.html-sider. Brug --dry-run for først at se planen.

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

Notifikationer

cmux notify inde i en maskine viser en notifikation på din Mac for den terminal. Agent-hooks sender notifikationer, når en agent er færdig, skal godkendes, stiller et spørgsmål eller fejler. Titler er begrænset til 128 byte og brødtekst til 1 KB, og mange notifikationer på kort tid hastighedsbegrænses.

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

Indsæt billeder

Tryk på ⌘V med et billede på udklipsholderen i en Cloud-terminal. cmux uploader billedet til maskinen og indsætter den eksterne sti, så Claude Code og Codex kan læse det. PNG, JPEG, GIF og WebP understøttes, op til 20 MB hver og 8 billeder ad gangen.

Layouts og terminaler fra CLI'en

cmux vm workspace opretter, åbner, omdøber, lukker og fjerner arbejdsområder på en maskine. cmux vm terminal sender tekst, læser output og venter på tekst eller på afslutning. cmux vm tree viser maskinens arbejdsområder og terminaler. cmux vm layout export og apply bruger samme JSON som 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

Hvad der er installeret

Maskinerne kører Ubuntu 24.04. Du arbejder som brugeren cmux med sudo uden adgangskode, ikke som root. Docker starter ved opstart.

• Sprog og værktøjer: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, byggeværktøjer, vim, nano og rsync.
• Browser og skrivebord: Chrome, agent-browser, et VNC-skrivebord og Ghostty.
• Agenter: Claude Code, Codex, OpenCode og Pi. De er fastlåst til testede versioner og opdateres, når maskinens image opdateres.

Hvis en agentkommando ikke findes lige efter, at du har oprettet en maskine, kører opsætningen stadig. Opsætningsloggen ligger i /tmp/cmux/provision.log.

Modeladgang

Agenter på en maskine kan bruge cmux' modelrouting uden en nøgle på maskinen. De rigtige legitimationsoplysninger tilføjes uden for maskinen, så intet kontotoken gemmes i VM'en. Du kan også logge ind på en agent inde i maskinen eller uploade konti til dit team med cmux ai-accounts upload.

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

CodeRouter-dokumentation: understøttede konti, deling og forbrug

cmux CLI inde i en maskine

Inde i en maskine styrer kommandoen cmux den maskines session. Den understøtter tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url og self. cmux self viser ejeren, maskinen og dine andre maskiner. cmux vm verb peer styrer dine andre maskiner inde fra en maskine.

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

Login, upload af AI-konti og kommandoer til maskinens livsforløb som new, delete, checkpoint, fork, resize, pause, domains, open og vpn kører kun på din Mac.

iPhone

cmux-appen til iOS administrerer ikke Cloud-maskiner. En maskine, der er ved at starte, vises som et pladsholderkort.