wendy vm
Run local WendyOS and Wendy Lite simulators
Syntax
wendy vm [flags]Examples
wendy vm --helpArguments
Choose a subcommand from See also.
Flags
Flags below include inherited options. Types and defaults come from the CLI source. An empty default means no value is configured.
| Flag | Type | Default | Description |
|---|---|---|---|
--device | string | (empty) | Target device host (hostname, IP, or host:port); 'wendy run' accepts a comma-separated list to deploy one build to several devices (needs a remote build host and --detach). Defaults to $WENDY_DEVICE, then the saved default device |
--json | bool | false | Output in JSON format |
--yes / -y | bool | false | Accept prompts, including installing QEMU when it is missing (Linux still asks before running sudo) |
Output
Output depends on the operation and selected target. Command behavior and detailed examples.
JSON output
The global --json option requests machine-readable output. The CLI also selects JSON mode when no interactive terminal is attached. Support and payloads are command-specific; this flag does not guarantee a single JSON document for commands that stream logs or invoke build tools. Consult Details before parsing command output.
Exit codes
The CLI entry point returns 0 on success and for its user-cancelled or default-cleared results. Other returned errors exit with 1 and print a diagnostic to stderr. Some operations may terminate through subprocess or signal handling; do not infer application health from the CLI exit code alone.
Common errors
Check argument values and flag combinations against the synopsis above. For discovery, build, port, and readiness failures, see deployment troubleshooting. Command-specific constraints are in Details.
See also
- wendy
- wendy vm create
- wendy vm list
- wendy vm logs
- wendy vm rm
- wendy vm robot
- wendy vm serial
- wendy vm start
- wendy vm stop
- CLI conventions and configuration
Details
Run a WendyOS ARM64 virtual machine on this computer, so you can develop and evaluate WendyOS without a Jetson or Raspberry Pi.
Requires QEMU (apt install qemu-system-arm qemu-efi-aarch64, or dnf install qemu-system-aarch64 edk2-aarch64). When it is missing, Wendy offers to install it with Homebrew, WinGet, apt-get, or dnf.