1vm ei ole kääre sovelluksen ympärillä, eikä sovellus ole kääre 1vm:n ympärillä. Molemmat ovat saman kirjaston asiakkaita, minkä vuoksi mitään, mitä voit klikata, ei ole mahdotonta skriptata.

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

Koneet

Command	What it does
`list`	Jokainen kone, tila ja osoite mukana
`create <name>`	Luo kone
`info <vm>`	Kaikki yhdestä koneesta
`config <vm>`	Tulosta koneen määritystiedosto
`get <vm> [key]`	Lue yksi asetus tai listaa kaikki pisteelliset avaimet
`set <vm> <key> <value>`	Muuta asetusta, live-tilassa missä tuettu
`rm <vm> --force`	Poista kone ja kaikki sen tilannevedokset
`clone <vm> <name>`	Linkitetty klooni (`--full`, `--rekey-ssh`)
`archive <vm>`	Pakkaa pysäytetty kone; suorita uudelleen palauttaaksesi
`rollback <vm> on\|off`	Hylkää kaikki muutokset virran katkaisussa
`du`	Levykäyttö koko kirjastossa
`logs <vm>`	Vieraskoneen sarja- ja isäntäelinkaaren lokit

logs hyväksyy --source all|guest|host, --lines N ja --follow.

Käynnistys

Command	What it does
`start <vm>`	Suorita etualalla; `--detach` taustalle
`stop <vm> [--force]`	Pyydä vieraskonetta sammumaan tai katkaise virta
`pause` / `resume <vm>`	Jäädytä ja vapauta
`suspend <vm>`	Tallenna muisti levylle ja sammuta
`eject <vm>`	Irroita asennusmedia, kun vieraskone käynnistyy itse
`console <vm>`	Avaa vieraskoneen näyttö
`configure <vm>`	Avaa asetusikkuna
`ip <vm>`	Vieraskoneen osoite, pelkkänä skriptausta varten

start jatkaa keskeytettyä konetta; lisää --discard-saved-state kylmäkäynnistykseen sen sijaan. --hold-on-crash pitää Windows-bugcheckin näytöllä sen sijaan, että se nollattaisi pois.

Tilannevedokset

Command	What it does
`snapshot take <vm> [name]`	Tallenna tila
`snapshot list <vm>`	Tilannevedospuu
`snapshot restore <vm> <ref>`	Palaa tilannevedokseen
`snapshot rm <vm> <ref> [-r]`	Poista yksi tai haara
`reset <vm> --force`	Takaisin puhtaaseen tilaan
`discard-session <vm> --force`	Takaisin tämän käynnistyksen tilannevedokseen

Isäntä

Command	What it does
`capabilities`	Mitä tämä Mac voi ja ei voi tehdä
`doctor`	Isäntä, oikeudet, kirjasto, moottorit
`guide <linux\|macos\|windows\|omarchy>`	Mitä vieraskone tukee ja mitä ei
`guide rosetta`	x86-binäärien suoritus Linux-vieraskoneessa
`passport [<vm>]`	Ominaisuusmatriisi markdownina tai `--json`
`macos images\|download`	Välimuistissa olevat palautuskuvat ja Applen uusin
`debug metrics <vm>`	Moottorin suorituskykylaskurit

Pääsy vieraskoneeseen

Command	What it does
`wait-ready <vm>`	Pollaa SSH:ta (Linux) tai vieraskoneagenttia (Windows)
`exec <vm> -- <cmd…>`	Suorita yksi komento vieraskoneessa
`ssh <vm> [-- <cmd…>]`	Interaktiivinen SSH
`ssh enable\|disable <vm>`	Ota Mac–vieraskone SSH päälle tai pois
`ssh config --install`	Lisää Include-rivi tiedostoon `~/.ssh/config`
`ssh keys <vm>`	Koneen avain (`--regenerate`, `--print-public`)
`ssh trust <vm>`	Kiinnitä vieraskoneen isäntäavain (`--relearn`)

wait-ready tekee skripteistä luotettavia — se odottaa, kunnes vieraskone on oikeasti tavoitettavissa eikä vain käynnissä.

Automaatio

Command	What it does
`task run -- <cmd…>`	Kloonaa golden-kuva, odota, suorita, hävitä
`template pin\|unpin\|list`	Golden-kuvakirjasto
`golden capture <vm>`	Tallenna firmware- ja ensikäynnistyksen golden
`agent gc`	Poista agentin luomat pysäytetyt koneet
`mcp serve`	MCP JSON-RPC stdiossa
`mcp install-snippet [host]`	Config JSON Claudelle, Cursorille tai yleiselle

Create-valinnat

Option	Meaning
`--guest linux\|macos\|windows`	Vieraskonetyyppi, oletus `linux`
`--hypervisor apple\|native`	Moottori. Windows oletus `native`
`--cpu <n>`	CPU-määrä, oletus 4
`--memory <size>`	esim. `4GiB`, oletus 4 GiB
`--disk <size>`	esim. `64GiB`, oletus 64 GiB
`--iso <path>`	Asennusmedia, liitetty kunnes irrotettu
`--from-folder <path>`	Isäntäkansio irrotettavana asennusmedian
`--drivers <path>`	virtio-win ISO Windows-vieraskoneelle
`--restore-image <path\|build>`	macOS-palautuskuva
`--from <golden>`	Linkitetty klooni kiinnitetystä golden-kuvasta (`--full` kopioi)
`--storage virtio-block\|nvme`	Levyohjain; `nvme` Windowsille
`--network nat\|host-only\|bridged:en0`	Verkko
`--share tag:/host/path[:ro]`	Jaettu kansio, toistettavissa
`--clipboard`	Jaa Mac-leikepöytä molempiin suuntiin
`--rosetta`	x86-käännös Linux-vieraskoneessa
`--agent-ready`	Luo SSH-avain ja cloud-init komennolle `exec`
`--preset omarchy`	Omarchy-resepti

Yleiset valinnat

--json koneellisesti luettavaan tulosteeseen, --quiet / -q vain virheille, --force / --yes ohittaa vahvistuksen, --detach taustakäynnistykseen, ja --version.

Poistumiskoodit

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

Tuhoavat komennot kieltäytyvät poistumiskoodilla 4 kehotusten sijaan, ellei anna --force. Interaktiivisia kehotteita ei ole missään, tarkoituksella.