1. Download the matching executable
Use the download for your host and CPU architecture. On Windows, run the following commands in the executable’s directory.
Downloads2. Inspect version and help
.\vm-cli.exe version
.\vm-cli.exe --help3. Install the Agent Skill
.\vm-cli.exe setup --clients codexOr open the manager and choose Agent Skill. Your agent client still supplies the AI model and its own login. vm-cli does not include a model.
4. Create and start a local machine
.\vm-cli.exe create lab --preset modern-x64
.\vm-cli.exe start labThis creates a VM, not an installed operating system. Attach suitable installation media when needed, or work with an already installed local machine.
These creation examples target an x64 host. On ARM64, choose the arm64 preset. Use host inspect and preset list to inspect your actual environment.
On macOS and Linux, use ./vm-cli in place of .\vm-cli.exe. Mark the downloaded file executable with chmod +x vm-cli.
5. Open the display
.\vm-cli.exe view lab --viewer sdlUse a screenshot to inspect the current screen. Open the viewer when you want to see or take over the machine. Let the installed Skill guide the agent through control sessions and supported input commands.
Hardware and installation media
Inspect the configuration and devices before making changes. Use the revision reported by config show for changes that require --revision. The full CLI manual explains media attach, storage, networking and input control ownership.
.\vm-cli.exe config show lab
.\vm-cli.exe device list lab
.\vm-cli.exe media list lab