Vibecode Vm

VibeCode VM Skill

Build and manage native macOS VMs using Apple's Virtualization Framework (vfkit).

Quick Setup

# 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

Prerequisites

• macOS 13+ (Ventura or later)
• Apple Silicon (ARM64) or Intel Mac
• Homebrew (for vfkit installation)
• Python 3.10+

VM Manager CLI

The Python VM manager provides full lifecycle management:

# List all VMs and their status
python3 scripts/vfkit/vm-manager.py list

# Start specific VM
python3 scripts/vfkit/vm-manager.py start valkey
python3 scripts/vfkit/vm-manager.py start postgresql
python3 scripts/vfkit/vm-manager.py start nodejs-dev

# Start all VMs
python3 scripts/vfkit/vm-manager.py start-all

# Stop VMs
python3 scripts/vfkit/vm-manager.py stop valkey
python3 scripts/vfkit/vm-manager.py stop-all

# Health check
python3 scripts/vfkit/vm-manager.py health

# Monitor resource usage
python3 scripts/vfkit/vm-manager.py monitor

# View/follow logs
python3 scripts/vfkit/vm-manager.py logs valkey
python3 scripts/vfkit/vm-manager.py follow valkey

Quick Reference

Setup Scripts

Launch Scripts

Service VMs

Testing & Validation

Interactive TUI Menu

For a guided experience, use the interactive menu:

python3 scripts/vibecode_vm_menu.py

This provides:

• VM status overview
• Build initramfs (Ansible)
• Build Swift app
• Start/stop VMs
• SSH connectivity
• VSCode browser access
• Network scanning

CLI Mode (Non-Interactive)

The menu also supports direct CLI commands:

# Show VM status
python3 scripts/vibecode_vm_menu.py status -n

# Show help
python3 scripts/vibecode_vm_menu.py help -n

# Available commands
python3 scripts/vibecode_vm_menu.py --help

Commands: status, build, build-app, start, stop, ssh, vscode, clean, help, menu

Testing the TUI

# Run TUI component tests
python3 scripts/vibecode_vm_menu.py --test

Build Scripts

Build Initramfs

# Python initramfs builder (for Docker)
python3 scripts/build_initramfs.py

# K3s-enabled initramfs
python3 scripts/build_k3s_initramfs.py

Build VM Disk Images

python3 scripts/create_vm_disk_images.py

Build Swift VM Manager

# Compile Swift binary with entitlements
python3 scripts/build_vm_manager.py

Workflows

Create Development VM

# Setup and create Alpine VM with Node.js
python3 scripts/vfkit/01-setup-vfkit.py
python3 scripts/vfkit/02-download-alpine-kernel.py
python3 scripts/vfkit/03-create-alpine-rootfs.py
python3 scripts/vfkit/04-launch-alpine-vm.py

Start Full Service Stack

# Start Valkey, PostgreSQL, and Node.js dev VM
python3 scripts/vfkit/vm-manager.py start-all
python3 scripts/vfkit/vm-manager.py health

Test VM Performance

python3 scripts/vfkit/basic_performance_test.py

Directory Structure

~/.vfkit/vms/vibecode-alpine/
├── kernel/     # Linux kernel files
├── rootfs/     # Root filesystem builds
│   └── build/  # Build working directory
├── disk/       # Persistent disk images
└── logs/       # VM console and error logs

~/VibeCode VMs/
└── *.bundle    # macOS VM bundles (SwiftUI apps)

Services Available in VMs

Network

VMs use NAT networking on the 192.168.64.x subnet. DHCP assigns IPs automatically.

Scan for VM IPs:

for i in {2..20}; do nc -zw1 192.168.64.$i 22 && echo "192.168.64.$i"; done

Troubleshooting

vfkit not found

brew install vfkit

VM not starting

# Check logs
python3 scripts/vfkit/vm-manager.py logs <vm-name>

# Check port availability
lsof -i :6379  # Valkey
lsof -i :5432  # PostgreSQL

Permission denied

Ensure vfkit has Virtualization entitlements:

codesign -dv $(which vfkit)

Notes

• Apple Silicon recommended - Native ARM64 VMs with near-native performance
• Persistent storage - Use 07-create-persistent-vm.py for disk-backed VMs
• Ansible integration - Full Ansible playbooks in ansible/ directory

Converted and distributed by TomeVault — claim your Tome and manage your conversions.