vmctllisted
Install: claude install-skill realweng/vmctl
# vmctl — VMware VM control
Controls local VMware Workstation VMs via `vmrun`. On first use (or via `doctor`) it auto-locates vmrun (env var → cache → PATH → common install paths → Windows registry) and caches the result, handles WSL ↔ Windows path translation, GBK inventory decoding, and CRLF output. Works identically from Windows (Git Bash) and WSL.
## Quick start
Script lives at `scripts/vmctl.sh` in this skill dir (both Windows Git Bash and WSL: `~/.agents/skills/vmctl/scripts/vmctl.sh`):
```bash
bash ~/.agents/skills/vmctl/scripts/vmctl.sh doctor # verify setup, (re)detect & cache vmrun path
bash ~/.agents/skills/vmctl/scripts/vmctl.sh list # all VMs + running state
bash ~/.agents/skills/vmctl/scripts/vmctl.sh start UbuntuServer1 # power on headless (nogui)
bash ~/.agents/skills/vmctl/scripts/vmctl.sh stop UbuntuServer1 # soft shutdown
```
## Commands
| Command | Description |
|---|---|
| `doctor` | Show detected env/vmrun/inventory; force re-detection and refresh cache |
| `list` | List all inventory VMs with running/off state |
| `status <vm>` | Show power state of one VM |
| `start <vm> [--gui]` | Power on; `nogui` (default) runs headless, `--gui` opens the VMware window |
| `stop <vm> [soft\|hard]` | Shutdown; `soft` (default) = graceful in-guest, `hard` = power off |
| `suspend <vm> [soft\|hard]` | Suspend to memory |
| `reset <vm> [soft\|hard]` | Reboot the VM (must be running) |
| `ip <vm> [--wait]` | Guest IP (ne