1vm bukan wrapper di sekitar app, dan app bukan wrapper di sekitar 1vm. Keduanya adalah klien library yang sama, itulah mengapa tidak ada yang bisa Anda klik yang mustahil di-skrip.

1vm <command> [options]
1vm --help
1vm snapshot --help

Mesin

Command	What it does
`list`	Setiap mesin, dengan state dan alamat
`create <name>`	Buat mesin
`info <vm>`	Semua tentang satu mesin
`config <vm>`	Cetak file definisi mesin
`get <vm> [key]`	Baca satu setting, atau daftar semua kunci bertitik
`set <vm> <key> <value>`	Ubah setting, live jika didukung
`rm <vm> --force`	Hapus mesin dan semua snapshot
`clone <vm> <name>`	Linked clone (`--full`, `--rekey-ssh`)
`archive <vm>`	Kompres mesin yang dihentikan; jalankan lagi untuk restore
`rollback <vm> on\|off`	Buang semua perubahan saat power-off
`du`	Penggunaan disk di seluruh library
`logs <vm>`	Log serial guest dan siklus hidup host

logs menerima --source all|guest|host, --lines N dan --follow.

Menjalankan

Command	What it does
`start <vm>`	Jalankan di foreground; `--detach` untuk background
`stop <vm> [--force]`	Minta guest shutdown, atau cabut listrik
`pause` / `resume <vm>`	Bekukan dan lepaskan
`suspend <vm>`	Simpan memori ke disk dan matikan
`eject <vm>`	Lepaskan installer setelah guest boot sendiri
`console <vm>`	Buka tampilan guest
`configure <vm>`	Buka jendela settings
`ip <vm>`	Alamat guest, polos, untuk skrip

start melanjutkan mesin yang di-suspend; tambahkan --discard-saved-state untuk cold-boot sebagai gantinya. --hold-on-crash mempertahankan bug-check Windows di layar alih-alih meresetnya.

Snapshot

Command	What it does
`snapshot take <vm> [name]`	Tangkap state
`snapshot list <vm>`	Pohon snapshot
`snapshot restore <vm> <ref>`	Kembali ke snapshot
`snapshot rm <vm> <ref> [-r]`	Hapus satu, atau cabang
`reset <vm> --force`	Kembali ke state bersih
`discard-session <vm> --force`	Kembali ke snapshot saat boot ini

Host

Command	What it does
`capabilities`	Apa yang Mac ini bisa dan tidak bisa
`doctor`	Host, entitlements, library, engine
`guide <linux\|macos\|windows\|omarchy>`	Apa yang guest dukung dan tidak
`guide rosetta`	Menjalankan binary x86 di guest Linux
`passport [<vm>]`	Matriks kemampuan sebagai markdown, atau `--json`
`macos images\|download`	Restore image cache, dan terbaru Apple
`debug metrics <vm>`	Counter performa engine

Akses guest

Command	What it does
`wait-ready <vm>`	Poll SSH (Linux) atau guest agent (Windows)
`exec <vm> -- <cmd…>`	Jalankan satu perintah di guest
`ssh <vm> [-- <cmd…>]`	SSH interaktif
`ssh enable\|disable <vm>`	Nyalakan/matikan SSH Mac-ke-guest
`ssh config --install`	Tambahkan baris Include ke `~/.ssh/config`
`ssh keys <vm>`	Kunci mesin (`--regenerate`, `--print-public`)
`ssh trust <vm>`	Sematkan host key guest (`--relearn`)

wait-ready yang membuat skrip andal — menunggu sampai guest benar-benar dapat dijangkau, bukan sekadar running.

Otomasi

Command	What it does
`task run -- <cmd…>`	Klon golden, tunggu, exec, buang
`template pin\|unpin\|list`	Library golden image
`golden capture <vm>`	Rekam golden firmware dan first-boot
`agent gc`	Hapus mesin dihentikan yang dibuat agen
`mcp serve`	MCP JSON-RPC di stdio
`mcp install-snippet [host]`	Config JSON untuk Claude, Cursor atau generic

Opsi create

Option	Meaning
`--guest linux\|macos\|windows`	Tipe guest, default `linux`
`--hypervisor apple\|native`	Engine. Windows default `native`
`--cpu <n>`	Jumlah CPU, default 4
`--memory <size>`	mis. `4GiB`, default 4 GiB
`--disk <size>`	mis. `64GiB`, default 64 GiB
`--iso <path>`	Media installer, terpasang sampai di-eject
`--from-folder <path>`	Folder host sebagai media install removable
`--drivers <path>`	ISO virtio-win untuk guest Windows
`--restore-image <path\|build>`	Restore image macOS
`--from <golden>`	Linked-clone golden disematkan (`--full` untuk salin)
`--storage virtio-block\|nvme`	Controller disk; `nvme` untuk Windows
`--network nat\|host-only\|bridged:en0`	Jaringan
`--share tag:/host/path[:ro]`	Folder shared, dapat diulang
`--clipboard`	Bagikan clipboard Mac dua arah
`--rosetta`	Terjemahan x86 di guest Linux
`--agent-ready`	Buat kunci SSH dan cloud-init untuk `exec`
`--preset omarchy`	Resep Omarchy

Opsi global

--json untuk output machine-readable, --quiet / -q hanya error, --force / --yes lewati konfirmasi, --detach background start, dan --version.

Kode keluar

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

Perintah destruktif menolak dengan exit 4 alih-alih prompt, kecuali Anda beri --force. Tidak ada prompt interaktif di mana pun, by design.