List all currently running VMware Fusion virtual machines.

Returns the count and paths of all running VMs, along with their display names.

Returns:

• total: number of running VMs

• vms: array of { name, vmxPath }

Note: Only VMs started by the current user are shown (use sudo for root-started VMs).

Discover all VMware Fusion virtual machines on the system by scanning common VM directories.

Scans ~/Virtual Machines.localized and related paths for .vmx files. Also accepts an optional extra directory to search.

Args:

• extra_dir (string, optional): Additional directory path to scan for VMs.

Returns:

• total: number of VMs found

• vms: array of { name, vmxPath, guestOS, memoryMB, numCPUs }

Get detailed information about a specific VMware Fusion virtual machine.

Reads the .vmx configuration file and checks running status.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

Returns: Object with name, vmxPath, guestOS, memoryMB, numCPUs, annotation, hardwareVersion, running status.

Start (power on) a VMware Fusion virtual machine.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• nogui (boolean, optional): If true, starts the VM without a GUI window (headless). Default: false.

Returns: Confirmation message on success.

Stop (power off) a VMware Fusion virtual machine.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• mode (string, optional): "soft" sends a shutdown signal to the guest OS (graceful). "hard" forces immediate power off. Default: "soft".

Returns: Confirmation message on success.

Suspend a running VMware Fusion virtual machine. Saves the VM's state to disk.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

Returns: Confirmation message on success.

Reset (reboot) a VMware Fusion virtual machine.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• mode (string, optional): "soft" for graceful reboot, "hard" for forced reset. Default: "soft".

Returns: Confirmation message on success.

Get the IP address of a running VMware Fusion guest OS.

The VM must be running and have VMware Tools installed for this to work.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• wait (boolean, optional): If true, waits for the guest to obtain an IP. Default: true.

Returns: The IP address as a string, or an error if unavailable.

List all snapshots of a VMware Fusion virtual machine.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

Returns:

• total: number of snapshots

• snapshots: array of snapshot names

Create a new snapshot of a VMware Fusion virtual machine.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• snapshot_name (string): Name for the new snapshot.

Returns: Confirmation message on success.

Revert a VMware Fusion virtual machine to a previous snapshot.

WARNING: This discards any changes made since the snapshot was taken.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• snapshot_name (string): Name of the snapshot to revert to.

Returns: Confirmation message on success.

Delete a snapshot from a VMware Fusion virtual machine.

WARNING: This permanently removes the snapshot and its state. This cannot be undone.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• snapshot_name (string): Name of the snapshot to delete.

Returns: Confirmation message on success.

Check the status of VMware Tools in a virtual machine's guest OS.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

Returns: The VMware Tools status (e.g., "installed", "running", "not installed").

Run a program inside a VMware Fusion guest OS.

Requires VMware Tools to be installed and running in the guest.

Args:

• vmx_path (string): Absolute path to the VM's .vmx file.

• guest_user (string): Username for guest authentication.

• guest_password (string): Password for guest authentication.

• program (string): Full path to the program inside the guest OS.

• program_args (string, optional): Arguments to pass to the program.

• no_wait (boolean, optional): If true, returns immediately without waiting for the program to finish. Default: false.

Returns: Output from the program or confirmation that it was launched.