VibeCode v5.1.0-beta

VibeCode v5.1.0-beta

AI-powered development environment with Alpine Linux VM on macOS

Overview

VibeCode is a web-based development environment that combines AI-assisted coding with virtual machine management. It provides a Next.js 14 dashboard for managing Alpine Linux VMs, AI model integrations via OpenRouter, and infrastructure services including SSH, PostgreSQL, Valkey, and OpenVSCode Server. This release represents a significant quality and stability milestone following multiple hardening waves.

Key Features

VM Management

• 6 VM providers: native-vm (Apple Virtualization Framework), vfkit, QEMU, Lima, Docker, WSL2
• VM lifecycle: Create, start, stop, clone, and delete VM instances
• Snapshot system: Full snapshot management with create, restore, export, import, and size estimation
• VM pool manager: Pre-warmed VM pool for faster instance provisioning
• Port management: Dynamic port allocation and mapping
• VM profiles: Predefined configurations for common workloads
• Security: Shared validation utility at src/lib/vm/security.ts for command injection prevention
• Dashboard pages: VM overview, snapshots, and logs

AI Integration

• OpenRouter integration: Access to 321+ AI models via BYOK (Bring Your Own Key)
• Chat interface: Real-time AI chat with streaming support
• Model management: Browse, compare, and get recommendations for AI models
• Cost tracking page (demo): UI for viewing AI usage costs
• Agent builder page: Visual agent configuration
• 23 AI API routes including chat (standard, streaming, enhanced, unified), model selection, search, project generation, HuggingFace integration, sequential thinking, LiteLLM proxy, and provider health checks
• 2 disabled routes: web-search and upload (disabled, not removed)

Web Dashboard

• 57 pages across 28 sections including AI, VM, monitoring, containers, settings, health, projects, editor, and more
• 14 pages with DemoBanner: These are static demo/placeholder pages not yet connected to real backends: experiments, tutorials, workspaces (2), ai/prompts, ai/costs, ai/agents, ai/conversations, monitoring (main), monitoring/alerts, monitoring/performance, monitoring/vector-db, monitoring/api-performance, monitoring/datadog
• 43 functional pages: Connected to API backends or providing real UI functionality
• 111 API routes across 39 categories (AI, VM, auth, containers, docker, files, github, health, monitoring, services, terminal, and more)

Swift Container Manager

• Native macOS container management library (swift/containers/)
• Built with Swift 5.9, requires macOS 14+ for Virtualization.framework
• Includes ContainerManager library and container-cli executable

Infrastructure Services

• SSH: Remote terminal access to VMs
• PostgreSQL 16: Database service management
• Valkey 7.2: Redis-compatible key-value store (Redis fork)
• OpenVSCode Server: Browser-based VS Code editor
• Docker CE: Container runtime within VMs

Quality Metrics

• 467 test files with 8,500+ tests passing
• 0 TypeScript errors (npx tsc --noEmit clean)
• 57 open Dependabot alerts (0 critical, 20 high, 29 medium, 8 low)
• Code scanning alerts: Multiple open alerts including unused variables, path traversal warnings, and shell injection warnings (ongoing remediation)
• 1 known test failure: route-metrics suite (chokidar ESM/CJS incompatibility with dd-trace)

Known Limitations

• 14 demo pages: Pages with DemoBanner are UI mockups not connected to real services
• No desktop shell in this build: The Tauri desktop wrapper (src-tauri/) is not present in the current codebase; this is a web-only release
• VM providers require host tools: native-vm needs macOS with Virtualization.framework; vfkit/QEMU/Lima need their respective binaries installed
• AI routes require API keys: OpenRouter and HuggingFace features require user-provided API keys (BYOK model)
• 13 API routes lack authentication: VM snapshot routes (6), updates routes (2), and some AI routes call paid external APIs without auth checks
• Major version bumps deferred: prisma 7.x, eslint 10.x, opentelemetry packages not yet upgraded
• Limited service logging: Only 13 of 111 API routes use the standardized createServiceLogger

What's Changed Since v4.2.0

This release includes 1,944 commits across 8 quality/feature waves:

• Wave 13: Full app build completion
• Wave 14: GitHub operations - merged Dependabot PRs, cleaned 461 branches, expanded test coverage
• Wave 15: Quality consolidation - removed 140 dead files (100,651 lines of dead code)
• Wave 16: Deep quality - stub APIs implemented or removed, vector-db fixed, tests expanded
• Wave 17: Fixed all 90 TypeScript errors, repaired navigation (6 pages added, 7 deleted), +213 tests
• Wave 18: Security hardening - resolved 15 Dependabot alerts, updated 21 dependencies, +428 tests
• Wave 19: Quality sweep - fixed 85 tests, removed 11,935 lines of dead code (46 files), audited 109 API routes
• Wave 20: GitHub health - fixed 2 CI failures, resolved 30 CodeQL alerts, cleaned 30 branch refs, merged PR #1844

