agentvibes 2.3.0 → 2.4.0

package/.claude/hooks/piper-installer.sh

@@ -46,12 +46,21 @@ echo "🎤 Piper TTS Installer"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 
-# Check if running on WSL or Linux
-if ! grep -qi microsoft /proc/version 2>/dev/null && [[ "$(uname -s)" != "Linux" ]]; then
-  echo "❌ Piper TTS is only supported on WSL and Linux"
-  echo "   Your platform: $(uname -s)"
+# Detect platform
+PLATFORM="$(uname -s)"
+ARCH="$(uname -m)"
+
+# Check if running on macOS, WSL, or Linux
+if [[ "$PLATFORM" == "Darwin" ]]; then
+  IS_MACOS=true
+  echo "🍎 Detected macOS"
+elif grep -qi microsoft /proc/version 2>/dev/null || [[ "$PLATFORM" == "Linux" ]]; then
+  IS_MACOS=false
+  echo "🐧 Detected Linux/WSL"
+else
+  echo "❌ Unsupported platform: $PLATFORM"
   echo ""
-  echo "   For macOS/Windows, use ElevenLabs instead:"
+  echo "   For Windows, use ElevenLabs instead:"
   echo "   /agent-vibes:provider switch elevenlabs"
   exit 1
 fi
@@ -69,49 +78,118 @@ fi
 echo "📦 Installing Piper TTS..."
 echo ""
 
-# Check if pipx is installed
-if ! command -v pipx &> /dev/null; then
-  echo "⚠️  pipx not found. Installing pipx first..."
+# macOS: Use precompiled binaries
+if [[ "$IS_MACOS" == true ]]; then
+  echo "🍎 Installing Piper TTS from precompiled binaries for macOS..."
   echo ""
 
-  # Try to install pipx
-  if command -v apt-get &> /dev/null; then
-    # Debian/Ubuntu
-    sudo apt-get update
-    sudo apt-get install -y pipx
-  elif command -v brew &> /dev/null; then
-    # macOS (though Piper doesn't run on macOS)
-    brew install pipx
-  elif command -v dnf &> /dev/null; then
-    # Fedora
-    sudo dnf install -y pipx
-  elif command -v pacman &> /dev/null; then
-    # Arch Linux
-    sudo pacman -S python-pipx
+  # Determine architecture
+  if [[ "$ARCH" == "arm64" ]]; then
+    echo "Detected Apple Silicon (M1/M2/M3)"
+    PIPER_URL="https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_macos_aarch64.tar.gz"
+  elif [[ "$ARCH" == "x86_64" ]]; then
+    echo "Detected Intel Mac"
+    PIPER_URL="https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_macos_x64.tar.gz"
   else
-    echo "❌ Unable to install pipx automatically."
-    echo ""
-    echo "   Please install pipx manually:"
-    echo "   https://pipx.pypa.io/stable/installation/"
+    echo "❌ Unsupported macOS architecture: $ARCH"
     exit 1
   fi
 
-  # Ensure pipx is in PATH
-  pipx ensurepath
-  echo ""
-fi
+  # Create installation directory
+  INSTALL_DIR="$HOME/.local/bin"
+  mkdir -p "$INSTALL_DIR"
 
-# Install Piper TTS
-echo "📥 Installing Piper TTS via pipx..."
-pipx install piper-tts
+  # Download and extract
+  echo "📥 Downloading Piper from: $PIPER_URL"
+  TEMP_DIR=$(mktemp -d)
+  cd "$TEMP_DIR"
 
