1vm은 앱의 래퍼가 아니며, 앱도 1vm의 래퍼가 아닙니다. 둘 다 동일한 라이브러리의 클라이언트이므로, 클릭할 수 있는 것은 모두 스크립트로 할 수 있습니다.
1vm <command> [options]
1vm --help
1vm snapshot --help
머신
| Command | What it does |
|---|
list | 모든 머신, 상태 및 주소 포함 |
create <name> | 머신 생성 |
info <vm> | 한 머신에 대한 모든 정보 |
config <vm> | 머신 정의 파일 출력 |
get <vm> [key] | 하나의 설정 읽기, 또는 모든 점 표기 키 나열 |
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] | 하나 또는 브랜치 삭제 |
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…> | 게스트에서 명령 하나 실행 |
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로 거부합니다. 설계상 대화형 프롬프트는 어디에도 없습니다.