Execute a command in a Parallels guest
vm_execExecute command-line programs inside a Parallels VM by specifying the VM name and an argument vector, with optional user and timeout.
Instructions
Execute an explicit argv vector inside the guest.
Args: vm: The VM name or UUID. command: Argument vector, e.g. ["whoami"] or ["ls", "-la"]. user: Optional guest username. If omitted, uses the current desktop user on Windows. timeout_s: Execution timeout in seconds (default: 300s).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vm": "<vm>",
"command": "<command>"
},
"name": "vm_exec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vm | Yes | ||
| user | No | ||
| command | Yes | ||
| timeout_s | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| vm | Yes | ||
| uuid | Yes | ||
| stderr | Yes | ||
| stdout | Yes | ||
| command | Yes | ||
| returncode | Yes | ||
| stderr_truncated | No | ||
| stdout_truncated | No |