Safe virtual-machine automation
Parallels CLI Skill
Operate Linux and Windows virtual machines from a Mac with exact targets, explicit safety checks, and CLI-verifiable state.
Overview
A Codex skill for deterministic Parallels Desktop automation through prlctl and prlsrvctl, covering VM lifecycle, configuration, guest execution, screenshots, snapshots, networks, and recovery workflows.
Parallels CLI Skill turns a broad, version-sensitive virtualization CLI into a discover-first workflow. It keeps inventory and verification close to every operation and routes consequential storage, security, network, and lifecycle changes through explicit safety checks.
VM lifecycle and configuration
Guest Linux and Windows execution
Screenshots, snapshots, clones, and archives
Networks, shared folders, devices, and HiDPI
Built for
Where it fits.
- Codex users automating Parallels Desktop on macOS
- Cross-platform teams maintaining Linux and Windows test VMs
- Developers who need repeatable VM diagnostics and screenshot workflows
Compatibility & status
macOS + Parallels Desktop
Supported
Supported
Parallels Tools required
In the work
Real output,
not a mockup.
Architecture
Clear layers.
Replaceable seams.
Discover
Read-only inventory resolves exact VM, network, device, snapshot, and host state before action.
Validate
Installed CLI help remains the syntax authority for the active Parallels release.
Operate
Focused workflows compose lifecycle, guest, storage, network, device, and screenshot commands.
Verify
Resulting VM state, guest output, or captured display is checked after every material operation.
Quick start
From package
to first frame.
Choose the package workflow used by your repository, then start from the smallest working example. Replace VERSION with the current stable or prerelease version shown on NuGet.
git clone https://github.com/wieslawsoltes/ParallelsSkill.gitcp -R ParallelsSkill/parallels-cli /path/to/codex/skills/$parallels-cli Start my Linux development VM,verify Parallels Tools, and report its IP addresses.Package surface
Start focused.
Compose as needed.
Source, docs, samples, and releases
The repository is the source of truth.
Use the current documentation and samples, inspect changes, report issues, or support continued open-source maintenance.