VM CLI

Use the Freestyle CLI for operational VM workflows and quick debugging.

Prerequisites

npx freestyle vm list

npx freestyle vm create \
  --snapshot <snapshot-id> \
  --exec '<command>'

npx freestyle vm create \
  --snapshot <snapshot-id> \
  --exec '<command>' \
  --delete

npx freestyle vm create --snapshot <snapshot-id> --ssh

For temporary debug sessions:

npx freestyle vm create --snapshot <snapshot-id> --ssh --delete

npx freestyle vm exec <vm-id> '<command>'

npx freestyle vm delete <vm-id>

--json: return machine-readable output.
--delete:
- with --ssh: delete when SSH session exits.
- without --ssh: delete after create/exec completes.

For VM_SETUP_FAILED, capture logs immediately from a fresh VM:

npx freestyle vm create \
  --snapshot <snapshot-id> \
  --exec 'journalctl --no-pager -eu <service-name>' \
  --delete

See Systemd Services for the full troubleshooting flow.