ทุกคำสั่งรับ --json และส่งผลลัพธ์ที่เครื่องอ่านได้ไปที่ stdout ข้อผิดพลาดไปที่ stderr พร้อมรหัส exit ที่มีความหมาย รูปแบบถูก ตรึงไว้: ทุกอ็อบเจ็กต์มี apiVersion: 1 ฟิลด์จะถูกเพิ่มเท่านั้น และการเปลี่ยนแปลงที่ทำให้เสียความเข้ากันได้จะเพิ่มเวอร์ชัน ถูกล็อกโดยชุดทดสอบ

ผลลัพธ์จะจัดรูปแบบสวยงามด้วยคีย์ที่เรียงแล้วและวันที่ ISO-8601

รูปแบบ

Shape	Commands
`VMSummaryJSON`	`list`, `info`, `create`
`SnapshotJSON`	`snapshot list`
`OperationJSON`	mutating commands — `snapshot`, `reset`, `clone`, `archive`, `rm`, …
`LogLineJSON`	`logs`
`AddressJSON`	`ip`
`DiskUsageReportJSON`	`du`
`GuideJSON`	`guide <guest>`

VMSummaryJSON มี name, id, guest, state, cpuCount, memoryBytes, diskBytes, network, path, address, snapshotCount, isTemplate, waitingForDHCP และ networkStatistics list --json รวมเครื่องที่เก็บถาวรด้วย state: "archived"

OperationJSON มี ok, operation, vm, detail และ durationMilliseconds — นี่คือวิธีที่คุณได้เวลา snapshot ที่วัดจริง แทนที่จะเชื่อคำพูดของใคร

รหัส exit

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

คำสั่งที่ทำลายข้อมูลจะ ปฏิเสธด้วย exit 4 แทนการถามยืนยัน ไม่มีพรอมต์แบบโต้ตอบ ดังนั้นสคริปต์จะไม่ค้างรอมนุษย์ ส่ง --force หรือ --yes เมื่อคุณตั้งใจจริง

สคริปต์ที่เชื่อถือได้

ความผิดพลาดคือการมองว่า "running" หมายถึง "ready" wait-ready บล็อกจนกว่า guest จะเข้าถึงได้จริง:

set -e
1vm create ci --from ubuntu-golden
1vm start ci --detach
1vm wait-ready ci
1vm exec ci -- ./run-tests.sh
1vm discard-session ci --force

เครื่องใช้แล้วทิ้งในคำสั่งเดียว

task run ทำวงจร clone-wait-exec-dispose ทั้งหมดให้คุณ:

1vm task run -- ./build.sh

มันโคลน golden image ที่ปักหมุด รอความพร้อม รันคำสั่ง และทิ้งเครื่อง golden image จัดการด้วย template pin, template list และ golden capture

MCP

1VMTool พูด Model Context Protocol ดังนั้น AI agent สามารถเป็นเจ้าของและขับเคลื่อน เครื่องได้โดยตรง:

1vm mcp serve                      # JSON-RPC on stdio
1vm mcp install-snippet claude     # config JSON for a host
1vm agent gc                       # delete stopped agent-created machines

agent gc สำคัญ: agent ที่สร้างเครื่องไม่ควรทิ้งไว้ และนี่คือคำกริยาสำหรับทำความสะอาด