Installation

git clone https://github.com/ryanmaclean/vibecode.git
cd vibecode
npm install
npm run dev

Requires Node.js 18+ and npm 9+.

VibeCode SwiftUI Apps v1.2.0

Release v1.2.0

Release Date: 2025-11-25

📦 Artifacts

• BasicVibeCode-v1.2.0.app.zip
• LiquidGlassVibeCode-v1.2.0.app.zip
• bun-openvscode-v1.2.0.cpio.gz

✨ Features

• 5ae182b53 feat: Complete build process with testing, docs, and GitHub Pages
• a1b5c0615 feat: Complete build process with testing, docs, and GitHub Pages
• a9e3d04cd feat: Add comprehensive build script and next steps plan
• a0ecbd285 feat: Add Datadog trace verification script
• ec62476 feat: WORKING CrewAI demo - full 4-agent workflow executed
• f06d10a feat: Add working CrewAI demo with real OpenAI models
• 1e10e8b feat: Add Datadog LLM Observability demo (UNVERIFIED)
• 82346c6 feat: Add issue for Datadog trace submission problem
• 056ba23 feat: Add CrewAI demo with Datadog LLM Observability integration
• ed42642 feat: complete standalone VM implementation with testing
• f12fa98 feat: create standalone Swift VM using Virtualization.framework only
• abe1e90 feat: add GUI testing infrastructure with open-source tools
• a6e1c70 feat: verify build system end-to-end and add bun runtime support
• 009383d feat: package workspace-rag extension and prepare VM resources
• 8fdf8cb feat: Add PR testing workflow for automated validation

🐛 Bug Fixes

• 0632ce5 fix: Explicitly capture prompts and responses in Datadog traces
• abc8e3d fix: Datadog integration working - traces confirmed landing
• 92346e8 fix: handle existing disk images in standalone VM
• d2dbb4a fix: improve frontend diagnostics and error handling for blank screen
• 8c7beaa fix: implement VM startup and port forwarding for OpenVSCode Server
• 5854cd6 fix: add index.html for Tauri frontend
• 6ecd6e8 fix: resolve all 105 TypeScript compilation errors in workspace-rag extension
• 25fb8ad fix: correct Datadog tracer initialization and test build system

📝 Documentation

• a4d5ef1 docs: Guide for capturing prompts/responses in Datadog
• 371c530 docs: VERIFIED - CrewAI + Datadog integration working with proof
• 47a1474 docs: VERIFIED - Datadog LLM Observability working
• 53ce4bf docs: Add Datadog setup guide for CrewAI demo
• 432e06b docs: simplify README to reflect test project reality
• 273805e docs: add build status tracking document
• f9a8b10 docs: update workspace-rag release notes with accurate build status
• 6f993f5 docs: add verification checklist - build not yet tested
• 752389b docs: add workspace-rag v1.0.0 release documentation
• 65960e3 docs: update GitHub Pages with working Docker Alpine VM
• 4f73d65 docs: add ASIF page to Astro sidebar navigation
• ed1e125 docs: add ASIF + Virtualization Framework documentation to Astro site
• e627f75 docs: add comprehensive ASIF + Virtualization framework status

🔧 Other Changes

