1vm không phải wrapper quanh app, và app cũng không phải wrapper quanh 1vm. Cả hai đều là client của cùng một thư viện, nên không có gì bạn click được mà không thể script.

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 nhận --source all|guest|host, --lines N và --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 tiếp tục máy đã treo; thêm --discard-saved-state để khởi động lạnh. --hold-on-crash giữ màn hình bug-check của Windows thay vì reset nó đi.

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 là lệnh giúp script đáng tin — nó chặn cho đến khi guest thực sự có thể truy cập, không chỉ đang chạy.

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 cho đầu ra máy đọc được, --quiet / -q chỉ lỗi, --force / --yes để bỏ qua xác nhận, --detach để chạy nền khi start, và --version.

Exit codes

Code	Meaning
0	ok
1	failed
2	usage
3	not found
4	wrong state
5	unsupported

Lệnh phá hủy từ chối với exit 4 thay vì nhắc, trừ khi bạn truyền --force. Theo thiết kế, không có lời nhắc tương tác ở đâu cả.