DOCS / QUICKSTART

Connect your agent.
Keep control of the machine.

The same vm-cli executable serves the terminal, native manager and agent workflow.

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.

Downloads

2. Inspect version and help

CLI usage example
.\vm-cli.exe version
.\vm-cli.exe --help

English CLI manual

3. Install the Agent Skill

CLI usage example
.\vm-cli.exe setup --clients codex

Or 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

CLI usage example
.\vm-cli.exe create lab --preset modern-x64
.\vm-cli.exe start lab

This 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

CLI usage example
.\vm-cli.exe view lab --viewer sdl

Use 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.

vm-cli 1.1.1 Windows manager showing virtual machines and the Agent Skill toolbar entry.

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.

CLI usage example
.\vm-cli.exe config show lab
.\vm-cli.exe device list lab
.\vm-cli.exe media list lab

Your VMs. Across your computers.

See your local and registered computers in one list. Create from an image, change hardware, and control the guest from the command line, native manager or browser.

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

CLI usage example
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

VMs run on computers you own. Cloud keeps your image library and helps your devices find each other; rented cloud computers are not included.

Open guide

Release · Windows x64 ·

Windows: connect your virtual machines

Independent NAT, shared NAT, internal networks and wired bridging. Add multiple network cards and TCP/UDP port forwarding, from the CLI, native GUI or Web.

One signed EXE. Install the Windows service once with administrator approval; daily Agent, CLI, GUI and Web bridge operations then use it without repeated prompts. Client and service version and build ID must match exactly; approve a service update when changing builds. The original signed SeLow driver is embedded. Use compatible wired Ethernet; host IP, gateway and DNS stay in place. The update repairs host-to-guest large transfers and reconnects the original guest interface after a physical adapter reconnect. Bridge preparation manages IPv4 large-send offload only on the selected adapter and may briefly reconnect it; the original setting is restored after its last bridge authorization is removed. This build also closes active bridge connections when their authorization is revoked and improves shared NAT transfer responsiveness.

Windows x64 · 2026-10-25 · 1.1.1

After updating, refresh your Agent Skill from the new executable.

CLI usage example
.\vm-cli.exe setup --action update --clients codex
.\vm-cli.exe setup --action check --clients codex

Windows networking manual · Open guide · Third-party notices

Release · Linux / macOS · 2026-10-25

Linux & Mac: networking in every workspace

Independent NAT, shared NAT, internal networks and wired bridging. Add multiple network cards and TCP/UDP port forwarding, from the CLI, native GUI or Web.

Linux: tested on Ubuntu 24.04.4 with NetworkManager 1.46 and wired Ethernet. Host bridge preparation needs local administrator approval; existing VPN routes and firewall rules are not changed automatically.

Mac: separate Intel x64 and Apple Silicon ARM64 builds, Developer ID signed and notarized. Tested on macOS 12.7.6 (Intel) and 26.5.1 (Apple Silicon). Wired vmnet bridging needs local approval; Wi-Fi bridging is not qualified.

Sleep/resume testing is deferred for Linux ARM64 and both Mac builds; it is not claimed as verified.

After updating, refresh your Agent Skill from the new executable.

CLI usage example
./vm-cli setup --action update --clients codex
./vm-cli setup --action check --clients codex

Open guide · Third-party notices

START WITH YOUR AGENT

One request.
Ready to run.

Paste this into an agent that can read the web and run commands on your computer.

CodexClaude CodeOpenCode

Read https://vm-cli.com/agent-install.md and follow it to download the official vm-cli build for this computer’s operating system and CPU architecture, verify its SHA-256 checksum, install it, configure the vm-cli Skill for my agent, and check that the help command works.

Your agent needs permission to work on this computer. Confirm any system authorization prompts yourself.

Then, give it a real task.

Use vm-cli to inspect this computer’s capabilities, find a compatible Ubuntu system in the official catalog, and help me run it. Show me its desktop when it is ready.

Language

Choose your language. Stay on the same page.

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

Appearance

Follow your device or choose a theme.

Download temporarily unavailable

We couldn’t start this download. Try again, or choose another platform.

Downloads