Espacios de trabajo de Cloud y agentes

Un espacio de trabajo de Cloud funciona como un espacio de trabajo local de cmux, pero sus terminales se ejecutan en una máquina en la nube. Esta página cubre los terminales persistentes, la ejecución de agentes, las notificaciones y las herramientas instaladas en cada máquina.

Terminales persistentes

Los terminales viven en el daemon de la máquina, no en tu Mac. Siguen en ejecución cuando cierras un panel, sales de cmux, pierdes el Wi-Fi o cierras el portátil. Vuelve a abrir la máquina desde cualquier Mac con la sesión iniciada y el terminal conservará su salida y su proceso en ejecución.

Si se cae la conexión, el panel muestra Cloud session disconnected con un botón Reconnect, y cmux reintenta por sí solo.

Si el daemon de la máquina se reinicia, cmux restaura el diseño del espacio de trabajo, pero los procesos que se estaban ejecutando no sobreviven al reinicio.

Cerrar un espacio de trabajo mantiene sus terminales en ejecución de forma desacoplada. Eliminar un espacio de trabajo detiene sus terminales.

Ejecutar agentes de programación

Claude Code, Codex, OpenCode y Pi están instalados en todas las máquinas. Abre un espacio de trabajo de Cloud e inicia el agente como lo harías en local. Los hooks de los agentes ya están configurados, así que el estado de los agentes y las notificaciones llegan a tu Mac.

cmux vm agent inicia un agente en una máquina desde tu Mac. Con un prompt, usa el modo de ejecución única del agente. Añade --sync para subir primero el directorio actual y --wait para esperar el resultado.

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 instala una habilidad de cmux Cloud para tu agente local y muestra un prompt que le enseña a usar las máquinas de Cloud.

cmux vm prompt --open claude

Ejecutar comandos

cmux vm run ejecuta un comando en una máquina y devuelve su código de salida. La primera ejecución desde un directorio elige una máquina y la recuerda para ese directorio durante 14 días. Añade --sync para subir primero el directorio y --pull para descargar un resultado.

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

cmux vm exec ejecuta un comando corto sin terminal. Sirve para comprobaciones rápidas. Su tiempo de espera es de 30 segundos por defecto y de 5 minutos como máximo. Para trabajos largos, usa cmux vm run, cmux vm agent o un terminal del espacio de trabajo.

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

Iniciar un servidor de desarrollo

cmux vm dev sube un proyecto, averigua cómo iniciarlo y lo abre en un espacio de trabajo con el servidor y un navegador. Detecta proyectos package.json, Cargo, Go, objetivos dev de Makefile, Django, uv, pyproject, requirements.txt y sitios estáticos index.html. Usa --dry-run para ver primero el plan.

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

Notificaciones

cmux notify dentro de una máquina muestra una notificación en tu Mac para ese terminal. Los hooks de los agentes envían notificaciones cuando un agente termina, necesita aprobación, hace una pregunta o falla. Los títulos están limitados a 128 bytes y los cuerpos a 1 KB, y las ráfagas tienen límite de frecuencia.

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

Pegar imágenes

Pulsa ⌘V con una imagen en el portapapeles en un terminal de Cloud. cmux sube la imagen a la máquina y pega la ruta remota, para que Claude Code y Codex puedan leerla. Se admiten PNG, JPEG, GIF y WebP, hasta 20 MB cada una y 8 imágenes a la vez.

Diseños y terminales desde la CLI

cmux vm workspace crea, abre, renombra, cierra y elimina espacios de trabajo en una máquina. cmux vm terminal envía texto, lee la salida y espera un texto o la finalización. cmux vm tree muestra los espacios de trabajo y los terminales de la máquina. cmux vm layout export y apply usan el mismo 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

Qué está instalado

Las máquinas ejecutan Ubuntu 24.04. Trabajas como el usuario cmux con sudo sin contraseña, no como root. Docker se inicia al arrancar.

• Lenguajes y herramientas: Node.js LTS, Bun, Python 3.12, uv, Docker, git, GitHub CLI, ripgrep, fd, fzf, jq, tmux, sqlite3, herramientas de compilación, vim, nano y rsync.
• Navegador y escritorio: Chrome, agent-browser, un escritorio VNC y Ghostty.
• Agentes: Claude Code, Codex, OpenCode y Pi. Están fijados en versiones probadas y se actualizan cuando se actualiza la imagen de la máquina.

Si no se encuentra un comando de agente justo después de crear una máquina, la configuración aún está en curso. El registro de configuración está en /tmp/cmux/provision.log.

Acceso a modelos

Los agentes de una máquina pueden usar el enrutamiento de modelos de cmux sin una clave en la máquina. La credencial real se añade fuera de la máquina, así que no se guarda ningún token de cuenta en la VM. También puedes iniciar sesión en un agente dentro de la máquina o subir cuentas para tu equipo con cmux ai-accounts upload.

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

Documentación de CodeRouter: cuentas compatibles, uso compartido y consumo

La CLI de cmux dentro de una máquina

Dentro de una máquina, el comando cmux controla la sesión de esa máquina. Admite tree, new-workspace, new-split, send, send-key, read-screen, terminal, layout, env, notify, open-url y self. cmux self muestra el propietario, la máquina y tus otras máquinas. cmux vm verb peer controla tus otras máquinas desde dentro de una máquina.

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

El inicio de sesión, la subida de cuentas de IA y los comandos del ciclo de vida de las máquinas, como new, delete, checkpoint, fork, resize, pause, domains, open y vpn, solo se ejecutan en tu Mac.

iPhone

La app de cmux para iOS no gestiona máquinas de Cloud. Una máquina que se está iniciando aparece como una tarjeta provisional.