• ed8784d9e Add GRUB EFI bootloader solution with Python scripts and ddtrace support
• c053a09 chore(deps): bump the npm_and_yarn group across 8 directories with 2 updates (#740)
• 4a3ec23 Add name and description to my-agent.agent.md
• 00c4756 chore(deps): bump openai from 4.104.0 to 6.7.0 (#719)
• e3aaaba chore(deps): bump @langchain/weaviate from 0.2.3 to 1.0.0 (#714)
• db315f9 chore(deps): bump @opentelemetry/auto-instrumentations-node (#725)
• 63d254c chore(deps): bump @huggingface/inference from 4.7.1 to 4.13.0 (#726)
• 39ae909 chore(deps): bump bcryptjs from 3.0.2 to 3.0.3 (#728)
• baa3e27 chore(deps-dev): bump eslint from 9.38.0 to 9.39.0 (#727)
• 5424086 chore(deps-dev): bump chrome-launcher from 1.2.0 to 1.2.1 (#729)

📥 Installation

macOS (Apple Silicon)

1. Download BasicVibeCode-v1.2.0.app.zip or LiquidGlassVibeCode-v1.2.0.app.zip
2. Unzip the downloaded file
3. Move the .app to /Applications
4. Right-click and select 'Open' (first time only)

Custom Initramfs

Download bun-openvscode-v1.2.0.cpio.gz and place in app bundle:

cp bun-openvscode-v1.2.0.cpio.gz BasicVibeCode.app/Contents/Resources/bun-openvscode.cpio.gz

📄 License

• Swift host application: MIT License (permissive)
• VM guest components: Various open source licenses (see THIRD_PARTY_NOTICES.md)

VibeCode v4.0.1

VibeCode v4.0.1

Fix OpenVSCode terminal PATH (Issue #790).
Resolves terminal command failures in OpenVSCode Server.

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v4.2.0 - Enhanced Menubar App

VibeCode v4.2.0 - Enhanced Menubar App

Release Date: January 16, 2026
Status: Production Release

Production-ready macOS menubar application with complete development environment.

---

Quick Start

Download

• VibeCode-4.2.0-arm64.dmg (Standard, 134 MB)
• VibeCode-4.2.0-arm64-enhanced.dmg (With README, 134 MB)

Install

1. Download DMG file
2. Open DMG
3. Drag VibeCode.app to Applications
4. Launch from Applications

Verify Download

shasum -a 256 VibeCode-4.2.0-arm64.dmg
# Compare with SHA256SUMS file

---

What's New in v4.2.0

Major Features

Enhanced Menubar UI

• Real-time service monitoring with status indicators
• VM IP address display
• Interactive control buttons (Start VM, Stop VM, Open URL)
• Console viewer for VM output
• Modern macOS-native interface

Localhost Access for All Services

• Automatic port forwarding from VM to localhost
• No need to remember VM IP address
• Services accessible via standard localhost ports:
  • Dropbear SSH: localhost:2222
  • OpenVSCode Server: localhost:3000
  • PostgreSQL 16: localhost:5432
  • Valkey 7.2: localhost:6379

Persistent PostgreSQL Storage

• PostgreSQL data survives VM reboots
• 9p filesystem shared directory (/Users/Shared/vibecode-data)
• Database initialization on first boot
• No data loss on VM restart

One-Click OpenVSCode Launch

• Button in menubar opens browser automatically
• Direct navigation to http://localhost:3000
• No manual URL entry needed

VM Control from Menubar

• Start/Stop VM with single click
• Real-time status monitoring
• Console output viewer
• Service health indicators

Services (All Auto-Start)

All services start automatically when VM boots (~20 seconds):

Dropbear SSH

ssh -p 2222 root@localhost
# Password: vibecode

OpenVSCode Server

open http://localhost:3000
# Or click "Open URL" in menubar

PostgreSQL 16

psql -h localhost -U postgres
# Database: vibecode (auto-created)

Valkey 7.2

redis-cli -h localhost -p 6379

---

System Requirements

• macOS: 13.0+ (Ventura or later)
• Architecture: Apple Silicon (M1/M2/M3/M4) or Intel Mac
• RAM: 4 GB minimum (8 GB recommended)
• Disk: 2 GB free space
• Permissions: Requires Full Disk Access for Virtualization.framework

---

Technical Details

Architecture

• Virtualization: 100% Apple Virtualization.framework
• Guest OS: Alpine Linux 3.21
• Kernel: Linux 6.12 LTS
• Boot Time: ~20 seconds
• Memory: 2 GB RAM allocated to VM
• Storage: 9p shared directory (persistent)

Networking

• VM Network: Bridged mode (DHCP)
• Port Forwarding: Swift Network.framework
• Localhost Access: All services forwarded automatically

Services Details

• Dropbear SSH: 2024.86 (lightweight SSH server)
• OpenVSCode Server: Latest (Gitpod fork)
• PostgreSQL: 16.6 (latest stable)
• Valkey: 7.2.7 (Redis fork)

---

Documentation

Complete documentation included in release:

• Complete Integration Report
• Port Forwarding Implementation
• Menubar Enhancement Guide
• VM Monitoring Tools

---

What's Fixed

Issue #790: OpenVSCode PATH Configuration

• All services now auto-start with proper environment
• OpenVSCode PATH issue resolved
• Services launch successfully on VM boot

Port Forwarding Issues

• All services now accessible via localhost
• No need to discover VM IP address
• Automatic port forwarding on VM startup

PostgreSQL Data Loss

• Persistent storage via 9p filesystem
• Database survives VM reboots
• Data directory: /Users/Shared/vibecode-data/postgres

Service Monitoring

• Real-time status indicators in menubar
• Service health checks
• Console output viewer

---

Known Issues

VM IP Changes on Boot

• VM receives new DHCP IP on each boot
• Port forwarding handles this automatically
• Localhost access unaffected

PostgreSQL Authentication

• Currently uses "trust" mode (no password)
• Suitable for local development
• Configure authentication in pg_hba.conf if needed

SSH Authentication

• Uses password authentication
• Default password: vibecode
• SSH key authentication can be configured

---

Upgrading from v4.1.0

Simple upgrade process:

1. Quit VibeCode v4.1.0
2. Delete old VibeCode.app from Applications
3. Install VibeCode v4.2.0 DMG
4. Launch new version

Note: No data migration needed. PostgreSQL data persists in /Users/Shared/vibecode-data/.

---

Additional Downloads

Scripts Archive (3.7 MB)

vibecode-scripts-4.2.0.tar.gz

Utility scripts included:

• start-vm-services.sh - Manual service startup
• monitor-vm-services.sh - Service monitoring
• test-port-forwarding.sh - Port forwarding tests
• Build scripts and utilities

Documentation Archive (5.8 MB)

vibecode-docs-4.2.0.tar.gz

Complete documentation:

• Integration reports
• Architecture guides
• API documentation
• Troubleshooting guides

---

Verification

Checksums

Download and verify with:

# Download checksums
curl -LO https://github.com/ryanmaclean/vibecode-webgui/releases/download/v4.2.0/SHA256SUMS

# Verify DMG
shasum -a 256 -c SHA256SUMS

Expected Checksums

6242a3acc43249c364d8cb2f45b655e6930dbc16775ebb0b80caee47da64dcc9  VibeCode-4.2.0-arm64.dmg
d522fe62d44664cef70f7fc035e683e3273fa959a101f222c16f1d860de06674  VibeCode-4.2.0-arm64-enhanced.dmg

---

Support

GitHub

• Repository: https://github.com/ryanmaclean/vibecode-webgui
• Issues: https://github.com/ryanmaclean/vibecode-webgui/issues
• Discussions: https://github.com/ryanmaclean/vibecode-webgui/discussions

Community

• Report bugs via GitHub Issues
• Request features via GitHub Discussions
• Contribute via Pull Requests

---

Credits

Built with:

• Apple Virtualization.framework - Native macOS virtualization
• Alpine Linux 3.21 - Lightweight Linux distribution
• OpenVSCode Server - Open-source VS Code for the web (Gitpod)
• PostgreSQL 16 - World's most advanced open-source database
• Valkey 7.2 - High-performance in-memory data store
• Dropbear SSH - Lightweight SSH server

---

License

See LICENSE file in application bundle.

---

Full Changelog: v4.1.0...v4.2.0

VibeCode v4.1.0

VibeCode v4.1.0 - Fixed Networking

Major Fix

• Restored fixed MAC address (52:54:00:12:34:99) for stable DHCP IP detection
• All 5 services now accessible on localhost

Features

• Native Menubar App: Launch Alpine Linux VM with OpenVSCode Server with one click
• 100% Apple Virtualization: No external VM tools required

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v4.0.0

VibeCode v4.0.0

Production release with verified menubar, green console, and Datadog.

Core Features

• Menubar application (LSUIElement, NSStatusBar)
• Black console with green text (#00FF00 on #000000)
• Full Datadog monitoring integration

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v3.3.0 - Unified Services with Full Docker Support

VibeCode v3.3.0 - Unified Services with Full Docker Support

Features

• 5-Service Architecture (SSH, Valkey, PostgreSQL, OpenVSCode, Docker)
• Datadog VSCode Extension v2.0.0 (41MB monitoring)

CRITICAL: macOS Tahoe (10.15 Catalina) or later required

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v3.2.1

VibeCode v3.2.1 - Datadog VSCode Extension Integration

Enhanced the unified services app with Datadog VSCode extension for improved code analysis and monitoring capabilities.

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v3.2.0

VibeCode v3.2.0 - Unified Services macOS App

Complete Ralph Loop delivery with verified 4-service VM app:

• SSH, Valkey, PostgreSQL, OpenVSCode in single menubar app
• Localhost port forwarding with automatic IP detection

---

Code-only milestone release. No binary assets. Source code available via the tag.

VibeCode v2.0.0-phase1-complete

VibeCode v2.0.0 - Phase 1 Complete

Release v2.0.0: Phase 1 Complete - Foundation Built.
Wave 12-13 successfully completed with 117 agents deployed.

• ChatInterface component (PR #774)
• FileUploadInterface component (PR #775)

---

Code-only milestone release. No binary assets. Source code available via the tag.