1vm はアプリのラッパーではなく、アプリも 1vm のラッパーではありません。両方とも同じライブラリのクライアントであり、クリックできることはすべてスクリプト化できる理由がここにあります。
1vm <command> [options]
1vm --help
1vm snapshot --help
マシン
| Command | What it does |
|---|
list | すべてのマシン、状態とアドレス付き |
create <name> | マシンを作成 |
info <vm> | 1 台のマシンのすべての情報 |
config <vm> | マシンの定義ファイルを出力 |
get <vm> [key] | 1 つの設定を読み取る、またはすべてのドット区切りキーを一覧 |
set <vm> <key> <value> | 設定を変更（サポートされている場合はライブ） |
rm <vm> --force | マシンとすべてのスナップショットを削除 |
clone <vm> <name> | リンククローン（--full、--rekey-ssh） |
archive <vm> | 停止中のマシンを圧縮。再度実行で復元 |
rollback <vm> on|off | 電源オフ時にすべての変更を破棄 |
du | ライブラリ全体のディスク使用量 |
logs <vm> | ゲスト serial とホストライフサイクルログ |
logs は --source all|guest|host、--lines N、--follow を受け付けます。
実行
| Command | What it does |
|---|
start <vm> | フォアグラウンドで実行。--detach でバックグラウンド化 |
stop <vm> [--force] | ゲストにシャットダウンを依頼、または電源を切る |
pause / resume <vm> | 凍結と解除 |
suspend <vm> | メモリをディスクに保存して電源オフ |
eject <vm> | ゲストが単独で起動したらインストーラを取り外す |
console <vm> | ゲストディスプレイを開く |
configure <vm> | 設定ウィンドウを開く |
ip <vm> | ゲストアドレスのみ、スクリプト用 |
start はサスペンド中のマシンを再開します。代わりにコールドブートするには --discard-saved-state を追加します。--hold-on-crash は Windows のバグチェック画面をリセットせずに表示したままにします。
スナップショット
| Command | What it does |
|---|
snapshot take <vm> [name] | 状態をキャプチャ |
snapshot list <vm> | スナップショットツリー |
snapshot restore <vm> <ref> | スナップショットに戻る |
snapshot rm <vm> <ref> [-r] | 1 つ、またはブランチを削除 |
reset <vm> --force | クリーンな状態に戻る |
discard-session <vm> --force | この起動が始まったスナップショットに戻る |
ホスト
| Command | What it does |
|---|
capabilities | この Mac ができることとできないこと |
doctor | ホスト、エンタイトルメント、ライブラリ、エンジン |
guide <linux|macos|windows|omarchy> | ゲストがサポートするものとしないもの |
guide rosetta | Linux ゲストで x86 バイナリを実行 |
passport [<vm>] | 機能マトリクスを markdown、または --json |
macos images|download | キャッシュ済み restore イメージ、および Apple の最新 |
debug metrics <vm> | エンジンのパフォーマンスカウンター |
ゲストアクセス
| Command | What it does |
|---|
wait-ready <vm> | SSH（Linux）またはゲストエージェント（Windows）をポーリング |
exec <vm> -- <cmd…> | ゲストで 1 コマンドを実行 |
ssh <vm> [-- <cmd…>] | 対話型 SSH |
ssh enable|disable <vm> | Mac からゲストへの SSH をオン/オフ |
ssh config --install | ~/.ssh/config に Include 行を追加 |
ssh keys <vm> | マシンキー（--regenerate、--print-public） |
ssh trust <vm> | ゲストホストキーをピン留め（--relearn） |
wait-ready がスクリプトを信頼できるものにします。単に running ではなく、ゲストが実際に到達可能になるまでブロックします。
自動化
| Command | What it does |
|---|
task run -- <cmd…> | golden イメージをクローン、待機、exec、破棄 |
template pin|unpin|list | golden イメージライブラリ |
golden capture <vm> | ファームウェアと初回起動 golden を記録 |
agent gc | エージェントが作成した停止中マシンを削除 |
mcp serve | stdio 上の MCP JSON-RPC |
mcp install-snippet [host] | Claude、Cursor または汎用の設定 JSON |
create オプション
| Option | Meaning |
|---|
--guest linux|macos|windows | ゲストタイプ、デフォルト linux |
--hypervisor apple|native | エンジン。Windows のデフォルトは native |
--cpu <n> | CPU 数、デフォルト 4 |
--memory <size> | 例: 4GiB、デフォルト 4 GiB |
--disk <size> | 例: 64GiB、デフォルト 64 GiB |
--iso <path> | インストーラメディア、取り外すまで接続 |
--from-folder <path> | リムーバブルインストールメディアとしてのホストフォルダ |
--drivers <path> | Windows ゲスト用 virtio-win ISO |
--restore-image <path|build> | macOS restore イメージ |
--from <golden> | 固定 golden をリンククローン（--full でコピー） |
--storage virtio-block|nvme | ディスクコントローラ。Windows は nvme |
--network nat|host-only|bridged:en0 | ネットワーク |
--share tag:/host/path[:ro] | 共有フォルダ、繰り返し可能 |
--clipboard | Mac クリップボードを双方向で共有 |
--rosetta | Linux ゲストでの x86 変換 |
--agent-ready | exec 用の SSH キーと cloud-init を生成 |
--preset omarchy | Omarchy レシピ |
グローバルオプション
--json で機械可読出力、--quiet / -q でエラーのみ、
--force / --yes で確認をスキップ、--detach で start をバックグラウンド化、--version。
終了コード
| Code | Meaning |
|---|
| 0 | ok |
| 1 | failed |
| 2 | usage |
| 3 | not found |
| 4 | wrong state |
| 5 | unsupported |
破壊的なコマンドは --force を渡さない限り、プロンプトではなく終了コード 4 で拒否します。設計上、対話型プロンプトはどこにもありません。