vibecode-vm

What problem does it solve?

This Skill automates the build, provisioning, and lifecycle management of native macOS VMs using vfkit to enable rapid, isolated development environments on Apple Silicon and Intel Macs.

Core Features & Use Cases

• VM lifecycle management: Create, start, stop, restart, and monitor Alpine Linux ARM64 VMs on macOS using the Apple Virtualization Framework.
• Rootfs and kernel provisioning: Download kernels and assemble Alpine rootfs images to bootstrap VM environments tailored for development stacks (Valkey/Redis, PostgreSQL, OpenVSCode).
• Consistent dev sandboxes: Produce repeatable VM stacks for local testing, container-native workflows, and native Docker/VSCode experiments on macOS.
• Use Case: A developer wants a repeatable Alpine VM with Postgres and OpenVSCode for a new project; they run a sequence that builds the rootfs, downloads the kernel, and launches the configured VM.

Quick Start

Install prerequisites and set up the VFKit-based environment.

• Install vfkit and create directories: python3 scripts/vfkit/01-setup-vfkit.py
• Download Alpine Linux kernel: python3 scripts/vfkit/02-download-alpine-kernel.py
• Create Alpine rootfs with Node.js: python3 scripts/vfkit/03-create-alpine-rootfs.py
• Launch VM: python3 scripts/vfkit/04-launch-alpine-vm.py