DOCUMENTAÇÃO / PRIMEIROS PASSOS

Conecte seu agente.
Mantenha o controle.

O mesmo executável atende ao terminal, gerenciador nativo e agente.

1. Baixar o executável adequado

Escolha o download para o host e arquitetura CPU. No Windows, execute os comandos na pasta do programa.

Downloads

2. Consultar versão e ajuda

Exemplo de CLI
.\vm-cli.exe version
.\vm-cli.exe --help

Manual CLI completo em inglês

3. Instalar a Skill do agente

Exemplo de CLI
.\vm-cli.exe setup --clients codex

Você também pode escolher Agent Skill no gerenciador. Seu cliente agente continua fornecendo o modelo e seu próprio login. vm-cli não inclui um modelo.

4. Criar e iniciar uma máquina local

Exemplo de CLI
.\vm-cli.exe create lab --preset modern-x64
.\vm-cli.exe start lab

Isso cria uma VM, não um sistema instalado. Conecte mídias adequadas ou use uma máquina já instalada.

Estes exemplos são para hosts x64. Em ARM64, escolha o perfil arm64. Verifique o ambiente com host inspect e preset list.

No macOS e Linux, substitua .\vm-cli.exe por ./vm-cli. Use chmod +x vm-cli para tornar o arquivo executável.

5. Abrir a tela

Exemplo de CLI
.\vm-cli.exe view lab --viewer sdl

Inspecione a tela por uma captura. Abra o visualizador para observar ou intervir. A Skill orienta o agente nas sessões de controle e comandos de entrada.

Gerenciador Windows do vm-cli 1.1.1 com máquinas virtuais e a entrada Agent Skill.

Hardware e mídias de instalação

Inspecione configuração e dispositivos antes de alterar. Para --revision, use a revisão de config show. O manual explica media attach, armazenamento, rede e controle de entradas.

Exemplo de CLI
.\vm-cli.exe config show lab
.\vm-cli.exe device list lab
.\vm-cli.exe media list lab

Suas VMs, em todos os seus computadores.

Veja as máquinas locais e as dos computadores registrados em uma só lista. Crie cópias de imagens, ajuste o hardware e controle o sistema pela linha de comando, pelo gerenciador nativo ou pelo navegador.

Windows · x64 · macOS · Apple Silicon ARM64 · macOS · Intel x64 · Linux · x64 · Linux · ARM64

Exemplo de CLI
vm-cli ls
vm-cli ps
vm-cli run --image ./images/dev --on local --name dev-copy
vm-cli run --image cloud://dev-images:v3 --on office-win --name dev-remote

As VMs rodam nos seus próprios computadores. A Cloud guarda imagens e ajuda seus dispositivos a se encontrarem; não inclui aluguel de computadores.

Abrir guia

Versão · Windows x64 ·

Windows: conecte suas máquinas virtuais

NAT independente, NAT compartilhada, redes internas e bridge Ethernet. Gerencie várias placas de rede e encaminhamento TCP/UDP pela CLI, GUI nativa ou Web.

Um único EXE assinado. Instale o serviço do Windows com aprovação do administrador; depois, Agent, CLI, GUI e Web usam o serviço nas operações diárias de bridge sem repetir a autorização. A versão e o ID de compilação do cliente e do serviço devem coincidir exatamente; mudar de compilação exige aprovar a atualização do serviço. O driver SeLow original assinado está incluído. Requer Ethernet compatível; IP, gateway e DNS do host permanecem no lugar. A atualização corrige transferências grandes lentas do host para a VM e permite recuperar sua interface após reconectar o adaptador físico. A preparação da ponte gerencia o descarregamento de envio grande IPv4 apenas no adaptador selecionado e pode reconectá-lo brevemente. A configuração original é restaurada após a remoção da última autorização de ponte. Esta versão também encerra conexões de bridge ativas quando sua autorização é revogada e melhora a resposta das transferências em NAT compartilhada.

Windows x64 · 2026-10-25 · 1.1.1

Após atualizar, atualize o Agent Skill usando o novo executável.

Exemplo de CLI
.\vm-cli.exe setup --action update --clients codex
.\vm-cli.exe setup --action check --clients codex

Manual de redes do Windows · Abrir guia · Avisos de terceiros

Versão · Linux / macOS · 2026-10-25

Linux e Mac: conecte suas máquinas virtuais

NAT independente, NAT compartilhada, redes internas e bridge Ethernet. Gerencie várias placas de rede e encaminhamento TCP/UDP pela CLI, GUI nativa ou Web.

Linux: testado no Ubuntu 24.04.4 com NetworkManager 1.46 e Ethernet. Preparar a ponte exige aprovação local do administrador; rotas VPN e regras de firewall não são alteradas automaticamente.

Mac: versões Intel x64 e Apple Silicon ARM64 assinadas com Developer ID e autenticadas pela Apple. Testadas no macOS 12.7.6 (Intel) e 26.5.1 (Apple Silicon). A ponte vmnet por cabo exige aprovação local; a ponte Wi-Fi não foi validada.

Os testes de suspensão e retomada no Linux ARM64 e nos dois Macs foram adiados; não são considerados verificados.

Após atualizar, atualize o Agent Skill usando o novo executável.

Exemplo de CLI
./vm-cli setup --action update --clients codex
./vm-cli setup --action check --clients codex

Abrir guia · Avisos de terceiros

COMECE COM SEU AGENTE

Um pedido.
Seu agente cuida do resto.

Cole isto em um agente que possa ler páginas da web e executar comandos no seu computador.

CodexClaude CodeOpenCode

Leia https://vm-cli.com/agent-install.md e siga o guia para baixar o vm-cli oficial adequado ao sistema e à arquitetura de CPU deste computador, verificar o SHA-256, instalar, configurar a Skill vm-cli para meu agente e conferir o comando de ajuda.

Seu agente precisa de permissão para operar neste computador. Confirme pessoalmente os pedidos de autorização do sistema.

Depois, dê uma tarefa real.

Use vm-cli para verificar os recursos deste computador, encontrar um sistema Ubuntu compatível no catálogo oficial e me ajudar a executá-lo. Mostre a área de trabalho quando estiver pronta.

Idioma

Troque o idioma e permaneça nesta página.

Englishen简体中文zh-CN繁體中文zh-TWEspañolesFrançaisfrDeutschdePortuguês (Brasil)pt-BRРусскийru日本語ja한국어koالعربيةarहिन्दीhi

Aparência

Siga o sistema ou escolha um tema.

Download temporariamente indisponível

Não foi possível iniciar o download. Tente novamente ou escolha outra plataforma.

Downloads