# Cloud radni prostori i agenti

Cloud radni prostor radi kao lokalni cmux radni prostor, ali se njegovi terminali izvršavaju na mašini u oblaku. Ova stranica pokriva trajne terminale, pokretanje agenata, notifikacije i alate instalirane na svakoj mašini.

## Trajni terminali

Terminali žive u daemonu mašine, a ne na vašem Mac računaru. Nastavljaju raditi kada zatvorite panel, zatvorite cmux, izgubite Wi-Fi ili zatvorite laptop. Ponovo otvorite mašinu sa bilo kojeg prijavljenog Mac računara i terminal i dalje ima svoj izlaz i pokrenuti proces.

Ako veza pukne, panel prikazuje Cloud session disconnected s dugmetom Reconnect, a cmux sam ponovo pokušava.

Ako se daemon mašine ponovo pokrene, cmux vraća raspored radnog prostora, ali procesi koji su radili ne preživljavaju ponovno pokretanje.

Zatvaranje radnog prostora ostavlja njegove terminale da rade odvojeno. Uklanjanje radnog prostora zaustavlja njegove terminale.

## Pokretanje agenata za kodiranje

Claude Code, Codex, OpenCode i Pi su instalirani na svakoj mašini. Otvorite Cloud radni prostor i pokrenite agenta kao i lokalno. Hookovi agenata su već podešeni, pa status agenata i notifikacije stižu na vaš Mac.

cmux vm agent pokreće agenta na mašini sa vašeg Mac računara. Uz prompt koristi jednokratni način rada agenta. Dodajte --sync da prvo otpremite trenutni direktorij i --wait da sačekate rezultat.

```
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 instalira cmux Cloud vještinu za vašeg lokalnog agenta i ispisuje prompt koji ga uči kako da koristi Cloud mašine.

```
cmux vm prompt --open claude
```

## Pokretanje komandi

cmux vm run pokreće komandu na mašini i vraća njen izlazni kod. Prvo pokretanje iz direktorija bira mašinu i pamti je za taj direktorij 14 dana. Dodajte --sync da prvo otpremite direktorij i --pull da preuzmete rezultat.

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

cmux vm exec pokreće kratku komandu bez terminala. Namijenjena je brzim provjerama. Vremensko ograničenje je zadano 30 sekundi, a najviše 5 minuta. Za dugotrajan rad koristite cmux vm run, cmux vm agent ili terminal radnog prostora.

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

## Pokretanje dev servera

cmux vm dev otprema projekat, pronalazi kako ga pokrenuti i otvara ga u radnom prostoru sa serverom i preglednikom. Prepoznaje projekte s package.json, Cargo, Go, dev ciljeve u Makefile, Django, uv, pyproject, requirements.txt i statične stranice s index.html. Koristite --dry-run da prvo vidite plan.

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

## Notifikacije

cmux notify unutar mašine prikazuje notifikaciju na vašem Mac računaru za taj terminal. Hookovi agenata šalju notifikacije kada agent završi, treba odobrenje, postavi pitanje ili ne uspije. Naslovi su ograničeni na 128 bajtova, a tijelo na 1 KB, dok je broj uzastopnih notifikacija ograničen.

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

## Lijepljenje slika

Pritisnite ⌘V u Cloud terminalu dok je slika u međuspremniku. cmux otprema sliku na mašinu i lijepi udaljenu putanju, tako da je Claude Code i Codex mogu pročitati. Podržani su PNG, JPEG, GIF i WebP, do 20 MB po slici i do 8 slika odjednom.

## Rasporedi i terminali iz CLI-ja

cmux vm workspace kreira, otvara, preimenuje, zatvara i uklanja radne prostore na mašini. cmux vm terminal šalje tekst, čita izlaz i čeka na tekst ili izlaz procesa. cmux vm tree prikazuje radne prostore i terminale mašine. cmux vm layout export i apply koriste isti JSON kao 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
```

## Šta je instalirano

Mašine koriste Ubuntu 24.04. Radite kao korisnik cmux sa sudo pristupom bez lozinke, a ne kao root. Docker se pokreće pri podizanju sistema.

-   Jezici i alati: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, alati za build, vim, nano i rsync.
-   Preglednik i radna površina: Chrome, agent-browser, VNC radna površina i Ghostty.
-   Agenti: Claude Code, Codex, OpenCode i Pi. Zakačeni su na testirane verzije i ažuriraju se kada se ažurira image mašine.

Ako komanda agenta nije pronađena odmah nakon kreiranja mašine, podešavanje još traje. Log podešavanja nalazi se u /tmp/cmux/provision.log.

## Pristup modelima

Agenti na mašini mogu koristiti cmux rutiranje modela bez ključa na mašini. Stvarni pristupni podaci dodaju se izvan mašine, pa se nijedan token računa ne čuva u VM-u. Možete se prijaviti i u agenta unutar mašine ili otpremiti račune za svoj tim pomoću cmux ai-accounts upload.

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

[CodeRouter dokumentacija: podržani računi, dijeljenje i potrošnja](https://cmux.com/bs/docs/coderouter)

## cmux CLI unutar mašine

Unutar mašine, komanda cmux upravlja sesijom te mašine. Podržava tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url i self. cmux self prikazuje vlasnika, mašinu i vaše druge mašine. cmux vm verb peer upravlja vašim drugim mašinama iznutra.

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

Prijava, otpremanje AI računa i komande životnog ciklusa mašina kao što su new, delete, checkpoint, fork, resize, pause, domains, open i vpn rade samo na vašem Mac računaru.

## iPhone

cmux iOS aplikacija ne upravlja Cloud mašinama. Mašina koja se pokreće prikazuje se kao privremena kartica.

Canonical: https://cmux.com/bs/docs/cloud/workspaces

Documentation index: https://cmux.com/llms.txt