vm_exec
Execute commands inside a QEMU guest via the guest agent for VM-side tasks like file checks, app launches, and diagnostics.
Instructions
Run a command inside the guest via the QEMU guest agent (qemu-ga must be installed).
args: single string, split on whitespace, quotes respected, backslashes kept as-is (Windows guest paths like 'C:\uos-tests\app.exe' survive). Windows guests: use 'cmd.exe' with args like '/c dir C:'. If the agent is missing the error explains how to install it (virtio-win ISO for Windows guests).
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": {
"name": "<name>",
"path": "<path>"
},
"name": "vm_exec"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | ||
| name | Yes | ||
| path | Yes | ||
| timeout | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |