agentvibes 2.9.7 → 2.12.0

package/.claude/hooks/bmad-party-manager.sh

@@ -1,225 +0,0 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/bmad-party-manager.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview BMAD Party Mode Voice Integration Manager
-# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
-# @architecture Opt-out flag management, auto-detection, status reporting
-# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
-# @entrypoints /agent-vibes:bmad-party slash command
-# @patterns Auto-enable with opt-out, graceful degradation, feature detection
-# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
-
-# Fix locale warnings
-export LC_ALL=C
-
-PLUGIN_DIR=".claude/plugins"
-DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
-BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
-BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
-
-# Colors
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-RED='\033[0;31m'
-CYAN='\033[0;36m'
-GRAY='\033[0;90m'
-NC='\033[0m' # No Color
-
-#
-# @function is_bmad_installed
-# @context Check if BMAD v6 is installed
-# @returns 0=installed, 1=not installed
-#
-is_bmad_installed() {
-  [[ -f "$BMAD_MANIFEST" ]]
-}
-
-#
-# @function is_bmad_voices_enabled
-# @context Check if BMAD voice plugin is enabled
-# @returns 0=enabled, 1=disabled
-#
-is_bmad_voices_enabled() {
-  [[ -f "$BMAD_VOICES_FLAG" ]]
-}
-
-#
-# @function is_party_mode_enabled
-# @context Check if party mode voice integration is enabled
-# @returns 0=enabled, 1=disabled
-#
-is_party_mode_enabled() {
-  # Disabled if opt-out flag exists
-  [[ -f "$DISABLE_FLAG" ]] && return 1
-
-  # Enabled if BMAD + voice plugin active
-  is_bmad_installed && is_bmad_voices_enabled
-}
-
-#
-# @function show_status
-# @context Display current party mode voice integration status
-#
-show_status() {
-  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo ""
-
-  # Check BMAD installation
-  if ! is_bmad_installed; then
-    echo -e "${RED}❌ BMAD not installed${NC}"
-    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
-    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
-    echo ""
-    return 1
-  fi
-
-  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
-
-  # Check voice plugin
-  if ! is_bmad_voices_enabled; then
-    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
-    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
-    echo ""
-    return 1
-  fi
-
-  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
-
-  # Check party mode status
-  if is_party_mode_enabled; then
-    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
-    echo ""
-    echo -e "${CYAN}How it works:${NC}"
-    echo "  When you run /bmad:core:workflows:party-mode,"
-    echo "  each agent speaks with their unique voice:"
-    echo ""
-    echo "  🏗️  Winston (Architect) → Michael"
-    echo "  📋 John (PM) → Jessica Anne Bogart"
-    echo "  💻 Amelia (Dev) → Matthew Schmitz"
-    echo "  📊 Mary (Analyst) → kristin"
-    echo "  ... and more!"
-    echo ""
-    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
-  else
-    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
-    echo ""
-    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
-  fi
-
-  echo ""
-}
-
-#
-# @function enable_party_mode
-# @context Enable party mode voice integration (remove opt-out flag)
-#
-enable_party_mode() {
-  # Verify prerequisites
-  if ! is_bmad_installed; then
-    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
-    echo -e "${GRAY}   Install BMAD v6 first${NC}"
-    return 1
-  fi
-
-  if ! is_bmad_voices_enabled; then
-    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
-    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
-    return 1
-  fi
-
-  # Remove opt-out flag if it exists
-  if [[ -f "$DISABLE_FLAG" ]]; then
-    rm -f "$DISABLE_FLAG"
-    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
-    echo ""
-    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
-    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
-  else
-    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
-    echo ""
-    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
-  fi
-
-  echo ""
-}
-
-#
-# @function disable_party_mode
-# @context Disable party mode voice integration (create opt-out flag)
-#
-disable_party_mode() {
-  mkdir -p "$PLUGIN_DIR"
-
-  if [[ -f "$DISABLE_FLAG" ]]; then
-    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
-    return 0
-  fi
-
-  # Create opt-out flag
-  touch "$DISABLE_FLAG"
-
-  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
-  echo ""
-  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
-  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
-  echo ""
-}
-
-# Main command dispatcher
-case "${1:-status}" in
-  enable)
-    enable_party_mode
-    ;;
-  disable)
-    disable_party_mode
-    ;;
-  status)
-    show_status
-    ;;
-  *)
-    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
-    echo ""
-    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
-    echo ""
-    echo "Commands:"
-    echo "  enable     Enable party mode voice integration"
-    echo "  disable    Disable party mode voice integration (opt-out)"
-    echo "  status     Show current status and configuration"
-    echo ""
-    echo "Party Mode Voice Integration:"
-    echo "  • Auto-enabled when BMAD v6 detected"
-    echo "  • Each agent speaks with unique voice during party mode"
-    echo "  • Opt-out available via disable command"
-    ;;
-esac

