1vm app का wrapper नहीं, app 1vm का wrapper नहीं। दोनों same library
के clients, इसीलिए जो click कर सकते वह script नहीं कर सकते impossible नहीं।
1vm <command> [options]
1vm --help
1vm snapshot --help
Machines
| Command | What it does |
|---|
list | Every machine, with state and address |
create <name> | Create a machine |
info <vm> | Everything about one machine |
config <vm> | Print the machine's definition file |
get <vm> [key] | Read one setting, or list all dotted keys |
set <vm> <key> <value> | Change a setting, live where supported |
rm <vm> --force | Delete a machine and all its snapshots |
clone <vm> <name> | Linked clone (--full, --rekey-ssh) |
archive <vm> | Compress a stopped machine; run again to restore |
rollback <vm> on|off | Discard all changes at power-off |
du | Disk usage across the library |
logs <vm> | Guest serial and host lifecycle logs |
logs --source all|guest|host, --lines N और --follow लेता है।
Running
| Command | What it does |
|---|
start <vm> | Run in the foreground; --detach to background it |
stop <vm> [--force] | Ask the guest to shut down, or pull the plug |
pause / resume <vm> | Freeze and unfreeze |
suspend <vm> | Save memory to disk and power off |
eject <vm> | Detach the installer once the guest boots on its own |
console <vm> | Open the guest display |
configure <vm> | Open the settings window |
ip <vm> | The guest address, bare, for scripting |
start suspended machine resume; cold-boot --discard-saved-state।
--hold-on-crash Windows bug-check screen पर reset away नहीं।
Snapshots
| Command | What it does |
|---|
snapshot take <vm> [name] | Capture state |
snapshot list <vm> | The snapshot tree |
snapshot restore <vm> <ref> | Go back to a snapshot |
snapshot rm <vm> <ref> [-r] | Delete one, or a branch |
reset <vm> --force | Back to the clean state |
discard-session <vm> --force | Back to the snapshot this boot started from |
Host
| Command | What it does |
|---|
capabilities | What this Mac can and cannot do |
doctor | Host, entitlements, library, engines |
guide <linux|macos|windows|omarchy> | What a guest supports, and what it does not |
guide rosetta | Running x86 binaries in a Linux guest |
passport [<vm>] | Capability matrix as markdown, or --json |
macos images|download | Cached restore images, and Apple's latest |
debug metrics <vm> | Engine performance counters |
Guest access
| Command | What it does |
|---|
wait-ready <vm> | Poll SSH (Linux) or the guest agent (Windows) |
exec <vm> -- <cmd…> | Run one command in the guest |
ssh <vm> [-- <cmd…>] | Interactive SSH |
ssh enable|disable <vm> | Turn Mac-to-guest SSH on or off |
ssh config --install | Add the Include line to ~/.ssh/config |
ssh keys <vm> | Machine key (--regenerate, --print-public) |
ssh trust <vm> | Pin the guest host key (--relearn) |
wait-ready scripts reliable बनाता है — guest actually reachable होने तक
block, merely running नहीं।
Automation
| Command | What it does |
|---|
task run -- <cmd…> | Clone a golden image, wait, exec, dispose |
template pin|unpin|list | The golden image library |
golden capture <vm> | Record a firmware and first-boot golden |
agent gc | Delete stopped machines an agent created |
mcp serve | MCP JSON-RPC on stdio |
mcp install-snippet [host] | Config JSON for Claude, Cursor or generic |
Create options
| Option | Meaning |
|---|
--guest linux|macos|windows | Guest type, default linux |
--hypervisor apple|native | Engine. Windows defaults to native |
--cpu <n> | CPU count, default 4 |
--memory <size> | e.g. 4GiB, default 4 GiB |
--disk <size> | e.g. 64GiB, default 64 GiB |
--iso <path> | Installer media, attached until ejected |
--from-folder <path> | A host folder as removable install media |
--drivers <path> | virtio-win ISO for a Windows guest |
--restore-image <path|build> | macOS restore image |
--from <golden> | Linked-clone a pinned golden (--full to copy) |
--storage virtio-block|nvme | Disk controller; nvme for Windows |
--network nat|host-only|bridged:en0 | Networking |
--share tag:/host/path[:ro] | Shared folder, repeatable |
--clipboard | Share the Mac clipboard both directions |
--rosetta | x86 translation in a Linux guest |
--agent-ready | Generate an SSH key and cloud-init for exec |
--preset omarchy | The Omarchy recipe |
Global options
--json machine-readable output, --quiet / -q errors only,
--force / --yes confirmation skip, --detach start background, और
--version.
Exit codes
| Code | Meaning |
|---|
| 0 | ok |
| 1 | failed |
| 2 | usage |
| 3 | not found |
| 4 | wrong state |
| 5 | unsupported |
Destructive commands exit 4 refuse unless --force। Interactive prompts
nowhere, by design.