cmux Cloud

O cmux Cloud oferece máquinas Linux persistentes na nuvem que abrem como espaços de trabalho normais do cmux. Os terminais continuam rodando quando você fecha um painel, perde a rede ou desliga o notebook, então os agentes de codificação continuam trabalhando e você pode se reconectar de qualquer Mac com sessão iniciada.

O cmux Cloud está em acesso antecipado e está disponível, a menos que sua organização o desative. Para usá-lo, ative Settings › Beta Features › Cloud Machines.

O que é uma máquina

Uma máquina é um computador persistente na nuvem que pertence a você ou à sua equipe. Ela mantém seus arquivos, ferramentas instaladas e terminais em execução. Trate-a como um animal de estimação, não como gado: você instala o que precisa uma vez e volta a ela depois.

Toda máquina executa o daemon do cmux TUI. O daemon mantém os espaços de trabalho e terminais da máquina. Um painel do cmux no seu Mac apenas exibe um terminal que vive na máquina, então fechar o painel nunca interrompe o processo.

Uma máquina pode ter muitos espaços de trabalho. O padrão usual é um espaço de trabalho por tarefa em uma máquina que você mantém, e não uma máquina nova por tarefa.

Cada máquina recebe um nome gerado, como brave-otter. Esse nome é o ID dela no app e na CLI. Você pode adicionar um rótulo de exibição, mas o ID não muda.

O que você precisa

O app cmux para macOS, em execução e com sessão iniciada. A CLI do cmux se comunica com o app, e o app guarda suas credenciais.
Um plano pago do cmux. Contas gratuitas não podem criar máquinas. Consulte a página de preços para ver os planos atuais. cmux.com/pricing
Cloud Machines ativado em Settings › Beta Features, sem nenhuma política da organização que desative o Cloud.
Nenhuma configuração de VPN, chave SSH ou encaminhamento de portas. O cmux se conecta às suas máquinas por uma rede privada que inicia automaticamente.

Início rápido

Inicie a sessão. Use a aba Cloud na barra lateral direita ou execute o comando de login em um terminal.
Crie uma máquina com File › New Cloud Machine ou ⇧⌘Y. Escolha um tamanho e um rótulo opcional. A criação continua em segundo plano, e o cmux mostra uma notificação quando a máquina estiver pronta.
Abra um espaço de trabalho na máquina com ⌘Y (New Cloud Workspace). Dentro de um espaço de trabalho do Cloud, ⌘N sempre cria um espaço de trabalho local neste Mac.
Execute um agente. Claude Code, Codex, OpenCode e Pi já estão instalados na máquina.

Você pode fazer o mesmo pela CLI:

cmux auth login
cmux vm new --size 8g --name "api work"
cmux vm ls
cmux vm open brave-otter
cmux vm agent --agent claude --machine brave-otter --sync -- "fix the failing tests"

O Cloud no app

A aba Cloud na barra lateral direita lista suas máquinas. Em cada máquina você vê seus espaços de trabalho, portas encaminhadas, telas VNC e terminais. Clique em um item para abri-lo. Você também pode abrir a árvore do Cloud como painel pela paleta de comandos com Open Cloud as Pane.

Clique com o botão direito em uma máquina para abrir um shell, criar um espaço de trabalho, abrir o desktop, abrir o cliente completo do cmux TUI, redimensioná-la, renomeá-la, copiar o endereço IP, ver o status, criar um checkpoint, fazer um fork ou excluí-la. Você também pode fixar máquinas e mudar a ordem delas.

New Cloud Machine (⇧⌘Y) e New Cloud Workspace (⌘Y) estão no menu File, no menu do botão de mais e na paleta de comandos. Você pode alterar os dois atalhos em Settings ou no cmux.json com as chaves newCloudMachine e newCloudWorkspace.

{
  "shortcuts": {
    "bindings": {
      "newCloudMachine": "cmd+shift+y",
      "newCloudWorkspace": "cmd+y"
    }
  }
}

O Cloud pela CLI

cmux vm e cmux cloud são o mesmo comando. Execute cmux vm sem verbo para listar suas máquinas. Todo verbo tem uma página --help que funciona sem o app, e cmux vm guide imprime um guia completo em Markdown. Adicione --json a qualquer verbo para obter saída legível por máquina.

cmux vm              # list machines
cmux vm --help
cmux vm new --help
cmux vm guide        # full Markdown guide
cmux vm ls --json

Sua máquina base

Cada conta tem uma máquina base fixada. cmux vm base a abre e a cria na primeira vez. cmux vm base reset cria uma nova máquina base e mantém a antiga, para que você não perca arquivos por acidente.

cmux vm base
cmux vm base reset --reason "start clean"

Próximos passos

Esta página foi útil?

Abrir issue