Espaces de travail Cloud et agents

Un espace de travail Cloud fonctionne comme un espace de travail cmux local, mais ses terminaux s'exécutent sur une machine dans le cloud. Cette page couvre les terminaux persistants, l'exécution des agents, les notifications et les outils installés sur chaque machine.

Terminaux persistants

Les terminaux vivent dans le démon de la machine, pas sur votre Mac. Ils continuent de tourner quand vous fermez un volet, quittez cmux, perdez le Wi-Fi ou refermez votre portable. Rouvrez la machine depuis n'importe quel Mac connecté : le terminal a toujours sa sortie et son processus en cours.

Si la connexion est interrompue, le volet affiche Cloud session disconnected avec un bouton Reconnect, et cmux réessaie de lui-même.

Si le démon de la machine redémarre, cmux restaure la disposition de l'espace de travail, mais les processus qui tournaient ne survivent pas au redémarrage.

Fermer un espace de travail laisse ses terminaux tourner en mode détaché. Supprimer un espace de travail arrête ses terminaux.

Exécuter des agents de code

Claude Code, Codex, OpenCode et Pi sont installés sur chaque machine. Ouvrez un espace de travail Cloud et lancez l'agent comme en local. Les hooks des agents sont déjà configurés : l'état des agents et les notifications arrivent sur votre Mac.

cmux vm agent lance un agent sur une machine depuis votre Mac. Avec un prompt, il utilise le mode ponctuel de l'agent. Ajoutez --sync pour envoyer d'abord le répertoire courant et --wait pour attendre le résultat.

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 installe une compétence cmux Cloud pour votre agent local et affiche un prompt qui lui apprend à utiliser les machines Cloud.

cmux vm prompt --open claude

Exécuter des commandes

cmux vm run exécute une commande sur une machine et renvoie son code de sortie. La première exécution depuis un répertoire choisit une machine et la mémorise pour ce répertoire pendant 14 jours. Ajoutez --sync pour envoyer d'abord le répertoire et --pull pour télécharger un résultat.

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

cmux vm exec exécute une commande courte sans terminal. Elle sert aux vérifications rapides. Son délai d'expiration est de 30 secondes par défaut et de 5 minutes au maximum. Pour les tâches longues, utilisez cmux vm run, cmux vm agent ou un terminal d'espace de travail.

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

Démarrer un serveur de développement

cmux vm dev envoie un projet, détermine comment le démarrer et l'ouvre dans un espace de travail avec le serveur et un navigateur. Il détecte les projets package.json, Cargo, Go, les cibles dev de Makefile, Django, uv, pyproject, requirements.txt et les sites statiques index.html. Utilisez --dry-run pour voir le plan d'abord.

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

Notifications

cmux notify dans une machine affiche une notification sur votre Mac pour ce terminal. Les hooks des agents envoient des notifications quand un agent termine, a besoin d'une approbation, pose une question ou échoue. Les titres sont limités à 128 octets et le corps à 1 KB, et les rafales sont limitées en débit.

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

Coller des images

Appuyez sur ⌘V avec une image dans le presse-papiers dans un terminal Cloud. cmux envoie l'image sur la machine et colle le chemin distant, pour que Claude Code et Codex puissent la lire. Les formats PNG, JPEG, GIF et WebP sont pris en charge, jusqu'à 20 MB par image et 8 images à la fois.

Dispositions et terminaux depuis le CLI

cmux vm workspace crée, ouvre, renomme, ferme et supprime des espaces de travail sur une machine. cmux vm terminal envoie du texte, lit la sortie et attend un texte ou la fin du processus. cmux vm tree affiche les espaces de travail et les terminaux de la machine. cmux vm layout export et apply utilisent le même JSON que 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

Ce qui est installé

Les machines tournent sous Ubuntu 24.04. Vous travaillez en tant qu'utilisateur cmux avec sudo sans mot de passe, pas en tant que root. Docker démarre au boot.

• Langages et outils : Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, outils de compilation, vim, nano et rsync.
• Navigateur et bureau : Chrome, agent-browser, un bureau VNC et Ghostty.
• Agents : Claude Code, Codex, OpenCode et Pi. Ils sont figés sur des versions testées et se mettent à jour avec l'image de la machine.

Si une commande d'agent est introuvable juste après la création d'une machine, la configuration est encore en cours. Le journal de configuration se trouve dans /tmp/cmux/provision.log.

Accès aux modèles

Les agents d'une machine peuvent utiliser le routage de modèles de cmux sans clé sur la machine. Le véritable identifiant est ajouté en dehors de la machine, donc aucun jeton de compte n'est stocké dans la VM. Vous pouvez aussi vous connecter à un agent dans la machine, ou envoyer des comptes pour votre équipe avec cmux ai-accounts upload.

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

Documentation CodeRouter : comptes pris en charge, partage et utilisation

Le CLI cmux dans une machine

Dans une machine, la commande cmux contrôle la session de cette machine. Elle prend en charge tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url et self. cmux self affiche le propriétaire, la machine et vos autres machines. cmux vm verb peer contrôle vos autres machines depuis une machine.

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

La connexion, l'envoi de comptes IA et les commandes de cycle de vie des machines comme new, delete, checkpoint, fork, resize, pause, domains, open et vpn ne s'exécutent que sur votre Mac.

iPhone

L'app cmux pour iOS ne gère pas les machines Cloud. Une machine en cours de démarrage s'affiche sous forme de carte provisoire.