package/.claude/hooks/stop.sh

@@ -1,221 +0,0 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/user-prompt-output.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview Auto-detects emoji markers and BMAD party mode in Claude's output and triggers TTS
-# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and BMAD party mode agent dialogues
-# @architecture Stdin reader, regex matcher, async TTS trigger, agent voice switching
-# @dependencies play-tts.sh, tts-verbosity.txt, bmad-voice-manager.sh, .bmad/_cfg/agent-manifest.csv
-# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
-# @patterns Text stream processing, background job execution, marker-based triggers, party mode detection
-# @related session-start-tts.sh, verbosity-manager.sh, bmad-voice-manager.sh, Issue #32, Issue #33
-# @aiNotes This hook enables natural emoji-based TTS + BMAD party mode voice switching
-
-# Fix locale warnings
-export LC_ALL=C
-
-# Get script directory and project root
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
-
-# Read JSON input from stdin
-INPUT=$(cat)
-
-# Extract transcript path from JSON
-TRANSCRIPT_PATH=$(echo "$INPUT" | grep -o '"transcript_path":"[^"]*"' | cut -d'"' -f4)
-
-# If no transcript path, exit (shouldn't happen but be safe)
-[[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]] && exit 0
-
-# Get the last assistant message from transcript
-# The transcript is JSONL format - each line is a JSON object
-# Extract all text content blocks from the last message and join them
-LAST_RESPONSE=$(tail -1 "$TRANSCRIPT_PATH" | jq -r '.message.content[] | select(.type == "text") | .text' 2>/dev/null)
-
-# Get verbosity level
-VERBOSITY=$(cat "$PROJECT_ROOT/.claude/tts-verbosity.txt" 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
-
-# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
-[[ ! -f "$PLAY_TTS" ]] && exit 0
-
-#
-# @function extract_and_speak
-# @context Extracts text after emoji markers and triggers TTS asynchronously
-# @architecture Uses grep to find markers, extracts text, launches TTS in background
-# @dependencies play-tts.sh
-# @entrypoints Called based on verbosity level
-# @aiNotes Background execution (&) prevents blocking Claude's output
-#
-extract_and_speak() {
-  local pattern="$1"
-
-  # Extract lines matching the pattern
-  # Pattern format: "emoji text" or "emoji [text]"
-  while IFS= read -r line; do
-    # Try to extract text after emoji
-    # Handles formats: "💭 text", "💭 [text]", "💭text"
-    if echo "$line" | grep -qE "$pattern"; then
-      # Extract everything after the emoji (and optional space/bracket)
-      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
-
-      # Skip if text is empty or too short
-      [[ -z "$text" || ${#text} -lt 3 ]] && continue
-
-      # Speak it in background (don't block)
-      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
-    fi
-  done <<< "$LAST_RESPONSE"
-}
-
-#
-# @function is_party_mode_enabled
-# @context Check if BMAD party mode voice integration is enabled
-# @architecture Auto-enable for BMAD users, opt-out via disable flag
-# @dependencies .bmad/_cfg/agent-manifest.csv, .claude/config/bmad-voices-enabled.flag
-# @returns 0=enabled, 1=disabled
-# @aiNotes Auto-enabled when BMAD detected, respects opt-out flag for user control
-#
-is_party_mode_enabled() {
-  # Explicit opt-out takes precedence
-  [[ -f "$PROJECT_ROOT/.claude/plugins/bmad-party-mode-disabled.flag" ]] && return 1
-
-  # Auto-enable if BMAD detected + voice plugin enabled
-  if [[ -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]] && \
-     [[ -f "$PROJECT_ROOT/.claude/config/bmad-voices-enabled.flag" ]]; then
-    return 0
-  fi
-
-  return 1
-}
-
-#
-# @function map_display_name_to_agent_id
-# @context Map BMAD agent display name to agent ID for voice lookup
-# @architecture Parses agent-manifest.csv, matches displayName column to name column
-# @dependencies .bmad/_cfg/agent-manifest.csv
-# @param $1 Display name (e.g., "Winston", "John", "Amelia")
-# @returns Agent ID (e.g., "architect", "pm", "dev") or empty string if not found
-# @aiNotes Case-insensitive matching, handles quoted CSV values
-#
-map_display_name_to_agent_id() {
-  local display_name="$1"
-
-  # Check for BMAD v6 manifest
-  if [[ ! -f "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" ]]; then
-    return 1
-  fi
-
-  # CSV format: name,displayName,title,icon,role,...
-  # Extract 'name' (column 1) where displayName (column 2) matches
-  # Case-insensitive grep, remove quotes, get first match
-  local agent_id=$(grep -i ",\"*${display_name}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
-                   head -1 | \
-                   cut -d',' -f1 | \
-                   tr -d '"')
-
-  echo "$agent_id"
-}
-
-#
-# @function detect_and_speak_party_mode_dialogue
-# @context Detect BMAD party mode agent responses and speak with agent-specific voices
-# @architecture Pattern matches [Agent Name]: format, maps to agent voice, triggers TTS
-# @dependencies map_display_name_to_agent_id, bmad-voice-manager.sh, play-tts.sh
-# @aiNotes Runs in background to avoid blocking, graceful fallback for unmapped agents
-#
-detect_and_speak_party_mode_dialogue() {
-  # Pattern: [Agent Name]: dialogue
-  # Must start at beginning of line, agent name can include spaces/hyphens
-  while IFS= read -r line; do
-    if echo "$line" | grep -qE '^\[([A-Za-z\s-]+)\]:'; then
-      # Extract agent display name and dialogue
-      local agent_name=$(echo "$line" | sed -E 's/^\[([A-Za-z\s-]+)\]:.*/\1/')
-      local dialogue=$(echo "$line" | sed -E 's/^\[[^]]+\]:[[:space:]]*//')
-
-      # Skip if dialogue is empty or too short
-      [[ -z "$dialogue" || ${#dialogue} -lt 3 ]] && continue
-
-      # Map display name to agent ID
-      local agent_id=$(map_display_name_to_agent_id "$agent_name")
-
-      # Get agent's voice from bmad-voice-manager.sh
-      local agent_voice=""
-      if [[ -n "$agent_id" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
-        agent_voice=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$agent_id" 2>/dev/null)
-      fi
-
-      # Speak with agent's voice (or default if not mapped)
-      # Run in foreground to ensure audio completes
-      if [[ -n "$agent_voice" ]]; then
-        bash "$PLAY_TTS" "$dialogue" "$agent_voice" &
-      else
-        # Fallback to default voice if agent not in voice mapping
-        bash "$PLAY_TTS" "$dialogue" &
-      fi
-    fi
-  done
-}
-
-# Process based on verbosity level
-case "$VERBOSITY" in
-  high)
-    # HIGH: Speak ALL markers (💭 🤔 ✓)
-    # Don't speak ✅ here - that's handled by manual TTS completion call
-    extract_and_speak "💭|🤔|✓"
-    ;;
-
-  medium)
-    # MEDIUM: Speak decisions and findings (🤔 ✓)
-    extract_and_speak "🤔|✓"
-    ;;
-
-  low)
-    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
-    # Don't process any markers
-    ;;
-esac
-
-# BMAD Party Mode Integration (Issue #33)
-# Auto-enabled for BMAD users, opt-out available
-if is_party_mode_enabled; then
-  # Detect party mode activation announcement
-  if echo "$LAST_RESPONSE" | grep -q "🎉 PARTY MODE ACTIVATED! 🎉"; then
-    bash "$PLAY_TTS" "Party Mode Activated! All agents are here for a group discussion!" &
-  fi
-
-  # Detect agent dialogues
-  echo "$LAST_RESPONSE" | detect_and_speak_party_mode_dialogue
-fi
-
-# Exit successfully
-exit 0

package/.claude/piper-voices-dir.txt

@@ -1 +0,0 @@
-/home/fire/.claude/piper-voices

package/.mcp.json

@@ -1,88 +0,0 @@
-{
-  "mcpServers": {
-    "sentry": {
-      "command": "npx",
-      "args": [
-        "@sentry/mcp-server@latest",
-        "--host=sentry.io"
-      ],
-      "env": {
-        "SENTRY_ACCESS_TOKEN": "${SENTRY_ACCESS_TOKEN}",
-        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
-      }
-    },
-     "whatsapp": {
-      "command": "/home/fire/.local/bin/uv",
-      "args": [
-        "--directory",
-        "/home/fire/claude/whatsapp-mcp/whatsapp-mcp-server",
-        "run",
-        "main.py"
-      ]
-    },
-     "chrome-devtools": {
-      "command": "/home/fire/.nvm/versions/node/v22.20.0/bin/npx",
-      "args": [
-        "chrome-devtools-mcp@latest",
-        "--browserUrl=http://localhost:9222"
-      ],
-      "env": {
-        "PATH": "/home/fire/.nvm/versions/node/v22.20.0/bin:${PATH}",
-        "NODE_PATH": "/home/fire/.nvm/versions/node/v22.20.0/lib/node_modules"
-      }
-    },
-    "obsidian": {
-      "command": "/home/fire/.local/bin/uv",
-      "args": [
-        "--directory",
-        "/home/fire/claude/mcp_obsidian",
-        "run",
-        "mcp-obsidian"
-      ],
-      "env": {
-        "OBSIDIAN_API_KEY": "${MAIN_VAULT_OBSIDIAN_KEY}",
-        "OBSIDIAN_HOST": "${OBSIDIAN_HOST:-127.0.0.1}",
-        "OBSIDIAN_PORT": "27124",
-        "OBSIDIAN_HTTPS": "true",
-        "OBSIDIAN_VERIFY_SSL": "false"
-      }
-    },
-    "elevenlabs": {
-      "command": "npx",
-      "args": ["@microagents/mcp-server-elevenlabs"],
-      "env": {
-        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}",
-        "ELEVENLABS_MCP_BASE_PATH": "/home/fire/claude/SoraSage/teams/team-10/dev__globify__production/.claude/audio"
-      }
-    },
-    "spaceship": {
-      "command": "node",
-      "args": [
-        "/home/fire/claude/spaceship-mcp/dist/index.js"
-      ],
-      "env": {
-        "SPACESHIP_API_KEY": "${SPACESHIP_API_KEY}",
-        "SPACESHIP_API_SECRET": "${SPACESHIP_API_SECRET}"
-      }
-    },
-    "sonarqube": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--name",
-        "sonarqube-mcp-server-agentvibes",
-        "--rm",
-        "-e",
-        "SONARQUBE_TOKEN",
-        "-e",
-        "SONARQUBE_ORG",
-        "mcp/sonarqube"
-      ],
-      "env": {
-        "SONARQUBE_TOKEN": "${AGENTVIBES_SONARQUBE_TOKEN}",
-        "SONARQUBE_ORG": "${AGENTVIBES_SONARQUBE_ORG}"
-      }
-    }
-  }
-}

package/RELEASE_NOTES_v2.4.0_DRAFT.md

@@ -1,116 +0,0 @@
-# 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