Start a VMware virtual machine.

Stop a virtual machine. "soft" attempts graceful shutdown, "hard" forces power off.

Suspend a virtual machine, preserving its current state to disk. Warning: encrypted VMs may not resume via vmrun after suspend — use vm_stop instead if unsure.

Reset (reboot) a virtual machine. "soft" runs shutdown scripts first.

Pause a running virtual machine without shutting it down.

Resume a paused virtual machine.

Get the running status and IP address of a virtual machine.

List virtual machines. By default shows only running VMs. Use all=true to include configured VMs from config.

Get the IP address of a running virtual machine.

Execute a shell command inside the guest VM and return stdout. Uses the appropriate shell based on guest OS type (cmd/bash). Requires guest credentials in config and VMware Tools running in guest.

Launch a program inside the guest VM. Can run asynchronously with no_wait. Requires full path to the program.

Copy a file from the host machine to the guest VM.

Copy a file from the guest VM to the host machine.

Read the contents of a file inside the guest VM. Copies to host, reads, then cleans up.

Check if a file exists inside the guest VM.

Check if a directory exists inside the guest VM.

Create a directory inside the guest VM.

Delete a file inside the guest VM.

Rename or move a file inside the guest VM.

List the contents of a directory inside the guest VM.

Create a temporary file inside the guest VM and return its path.

Create a snapshot of a virtual machine. Do not use "/" in snapshot names. Note: may fail on running encrypted VMs due to vmrun limitations — stop the VM first if needed.

Revert a VM to a previous snapshot. The VM will be in suspended state after revert. Use auto_start to automatically power it back on.

List all snapshots of a virtual machine in tree format.

Delete a snapshot from a virtual machine.

List all running processes inside the guest VM. Requires guest credentials.

Kill a process inside the guest VM by its PID.

Capture a screenshot of the VM screen. Returns the image as base64-encoded PNG, or saves to a specified host path. Requires guest credentials in config.

Send keystrokes to the guest VM. Useful for GUI automation when combined with vm_capture_screen. Requires macOS Accessibility permission for VMware Fusion in System Settings.

Read a variable from the VM state.

Write a variable to the VM state.

Check the VMware Tools state in the guest. Returns "unknown", "installed", or "running".