Cloud-arbeidsområder og agenter

Et Cloud-arbeidsområde fungerer som et lokalt cmux-arbeidsområde, men terminalene kjører på en maskin i skyen. Denne siden dekker varige terminaler, kjøring av agenter, varsler og verktøyene som er installert på alle maskiner.

Varige terminaler

Terminalene lever i maskinens daemon, ikke på Mac-en din. De fortsetter å kjøre når du lukker en rute, avslutter cmux, mister Wi-Fi eller lukker den bærbare. Åpne maskinen igjen fra hvilken som helst innlogget Mac, og terminalen har fortsatt utdataene og den kjørende prosessen.

Hvis tilkoblingen brytes, viser ruten Cloud session disconnected med en Reconnect-knapp, og cmux prøver på nytt av seg selv.

Hvis maskinens daemon starter på nytt, gjenoppretter cmux oppsettet til arbeidsområdet, men prosesser som kjørte, overlever ikke omstarten.

Å lukke et arbeidsområde lar terminalene kjøre videre frakoblet. Å fjerne et arbeidsområde stopper terminalene.

Kjør kodingsagenter

Claude Code, Codex, OpenCode og Pi er installert på alle maskiner. Åpne et Cloud-arbeidsområde og start agenten slik du gjør lokalt. Agent-hooks er allerede satt opp, så agentstatus og varsler når frem til Mac-en din.

cmux vm agent starter en agent på en maskin fra Mac-en din. Med en prompt bruker den agentens engangsmodus. Legg til --sync for å laste opp gjeldende mappe først og --wait for å 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-ferdighet for den lokale agenten din og skriver ut en prompt som lærer den å bruke Cloud-maskiner.

cmux vm prompt --open claude

Kjør kommandoer

cmux vm run kjører en kommando på en maskin og returnerer avslutningskoden. Den første kjøringen fra en mappe velger en maskin og husker den for den mappen i 14 dager. Legg til --sync for å laste opp mappen først og --pull for å laste ned et resultat.

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

cmux vm exec kjører en kort kommando uten terminal. Den er ment for raske kontroller. Tidsavbruddet er 30 sekunder som standard og maksimalt 5 minutter. Bruk cmux vm run, cmux vm agent eller en terminal i et arbeidsområde til langvarig arbeid.

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

Start en utviklingsserver

cmux vm dev laster opp et prosjekt, finner ut hvordan det startes, og åpner det i et arbeidsområde med serveren og en nettleser. Den gjenkjenner package.json-prosjekter, Cargo, Go, dev-mål i Makefile, Django, uv, pyproject, requirements.txt og statiske index.html-nettsteder. Bruk --dry-run for å se planen først.

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

Varsler

cmux notify inne i en maskin viser et varsel på Mac-en for den terminalen. Agent-hooks sender varsler når en agent er ferdig, trenger godkjenning, stiller et spørsmål eller mislykkes. Titler er begrenset til 128 byte og brødtekst til 1 KB, og mange varsler på kort tid blir hastighetsbegrenset.

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

Lim inn bilder

Trykk ⌘V med et bilde på utklippstavlen i en Cloud-terminal. cmux laster opp bildet til maskinen og limer inn den eksterne stien, slik at Claude Code og Codex kan lese det. PNG, JPEG, GIF og WebP støttes, opptil 20 MB hver og 8 bilder om gangen.

Oppsett og terminaler fra CLI-en

cmux vm workspace oppretter, åpner, gir nytt navn til, lukker og fjerner arbeidsområder på en maskin. cmux vm terminal sender tekst, leser utdata og venter på tekst eller på avslutning. cmux vm tree viser maskinens arbeidsområder og terminaler. cmux vm layout export og apply bruker 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

Hva som er installert

Maskinene kjører Ubuntu 24.04. Du jobber som brukeren cmux med sudo uten passord, ikke som root. Docker starter ved oppstart.

• Språk og verktøy: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, byggeverktøy, vim, nano og rsync.
• Nettleser og skrivebord: Chrome, agent-browser, et VNC-skrivebord og Ghostty.
• Agenter: Claude Code, Codex, OpenCode og Pi. De er låst til testede versjoner og oppdateres når maskinens image oppdateres.

Hvis en agentkommando ikke finnes rett etter at du har opprettet en maskin, kjører oppsettet fortsatt. Oppsettsloggen ligger i /tmp/cmux/provision.log.

Modelltilgang

Agenter på en maskin kan bruke cmux sin modellruting uten en nøkkel på maskinen. Den ekte påloggingsinformasjonen legges til utenfor maskinen, så ingen kontotoken lagres i VM-en. Du kan også logge inn på en agent inne i maskinen eller laste opp kontoer for teamet ditt med cmux ai-accounts upload.

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

CodeRouter-dokumentasjon: støttede kontoer, deling og forbruk

cmux CLI inne i en maskin

Inne i en maskin styrer kommandoen cmux økten til den maskinen. Den støtter tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url og self. cmux self viser eieren, maskinen og de andre maskinene dine. cmux vm verb peer styrer de andre maskinene dine fra innsiden av en maskin.

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

Innlogging, opplasting av AI-kontoer og kommandoer for maskinens livsløp som new, delete, checkpoint, fork, resize, pause, domains, open og vpn kjører bare på Mac-en din.

iPhone

cmux-appen for iOS administrerer ikke Cloud-maskiner. En maskin som starter, vises som et plassholderkort.