skills.rest
ryanmaclean
ryanmacleanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

vibecode-vm

Automate Alpine Linux macOS VM lifecycle management with vfkit.

1|Updated Jul 16, 2025
Search Tags:#postgres#vm-management#vfkit#apple-virtualization#macos-vm#alpine-rootfs#openvscode
One-click install
npx skills add https://github.com/ryanmaclean/vibecode-webgui --skill vibecode-vm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vibecode-vm
Source: https://github.com/ryanmaclean/vibecode-webgui/tree/main/.claude/skills/vibecode-vm
Command: npx skills add https://github.com/ryanmaclean/vibecode-webgui --skill vibecode-vm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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

Frequently Asked Questions about vibecode-vm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build and manage native macOS VMs using vfkit?▼

You can build and manage native macOS VMs using vfkit by running Python scripts that download the Alpine kernel, assemble a rootfs image, and launch the VM via the Apple Virtualization Framework.

What are the prerequisites for running an Alpine Linux VM on macOS with vfkit?▼

Prerequisites for running an Alpine Linux VM on macOS with vfkit include macOS 13 or later, an Apple Silicon or Intel Mac, Python 3.10 or higher, and a local vfkit installation to handle the virtualization framework.

Can I provision PostgreSQL and OpenVSCode inside an Alpine rootfs on a macOS VM?▼

Yes, you can provision PostgreSQL and OpenVSCode inside an Alpine rootfs on a macOS VM. The rootfs creation script configures a development environment tailored for these stacks alongside Node.js.

How do I monitor and control the lifecycle of a vfkit macOS virtual machine?▼

You monitor and control the lifecycle of a vfkit macOS virtual machine using the provided VM manager CLI, which supports commands to list, start, stop, check health, monitor, view logs, and perform build operations.

Does this approach support creating repeatable development sandboxes on Apple Silicon?▼

Yes, this approach supports creating repeatable development sandboxes on Apple Silicon by assembling Alpine rootfs images and downloading kernels to bootstrap consistent, isolated VM environments for local testing and container-native workflows.

Related Skills

Explore More Software Engineering Skills→
justinsenseijustinsensei
1

apple-integrations

Integrate macOS and Apple services over SSH from a virtual machine.

Community
Advanced
kevintsengtwkevintsengtw
28

dotnet-testing-advanced-testcontainers-database

Provision and tear down containerized SQL Server and PostgreSQL instances for .NET integration tests.

Community
Advanced
kubiyabotkubiyabot
16

redis

Run Redis CLI commands inside a Docker container.

Official
Advanced
lorenzovenicelorenzovenice
19

convert-to-apple-container

Switch NanoClaw container runtime from Docker to Apple Container on macOS.

Community
Intermediate