-if ! command -v piper &> /dev/null; then
-  echo ""
-  echo "❌ Installation completed but piper command not found in PATH"
-  echo ""
-  echo "   Try running: pipx ensurepath"
-  echo "   Then restart your terminal"
-  exit 1
+  if curl -L "$PIPER_URL" | tar -xz; then
+    echo "✅ Downloaded and extracted successfully"
+
+    # Copy binaries to ~/.local/bin
+    if [[ -d "piper" ]]; then
+      cp -r piper/* "$INSTALL_DIR/"
+      chmod +x "$INSTALL_DIR/piper"
+      chmod +x "$INSTALL_DIR/piper_phonemize"
+
+      echo "✅ Installed Piper to: $INSTALL_DIR/piper"
+
+      # Add to PATH if not already there
+      if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
+        echo ""
+        echo "⚠️  Add $INSTALL_DIR to your PATH:"
+        echo ""
+        if [[ "$SHELL" == *"zsh"* ]]; then
+          echo "   echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.zshrc"
+          echo "   source ~/.zshrc"
+        else
+          echo "   echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.bash_profile"
+          echo "   source ~/.bash_profile"
+        fi
+      fi
+    else
+      echo "❌ Failed to extract Piper binaries"
+      cd -
+      rm -rf "$TEMP_DIR"
+      exit 1
+    fi
+  else
+    echo "❌ Failed to download Piper"
+    cd -
+    rm -rf "$TEMP_DIR"
+    exit 1
+  fi
+
+  cd -
+  rm -rf "$TEMP_DIR"
+
+# Linux/WSL: Use pipx
+else
+  # Check if pipx is installed
+  if ! command -v pipx &> /dev/null; then
+    echo "⚠️  pipx not found. Installing pipx first..."
+    echo ""
+
+    # Try to install pipx
+    if command -v apt-get &> /dev/null; then
+      # Debian/Ubuntu
+      sudo apt-get update
+      sudo apt-get install -y pipx
+    elif command -v brew &> /dev/null; then
+      # Linux with Homebrew
+      brew install pipx
+    elif command -v dnf &> /dev/null; then
+      # Fedora
+      sudo dnf install -y pipx
+    elif command -v pacman &> /dev/null; then
+      # Arch Linux
+      sudo pacman -S python-pipx
+    else
+      echo "❌ Unable to install pipx automatically."
+      echo ""
+      echo "   Please install pipx manually:"
+      echo "   https://pipx.pypa.io/stable/installation/"
+      exit 1
+    fi
+
+    # Ensure pipx is in PATH
+    pipx ensurepath
+    echo ""
+  fi
+
+  # Install Piper TTS
+  echo "📥 Installing Piper TTS via pipx..."
+  pipx install piper-tts
+
+  if ! command -v piper &> /dev/null; then
+    echo ""
+    echo "❌ Installation completed but piper command not found in PATH"
+    echo ""
+    echo "   Try running: pipx ensurepath"
+    echo "   Then restart your terminal"
+    exit 1
+  fi
 fi
 
 echo ""

package/README.md

@@ -6,12 +6,12 @@
 >
 > Professional text-to-speech for **Claude Code**, **Claude Desktop**, and **Warp Terminal** - **ElevenLabs AI** or **Piper TTS (Free!)**
 
-[![npm version](https://img.shields.io/npm/v/agentvibes?color=blue)](https://www.npmjs.com/package/agentvibes)
+[![npm version](https://img.shields.io/npm/v/agentvibes)](https://www.npmjs.com/package/agentvibes)
 [![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.2.3
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.4.0
 
 ---
 
@@ -92,16 +92,15 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.2.0 - Provider-Aware Features, BMAD v6 Support & MCP Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.2.3)** 🎉
+**[v2.4.0 - macOS Piper TTS Support](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.4.0)** 🎉
 
-Major enhancements to multi-provider support, BMAD integration, and MCP server configuration! This release makes AgentVibes smarter about which TTS provider you're using and adds full support for BMAD-METHOD v6-alpha.
+This release brings **full Piper TTS support to macOS** via precompiled binaries! Mac users can now enjoy completely free offline TTS with zero Python dependencies. The installer automatically detects your Mac architecture (Intel or Apple Silicon) and downloads the appropriate binary.
 
 **Key highlights:**
-- 🎯 **Provider-Aware Voice Switching** - Automatically detects and uses the correct provider (ElevenLabs or Piper)
-- 🤖 **BMAD v6 Support** - Full backward compatibility with v4, with improved agent voice mappings
-- 🔧 **MCP NPX Fix** - Corrected NPX configuration for seamless MCP server setup
-- ✨ **Improved Installer UX** - Cleaner prompts and better visual formatting
-- 🎭 **Better Voice Mappings** - Provider-aware BMAD agent voices (PM: Ryan, Analyst: Kristin)
+- 🍎 **macOS Piper TTS Support** - Install via precompiled binaries (no Python/pipx needed!)
+- 🏗️ **Architecture Auto-Detection** - Supports both Apple Silicon (M1/M2/M3) and Intel Macs
+- 🐛 **Fixed Installation Issues** - Resolved pipx dependency conflicts on macOS
+- ✅ **Comprehensive CI Testing** - Validated across 9 macOS configurations (macOS 13/14/15)
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 

package/RELEASE_NOTES.md

@@ -1,4 +1,121 @@
-# AgentVibes Release Notes
+# Release v2.4.0 - macOS Piper TTS Support (2025-01-15)
+
+## 🤖 AI Summary
+
+This minor release brings **full Piper TTS support to macOS** via precompiled binaries, eliminating the Python dependency conflicts that previously prevented macOS users from using free offline TTS. Mac users can now install Piper TTS with zero Python dependencies - just download and run! The installer automatically detects your Mac architecture (Intel or Apple Silicon) and downloads the appropriate binary. This release also includes comprehensive GitHub Actions CI testing to validate Piper installation across all macOS versions (13, 14, 15) and both architectures.
+
+## 📋 Changes
+
+### ✨ New Features
+- **macOS Piper TTS Support via Precompiled Binaries**
+  - Downloads official Piper binaries from rhasspy/piper releases
+  - Automatic architecture detection (Apple Silicon M1/M2/M3 vs Intel)
+  - Installs to `~/.local/bin/piper` with no Python dependencies
+  - Zero pipx or pip conflicts - pure binary installation
+  - Supports both `arm64` (Apple Silicon) and `x86_64` (Intel) architectures
+
+- **Comprehensive macOS CI Testing**
+  - Tests Piper binary installation on macOS 13, 14, and 15
+  - Tests user-reported `--no-deps` pip workaround method
+  - Validates both Intel and Apple Silicon architectures
+  - Confirms standard pipx failure and binary success
+  - Runs across 9 macOS configurations (3 OS × 3 Node versions)
+
+### 🐛 Bug Fixes
+- **Fixed macOS Piper Installation Failures**
+  - Resolved pipx dependency conflict issues reported by users
+  - Removed incorrect platform restriction blocking macOS
+  - Fixed "Piper TTS is only supported on WSL and Linux" error
+
+### 📚 Documentation
+- **Updated Provider Documentation**
+  - Corrected platform support matrix to include macOS
+  - Added macOS-specific installation requirements
+  - Clarified binary vs pipx installation methods
+  - Updated "Choose Piper TTS if" section with macOS callout
+
+- **Installer Script Documentation**
+  - Added platform detection logic documentation
+  - Documented binary download and extraction process
+  - Added PATH setup instructions for macOS users
+
+### 🔧 Maintenance
+- **Refactored Release Process**
+  - Extracted `showReleaseInfo()` function for code reuse
+  - Added critical ordering warning to `/release` command
+  - Documented README update before npm publish requirement
+
+## 🎯 User Impact
+
+**For macOS Users**: You can now use **completely free offline Piper TTS** on your Mac! No more ElevenLabs API key required. No more Python/pipx dependency hell. Just run `.claude/hooks/piper-installer.sh` and you're done. Works on both Intel Macs and Apple Silicon (M1/M2/M3).
+
+**For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
+
+**Installation is Simple**:
+```bash
+# Run AgentVibes installer
+npx agentvibes install --yes
+
+# Or directly run Piper installer
+.claude/hooks/piper-installer.sh
+
+# Add to PATH (if needed)
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+**Architecture Support**:
+- ✅ Apple Silicon (M1/M2/M3): Downloads `piper_macos_aarch64.tar.gz`
+- ✅ Intel Mac (x86_64): Downloads `piper_macos_x64.tar.gz`
+
+## 📦 Files Changed
+
+### Modified
+- `.claude/hooks/piper-installer.sh` - Added macOS binary installation support
+- `.github/workflows/test-macos.yml` - Added comprehensive Piper installation tests
+- `docs/providers.md` - Updated macOS support documentation
+- `.claude/commands/release.md` - Added README update ordering warning
+- `src/installer.js` - Refactored release info display
+
+### Statistics
+- 5 files changed
+- 241 insertions(+)
+- 130 deletions(-)
+
+## 🔄 Breaking Changes
+
+None. This release is fully backward compatible. Linux/WSL users continue using pipx installation, macOS users now get binary installation.
+
+## 🚀 Upgrade Notes
+
+Simply run:
+```bash
+npx agentvibes@latest install --yes
+```
+
+Existing configurations are preserved. If you're on macOS and previously couldn't install Piper, it will work now!
+
+## 🙏 Credits
+
+Special thanks to:
+- **BMadCode** for reporting the macOS installation issue
+- **rhasspy/piper** project for providing macOS binaries
+- Community members who suggested the `--no-deps` workaround
+
+## 📊 Testing
+
+This release includes extensive CI testing:
+- ✅ 9 macOS configurations (macOS 13/14/15 × Node 18/20/22)
+- ✅ Both architecture types (Intel and Apple Silicon)
+- ✅ Binary download and extraction validation
+- ✅ Piper execution tests
+- ✅ Fallback to pipx testing (confirms original issue)
+
+---
+
+**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.3.1...v2.4.0
+
+---
 
 ## v2.3.0 - Command Visibility Management & Maintenance (2025-11-06)
 
@@ -103,4 +220,122 @@ This patch release improves the user experience during installation and updates
 
 ### 🤖 AI Summary
 
-Major enhancements to multi-provider support, BMAD integration, and MCP server configuration! This release makes AgentVibes smarter about which TTS provider you're using and adds full support for BMAD-METHOD v6-alpha with complete backward compatibility to v4.
+Major enhancements to multi-provider support, BMAD integration, and MCP server configuration! This release makes AgentVibes smarter about which TTS provider you're using and adds full support for BMAD-METHOD v6-alpha with complete backward compatibility to v4.# Release v2.4.0 - macOS Piper TTS Support (2025-01-15)
+
+## 🤖 AI Summary
+
+This minor release brings **full Piper TTS support to macOS** via precompiled binaries, eliminating the Python dependency conflicts that previously prevented macOS users from using free offline TTS. Mac users can now install Piper TTS with zero Python dependencies - just download and run! The installer automatically detects your Mac architecture (Intel or Apple Silicon) and downloads the appropriate binary. This release also includes comprehensive GitHub Actions CI testing to validate Piper installation across all macOS versions (13, 14, 15) and both architectures.
+
+## 📋 Changes
+
+### ✨ New Features
+- **macOS Piper TTS Support via Precompiled Binaries**
+  - Downloads official Piper binaries from rhasspy/piper releases
+  - Automatic architecture detection (Apple Silicon M1/M2/M3 vs Intel)
+  - Installs to `~/.local/bin/piper` with no Python dependencies
+  - Zero pipx or pip conflicts - pure binary installation
+  - Supports both `arm64` (Apple Silicon) and `x86_64` (Intel) architectures
+
+- **Comprehensive macOS CI Testing**
+  - Tests Piper binary installation on macOS 13, 14, and 15
+  - Tests user-reported `--no-deps` pip workaround method
+  - Validates both Intel and Apple Silicon architectures
+  - Confirms standard pipx failure and binary success
+  - Runs across 9 macOS configurations (3 OS × 3 Node versions)
+
+### 🐛 Bug Fixes
+- **Fixed macOS Piper Installation Failures**
+  - Resolved pipx dependency conflict issues reported by users
+  - Removed incorrect platform restriction blocking macOS
+  - Fixed "Piper TTS is only supported on WSL and Linux" error
+
+### 📚 Documentation
+- **Updated Provider Documentation**
+  - Corrected platform support matrix to include macOS
+  - Added macOS-specific installation requirements
+  - Clarified binary vs pipx installation methods
+  - Updated "Choose Piper TTS if" section with macOS callout
+
+- **Installer Script Documentation**
+  - Added platform detection logic documentation
+  - Documented binary download and extraction process
+  - Added PATH setup instructions for macOS users
+
+### 🔧 Maintenance
+- **Refactored Release Process**
+  - Extracted `showReleaseInfo()` function for code reuse
+  - Added critical ordering warning to `/release` command
+  - Documented README update before npm publish requirement
+
+## 🎯 User Impact
+
+**For macOS Users**: You can now use **completely free offline Piper TTS** on your Mac! No more ElevenLabs API key required. No more Python/pipx dependency hell. Just run `.claude/hooks/piper-installer.sh` and you're done. Works on both Intel Macs and Apple Silicon (M1/M2/M3).
+
+**For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
+
+**Installation is Simple**:
+```bash
+# Run AgentVibes installer
+npx agentvibes install --yes
+
+# Or directly run Piper installer
+.claude/hooks/piper-installer.sh
+
+# Add to PATH (if needed)
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+**Architecture Support**:
+- ✅ Apple Silicon (M1/M2/M3): Downloads `piper_macos_aarch64.tar.gz`
+- ✅ Intel Mac (x86_64): Downloads `piper_macos_x64.tar.gz`
+
+## 📦 Files Changed
+
+### Modified
+- `.claude/hooks/piper-installer.sh` - Added macOS binary installation support
+- `.github/workflows/test-macos.yml` - Added comprehensive Piper installation tests
+- `docs/providers.md` - Updated macOS support documentation
+- `.claude/commands/release.md` - Added README update ordering warning
+- `src/installer.js` - Refactored release info display
+
+### Statistics
+- 5 files changed
+- 241 insertions(+)
+- 130 deletions(-)
+
+## 🔄 Breaking Changes
+
+None. This release is fully backward compatible. Linux/WSL users continue using pipx installation, macOS users now get binary installation.
+
+## 🚀 Upgrade Notes
+
+Simply run:
+```bash
+npx agentvibes@latest install --yes
+```
+
+Existing configurations are preserved. If you're on macOS and previously couldn't install Piper, it will work now!
+
+## 🙏 Credits
+
+Special thanks to:
+- **BMadCode** for reporting the macOS installation issue
+- **rhasspy/piper** project for providing macOS binaries
+- Community members who suggested the `--no-deps` workaround
+
+## 📊 Testing
+
+This release includes extensive CI testing:
+- ✅ 9 macOS configurations (macOS 13/14/15 × Node 18/20/22)
+- ✅ Both architecture types (Intel and Apple Silicon)
+- ✅ Binary download and extraction validation
+- ✅ Piper execution tests
+- ✅ Fallback to pipx testing (confirms original issue)
+
+---
+
+**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.3.1...v2.4.0
+
+---
+

package/docs/providers.md

@@ -27,14 +27,15 @@ AgentVibes v2.0 introduces **multi-provider TTS support** - choose between premi
 - 50+ neural voices, completely free
 - 18 languages supported
 - No API key required
-- Works offline (perfect for Windows, WSL, and Linux)
+- Works offline (perfect for all platforms!)
 - Privacy-focused local processing
-- Cross-platform support (Windows, macOS, Linux)
+- Cross-platform support (Windows, macOS, Linux, WSL)
 
 **Requirements:**
-- None! Works out of the box
+- **macOS**: Precompiled binaries (no Python dependencies!)
+- **Linux/WSL**: Python pipx (auto-installed)
+- **Windows**: Native support - no additional setup
 - Automatic voice download on first use
-- Native Windows support - no additional setup needed
 
 ## Provider Commands
 
@@ -100,12 +101,13 @@ If ElevenLabs API key is missing, AgentVibes automatically falls back to Piper T
 - You have a budget for API costs
 
 **Choose Piper TTS if:**
-- You want completely free TTS (especially great for Windows!)
+- You want completely free TTS (works on ALL platforms!)
 - You prefer offline/local processing
-- You're on Windows, WSL, or Linux
+- You're on macOS, Windows, WSL, or Linux
 - You value privacy and data control
 - You're in development/testing phase
 - You don't want to manage API keys or billing
+- **macOS users**: Piper now works via precompiled binaries!
 
 **Pro Tip:** Use Piper for development and ElevenLabs for production/demos!
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/installer.js

@@ -104,6 +104,53 @@ function showWelcome() {
   );
 }
 
+/**
+ * Display latest release information box
+ * Shown during install and update commands
+ */
+function showReleaseInfo() {
+  console.log(
+    boxen(
+      chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
+      chalk.cyan.bold('  📦 AgentVibes v2.4.0 - macOS Piper TTS Support\n') +
+      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
+      chalk.green.bold('✨ WHAT\'S NEW:\n\n') +
+      chalk.cyan('🍎 macOS Piper TTS Support\n') +
+      chalk.gray('   • Install via precompiled binaries (no Python/pipx needed!)\n') +
+      chalk.gray('   • Architecture auto-detection (Apple Silicon M1/M2/M3 & Intel)\n') +
+      chalk.gray('   • Completely free offline TTS for Mac users\n') +
+      chalk.gray('   • Zero dependency conflicts - just download and run\n\n') +
+      chalk.cyan('🐛 Bug Fixes\n') +
+      chalk.gray('   • Fixed macOS Piper installation failures\n') +
+      chalk.gray('   • Resolved pipx dependency conflicts on macOS\n') +
+      chalk.gray('   • Removed incorrect platform restrictions\n\n') +
+      chalk.cyan('✅ Comprehensive Testing\n') +
+      chalk.gray('   • CI tests across 9 macOS configurations\n') +
+      chalk.gray('   • Validated on macOS 13, 14, and 15\n') +
+      chalk.gray('   • Tested on both Intel and Apple Silicon\n\n') +
+      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
+      chalk.green.bold('🚀 TRY LANGUAGE LEARNING MODE:\n\n') +
+      chalk.cyan('  /agent-vibes:language english\n') +
+      chalk.cyan('  /agent-vibes:target spanish\n') +
+      chalk.cyan('  /agent-vibes:learn\n\n') +
+      chalk.white('  Now while coding, you can also learn a second language\n') +
+      chalk.white('  such as Spanish, Italian, French, Mandarin, you name it! 🌍\n\n') +
+      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
+      chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
+      chalk.gray('🌐 Website: https://agentvibes.org\n') +
+      chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
+      chalk.gray('Co-created by Paul Preibisch with Claude AI\n') +
+      chalk.gray('Copyright © 2025 Paul Preibisch | Apache-2.0 License'),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'cyan',
+      }
+    )
+  );
+}
+
 /**
  * Generate BMAD activation instructions based on version
  * @param {number} version - BMAD version (4 or 6)
@@ -186,41 +233,7 @@ async function install(options = {}) {
   console.log(chalk.gray(`   Package version: ${VERSION}`));
 
   // Show AI summary of latest release
-  console.log(
-    boxen(
-      chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
-      chalk.cyan.bold('  📦 AgentVibes v2.3.0 - Command Visibility Management\n') +
-      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.green.bold('✨ WHAT\'S NEW:\n\n') +
-      chalk.cyan('👁️  Command Visibility Management\n') +
-      chalk.gray('   • Use /agent-vibes:hide to hide all slash commands from palette\n') +
-      chalk.gray('   • MCP functionality remains fully operational when hidden\n') +
-      chalk.gray('   • Perfect for users who prefer MCP tools over slash commands\n') +
-      chalk.gray('   • Use /agent-vibes:show to restore commands anytime\n\n') +
-      chalk.cyan('🔧 Maintenance Improvements\n') +
-      chalk.gray('   • Enhanced .gitignore for runtime/user-generated files\n') +
-      chalk.gray('   • Cleaner version control and repository management\n\n') +
-      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.green.bold('🚀 TRY LANGUAGE LEARNING MODE:\n\n') +
-      chalk.cyan('  /agent-vibes:language english\n') +
-      chalk.cyan('  /agent-vibes:target spanish\n') +
-      chalk.cyan('  /agent-vibes:learn\n\n') +
-      chalk.white('  Now while coding, you can also learn a second language\n') +
-      chalk.white('  such as Spanish, Italian, French, Mandarin, you name it! 🌍\n\n') +
-      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
-      chalk.gray('🌐 Website: https://agentvibes.org\n') +
-      chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
-      chalk.gray('Co-created by Paul Preibisch with Claude AI\n') +
-      chalk.gray('Copyright © 2025 Paul Preibisch | Apache-2.0 License'),
-      {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'cyan',
-      }
-    )
-  );
+  showReleaseInfo();
 
   // Provider selection prompt
   let selectedProvider = 'piper';
@@ -1115,41 +1128,7 @@ program
     console.log(chalk.gray(`   Package version: ${version}`));
 
     // Show AI summary of latest release
-    console.log(
-      boxen(
-        chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
-        chalk.cyan.bold('  📦 AgentVibes v2.3.0 - Command Visibility Management\n') +
-        chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-        chalk.green.bold('✨ WHAT\'S NEW:\n\n') +
-        chalk.cyan('👁️  Command Visibility Management\n') +
-        chalk.gray('   • Use /agent-vibes:hide to hide all slash commands from palette\n') +
-        chalk.gray('   • MCP functionality remains fully operational when hidden\n') +
-        chalk.gray('   • Perfect for users who prefer MCP tools over slash commands\n') +
-        chalk.gray('   • Use /agent-vibes:show to restore commands anytime\n\n') +
-        chalk.cyan('🔧 Maintenance Improvements\n') +
-        chalk.gray('   • Enhanced .gitignore for runtime/user-generated files\n') +
-        chalk.gray('   • Cleaner version control and repository management\n\n') +
-        chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-        chalk.green.bold('🚀 TRY LANGUAGE LEARNING MODE:\n\n') +
-        chalk.cyan('  /agent-vibes:language english\n') +
-        chalk.cyan('  /agent-vibes:target spanish\n') +
-        chalk.cyan('  /agent-vibes:learn\n\n') +
-        chalk.white('  Now while coding, you can also learn a second language\n') +
-        chalk.white('  such as Spanish, Italian, French, Mandarin, you name it! 🌍\n\n') +
-        chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-        chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
-        chalk.gray('🌐 Website: https://agentvibes.org\n') +
-        chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
-        chalk.gray('Co-created by Paul Preibisch with Claude AI\n') +
-        chalk.gray('Copyright © 2025 Paul Preibisch | Apache-2.0 License'),
-        {
-          padding: 1,
-          margin: 1,
-          borderStyle: 'round',
-          borderColor: 'cyan',
-        }
-      )
-    );
+    showReleaseInfo();
 
     // Check if already installed
     const commandsDir = path.join(targetDir, '.claude', 'commands', 'agent-vibes');