agentvibes 2.3.1 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/.claude/hooks/piper-installer.sh +118 -40
  2. package/.claude/hooks/play-tts-piper.sh +10 -2
  3. package/README.md +7 -7
  4. package/RELEASE_NOTES.md +301 -2
  5. package/docs/providers.md +8 -6
  6. package/package.json +1 -1
  7. package/src/installer.js +46 -70
  8. package/.bmad-core/agent-teams/team-all.yaml +0 -15
  9. package/.bmad-core/agent-teams/team-fullstack.yaml +0 -19
  10. package/.bmad-core/agent-teams/team-ide-minimal.yaml +0 -11
  11. package/.bmad-core/agent-teams/team-no-ui.yaml +0 -14
  12. package/.bmad-core/agents/analyst.md +0 -84
  13. package/.bmad-core/agents/architect.md +0 -85
  14. package/.bmad-core/agents/bmad-master.md +0 -110
  15. package/.bmad-core/agents/bmad-orchestrator.md +0 -147
  16. package/.bmad-core/agents/dev.md +0 -81
  17. package/.bmad-core/agents/pm.md +0 -84
  18. package/.bmad-core/agents/po.md +0 -79
  19. package/.bmad-core/agents/qa.md +0 -87
  20. package/.bmad-core/agents/sm.md +0 -65
  21. package/.bmad-core/agents/ux-expert.md +0 -69
  22. package/.bmad-core/checklists/architect-checklist.md +0 -440
  23. package/.bmad-core/checklists/change-checklist.md +0 -184
  24. package/.bmad-core/checklists/pm-checklist.md +0 -372
  25. package/.bmad-core/checklists/po-master-checklist.md +0 -434
  26. package/.bmad-core/checklists/story-dod-checklist.md +0 -96
  27. package/.bmad-core/checklists/story-draft-checklist.md +0 -155
  28. package/.bmad-core/core-config.yaml +0 -22
  29. package/.bmad-core/data/bmad-kb.md +0 -809
  30. package/.bmad-core/data/brainstorming-techniques.md +0 -38
  31. package/.bmad-core/data/elicitation-methods.md +0 -156
  32. package/.bmad-core/data/technical-preferences.md +0 -5
  33. package/.bmad-core/data/test-levels-framework.md +0 -148
  34. package/.bmad-core/data/test-priorities-matrix.md +0 -174
  35. package/.bmad-core/enhanced-ide-development-workflow.md +0 -248
  36. package/.bmad-core/install-manifest.yaml +0 -230
  37. package/.bmad-core/tasks/advanced-elicitation.md +0 -119
  38. package/.bmad-core/tasks/apply-qa-fixes.md +0 -150
  39. package/.bmad-core/tasks/brownfield-create-epic.md +0 -162
  40. package/.bmad-core/tasks/brownfield-create-story.md +0 -149
  41. package/.bmad-core/tasks/correct-course.md +0 -72
  42. package/.bmad-core/tasks/create-brownfield-story.md +0 -314
  43. package/.bmad-core/tasks/create-deep-research-prompt.md +0 -280
  44. package/.bmad-core/tasks/create-doc.md +0 -103
  45. package/.bmad-core/tasks/create-next-story.md +0 -114
  46. package/.bmad-core/tasks/document-project.md +0 -345
  47. package/.bmad-core/tasks/execute-checklist.md +0 -88
  48. package/.bmad-core/tasks/facilitate-brainstorming-session.md +0 -138
  49. package/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -53
  50. package/.bmad-core/tasks/index-docs.md +0 -175
  51. package/.bmad-core/tasks/kb-mode-interaction.md +0 -77
  52. package/.bmad-core/tasks/nfr-assess.md +0 -345
  53. package/.bmad-core/tasks/qa-gate.md +0 -163
  54. package/.bmad-core/tasks/review-story.md +0 -316
  55. package/.bmad-core/tasks/risk-profile.md +0 -355
  56. package/.bmad-core/tasks/shard-doc.md +0 -187
  57. package/.bmad-core/tasks/test-design.md +0 -176
  58. package/.bmad-core/tasks/trace-requirements.md +0 -266
  59. package/.bmad-core/tasks/validate-next-story.md +0 -136
  60. package/.bmad-core/templates/architecture-tmpl.yaml +0 -651
  61. package/.bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  62. package/.bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -477
  63. package/.bmad-core/templates/brownfield-prd-tmpl.yaml +0 -281
  64. package/.bmad-core/templates/competitor-analysis-tmpl.yaml +0 -307
  65. package/.bmad-core/templates/front-end-architecture-tmpl.yaml +0 -219
  66. package/.bmad-core/templates/front-end-spec-tmpl.yaml +0 -350
  67. package/.bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -824
  68. package/.bmad-core/templates/market-research-tmpl.yaml +0 -253
  69. package/.bmad-core/templates/prd-tmpl.yaml +0 -203
  70. package/.bmad-core/templates/project-brief-tmpl.yaml +0 -222
  71. package/.bmad-core/templates/qa-gate-tmpl.yaml +0 -103
  72. package/.bmad-core/templates/story-tmpl.yaml +0 -138
  73. package/.bmad-core/user-guide.md +0 -577
  74. package/.bmad-core/utils/bmad-doc-template.md +0 -327
  75. package/.bmad-core/utils/workflow-management.md +0 -71
  76. package/.bmad-core/workflows/brownfield-fullstack.yaml +0 -298
  77. package/.bmad-core/workflows/brownfield-service.yaml +0 -188
  78. package/.bmad-core/workflows/brownfield-ui.yaml +0 -198
  79. package/.bmad-core/workflows/greenfield-fullstack.yaml +0 -241
  80. package/.bmad-core/workflows/greenfield-service.yaml +0 -207
  81. package/.bmad-core/workflows/greenfield-ui.yaml +0 -236
  82. package/.bmad-core/working-in-the-brownfield.md +0 -606
  83. package/.claude/commands/BMad/analyst.md +0 -88
  84. package/.claude/commands/BMad/architect.md +0 -89
  85. package/.claude/commands/BMad/bmad-master.md +0 -114
  86. package/.claude/commands/BMad/bmad-orchestrator.md +0 -151
  87. package/.claude/commands/BMad/dev.md +0 -85
  88. package/.claude/commands/BMad/pm.md +0 -88
  89. package/.claude/commands/BMad/po.md +0 -83
  90. package/.claude/commands/BMad/qa.md +0 -91
  91. package/.claude/commands/BMad/sm.md +0 -69
  92. package/.claude/commands/BMad/tasks/advanced-elicitation.md +0 -123
  93. package/.claude/commands/BMad/tasks/apply-qa-fixes.md +0 -154
  94. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +0 -166
  95. package/.claude/commands/BMad/tasks/brownfield-create-story.md +0 -153
  96. package/.claude/commands/BMad/tasks/correct-course.md +0 -76
  97. package/.claude/commands/BMad/tasks/create-brownfield-story.md +0 -318
  98. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +0 -284
  99. package/.claude/commands/BMad/tasks/create-doc.md +0 -107
  100. package/.claude/commands/BMad/tasks/create-next-story.md +0 -118
  101. package/.claude/commands/BMad/tasks/document-project.md +0 -349
  102. package/.claude/commands/BMad/tasks/execute-checklist.md +0 -92
  103. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +0 -142
  104. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +0 -57
  105. package/.claude/commands/BMad/tasks/index-docs.md +0 -179
  106. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +0 -81
  107. package/.claude/commands/BMad/tasks/nfr-assess.md +0 -349
  108. package/.claude/commands/BMad/tasks/qa-gate.md +0 -167
  109. package/.claude/commands/BMad/tasks/review-story.md +0 -320
  110. package/.claude/commands/BMad/tasks/risk-profile.md +0 -359
  111. package/.claude/commands/BMad/tasks/shard-doc.md +0 -191
  112. package/.claude/commands/BMad/tasks/test-design.md +0 -180
  113. package/.claude/commands/BMad/tasks/trace-requirements.md +0 -270
  114. package/.claude/commands/BMad/tasks/validate-next-story.md +0 -140
  115. package/.claude/commands/BMad/ux-expert.md +0 -73
  116. package/.claude/github-star-reminder.txt +0 -1
  117. package/.claude/piper-voices-dir.txt +0 -1
  118. package/.claude/plugins/bmad-voices-enabled.flag +0 -0
  119. package/linkedin/vibe-coding-and-pulseaudio.md +0 -121
  120. package/mcp-server/agentvibes.db +0 -0
  121. package/scripts/audio-tunnel.config +0 -17
@@ -46,12 +46,21 @@ echo "🎤 Piper TTS Installer"
46
46
  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
47
47
  echo ""
48
48
 
49
- # Check if running on WSL or Linux
50
- if ! grep -qi microsoft /proc/version 2>/dev/null && [[ "$(uname -s)" != "Linux" ]]; then
51
- echo " Piper TTS is only supported on WSL and Linux"
52
- echo " Your platform: $(uname -s)"
49
+ # Detect platform
50
+ PLATFORM="$(uname -s)"
51
+ ARCH="$(uname -m)"
52
+
53
+ # Check if running on macOS, WSL, or Linux
54
+ if [[ "$PLATFORM" == "Darwin" ]]; then
55
+ IS_MACOS=true
56
+ echo "🍎 Detected macOS"
57
+ elif grep -qi microsoft /proc/version 2>/dev/null || [[ "$PLATFORM" == "Linux" ]]; then
58
+ IS_MACOS=false
59
+ echo "🐧 Detected Linux/WSL"
60
+ else
61
+ echo "❌ Unsupported platform: $PLATFORM"
53
62
  echo ""
54
- echo " For macOS/Windows, use ElevenLabs instead:"
63
+ echo " For Windows, use ElevenLabs instead:"
55
64
  echo " /agent-vibes:provider switch elevenlabs"
56
65
  exit 1
57
66
  fi
@@ -69,49 +78,118 @@ fi
69
78
  echo "📦 Installing Piper TTS..."
70
79
  echo ""
71
80
 
72
- # Check if pipx is installed
73
- if ! command -v pipx &> /dev/null; then
74
- echo "⚠️ pipx not found. Installing pipx first..."
81
+ # macOS: Use precompiled binaries
82
+ if [[ "$IS_MACOS" == true ]]; then
83
+ echo "🍎 Installing Piper TTS from precompiled binaries for macOS..."
75
84
  echo ""
76
85
 
77
- # Try to install pipx
78
- if command -v apt-get &> /dev/null; then
79
- # Debian/Ubuntu
80
- sudo apt-get update
81
- sudo apt-get install -y pipx
82
- elif command -v brew &> /dev/null; then
83
- # macOS (though Piper doesn't run on macOS)
84
- brew install pipx
85
- elif command -v dnf &> /dev/null; then
86
- # Fedora
87
- sudo dnf install -y pipx
88
- elif command -v pacman &> /dev/null; then
89
- # Arch Linux
90
- sudo pacman -S python-pipx
86
+ # Determine architecture
87
+ if [[ "$ARCH" == "arm64" ]]; then
88
+ echo "Detected Apple Silicon (M1/M2/M3)"
89
+ PIPER_URL="https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_macos_aarch64.tar.gz"
90
+ elif [[ "$ARCH" == "x86_64" ]]; then
91
+ echo "Detected Intel Mac"
92
+ PIPER_URL="https://github.com/rhasspy/piper/releases/download/2023.11.14-2/piper_macos_x64.tar.gz"
91
93
  else
92
- echo "❌ Unable to install pipx automatically."
93
- echo ""
94
- echo " Please install pipx manually:"
95
- echo " https://pipx.pypa.io/stable/installation/"
94
+ echo "❌ Unsupported macOS architecture: $ARCH"
96
95
  exit 1
97
96
  fi
98
97
 
99
- # Ensure pipx is in PATH
100
- pipx ensurepath
101
- echo ""
102
- fi
98
+ # Create installation directory
99
+ INSTALL_DIR="$HOME/.local/bin"
100
+ mkdir -p "$INSTALL_DIR"
103
101
 
104
- # Install Piper TTS
105
- echo "📥 Installing Piper TTS via pipx..."
106
- pipx install piper-tts
102
+ # Download and extract
103
+ echo "📥 Downloading Piper from: $PIPER_URL"
104
+ TEMP_DIR=$(mktemp -d)
105
+ cd "$TEMP_DIR"
107
106
 
108
- if ! command -v piper &> /dev/null; then
109
- echo ""
110
- echo "❌ Installation completed but piper command not found in PATH"
111
- echo ""
112
- echo " Try running: pipx ensurepath"
113
- echo " Then restart your terminal"
114
- exit 1
107
+ if curl -L "$PIPER_URL" | tar -xz; then
108
+ echo "✅ Downloaded and extracted successfully"
109
+
110
+ # Copy binaries to ~/.local/bin
111
+ if [[ -d "piper" ]]; then
112
+ cp -r piper/* "$INSTALL_DIR/"
113
+ chmod +x "$INSTALL_DIR/piper"
114
+ chmod +x "$INSTALL_DIR/piper_phonemize"
115
+
116
+ echo "✅ Installed Piper to: $INSTALL_DIR/piper"
117
+
118
+ # Add to PATH if not already there
119
+ if [[ ":$PATH:" != *":$INSTALL_DIR:"* ]]; then
120
+ echo ""
121
+ echo "⚠️ Add $INSTALL_DIR to your PATH:"
122
+ echo ""
123
+ if [[ "$SHELL" == *"zsh"* ]]; then
124
+ echo " echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.zshrc"
125
+ echo " source ~/.zshrc"
126
+ else
127
+ echo " echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.bash_profile"
128
+ echo " source ~/.bash_profile"
129
+ fi
130
+ fi
131
+ else
132
+ echo "❌ Failed to extract Piper binaries"
133
+ cd -
134
+ rm -rf "$TEMP_DIR"
135
+ exit 1
136
+ fi
137
+ else
138
+ echo "❌ Failed to download Piper"
139
+ cd -
140
+ rm -rf "$TEMP_DIR"
141
+ exit 1
142
+ fi
143
+
144
+ cd -
145
+ rm -rf "$TEMP_DIR"
146
+
147
+ # Linux/WSL: Use pipx
148
+ else
149
+ # Check if pipx is installed
150
+ if ! command -v pipx &> /dev/null; then
151
+ echo "⚠️ pipx not found. Installing pipx first..."
152
+ echo ""
153
+
154
+ # Try to install pipx
155
+ if command -v apt-get &> /dev/null; then
156
+ # Debian/Ubuntu
157
+ sudo apt-get update
158
+ sudo apt-get install -y pipx
159
+ elif command -v brew &> /dev/null; then
160
+ # Linux with Homebrew
161
+ brew install pipx
162
+ elif command -v dnf &> /dev/null; then
163
+ # Fedora
164
+ sudo dnf install -y pipx
165
+ elif command -v pacman &> /dev/null; then
166
+ # Arch Linux
167
+ sudo pacman -S python-pipx
168
+ else
169
+ echo "❌ Unable to install pipx automatically."
170
+ echo ""
171
+ echo " Please install pipx manually:"
172
+ echo " https://pipx.pypa.io/stable/installation/"
173
+ exit 1
174
+ fi
175
+
176
+ # Ensure pipx is in PATH
177
+ pipx ensurepath
178
+ echo ""
179
+ fi
180
+
181
+ # Install Piper TTS
182
+ echo "📥 Installing Piper TTS via pipx..."
183
+ pipx install piper-tts
184
+
185
+ if ! command -v piper &> /dev/null; then
186
+ echo ""
187
+ echo "❌ Installation completed but piper command not found in PATH"
188
+ echo ""
189
+ echo " Try running: pipx ensurepath"
190
+ echo " Then restart your terminal"
191
+ exit 1
192
+ fi
115
193
  fi
116
194
 
117
195
  echo ""
@@ -326,8 +326,16 @@ DURATION=${DURATION:-1} # Default to 1 second if detection fails
326
326
 
327
327
  # Play audio in background (skip if in test mode)
328
328
  if [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]]; then
329
- (mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
330
- PLAYER_PID=$!
329
+ # Detect platform and use appropriate audio player
330
+ if [[ "$(uname -s)" == "Darwin" ]]; then
331
+ # macOS: Use afplay (native macOS audio player)
332
+ afplay "$TEMP_FILE" >/dev/null 2>&1 &
333
+ PLAYER_PID=$!
334
+ else
335
+ # Linux/WSL: Try mpv, aplay, or paplay
336
+ (mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
337
+ PLAYER_PID=$!
338
+ fi
331
339
  fi
332
340
 
333
341
  # Wait for audio to finish, then release lock
package/README.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
12
12
  [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
13
13
 
14
- **Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.3.1
14
+ **Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.4.1
15
15
 
16
16
  ---
17
17
 
@@ -92,15 +92,15 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
92
92
 
93
93
  ## 📰 Latest Release
94
94
 
95
- **[v2.3.0 - Command Visibility Management & Maintenance](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.3.0)** 🎉
95
+ **[v2.4.1 - macOS Audio Playback Fix](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.4.1)** 🎉
96
96
 
97
- This minor release introduces command visibility management features allowing MCP users to hide/show AgentVibes slash commands, plus important maintenance improvements. Users who primarily interact with AgentVibes through MCP tools can now declutter their Claude Code command palette by hiding slash commands, while still retaining full MCP functionality.
97
+ This patch release fixes a critical audio playback issue on macOS where Piper TTS audio files were being created but not playing. The fix adds platform detection to use the native macOS `afplay` audio player.
98
98
 
99
99
  **Key highlights:**
100
- - 👁️ **Command Visibility Management** - Hide/show slash commands with `/agent-vibes:hide` and `/agent-vibes:show`
101
- - 🎯 **MCP Functionality Preserved** - MCP tools work perfectly even when slash commands are hidden
102
- - 🔧 **Enhanced .gitignore** - Runtime and user-generated files automatically excluded from version control
103
- - **Cleaner Command Palette** - Perfect for users who prefer MCP tools over slash commands
100
+ - 🔊 **Fixed macOS Audio Playback** - Audio now plays correctly using native `afplay` command
101
+ - 🐛 **Critical Bug Fix** - Resolved silent audio playback on macOS after v2.4.0 install
102
+ - 🙏 **Community Contribution** - Thanks to BMadCode for reporting and testing!
103
+ - 🍎 **macOS Support Complete** - Both installation (v2.4.0) and playback (v2.4.1) now working
104
104
 
105
105
  [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
106
106
 
package/RELEASE_NOTES.md CHANGED
@@ -1,4 +1,185 @@
1
- # AgentVibes Release Notes
1
+ # Release v2.4.1 - macOS Audio Playback Fix (2025-01-15)
2
+
3
+ ## 🤖 AI Summary
4
+
5
+ This patch release fixes a critical audio playback issue on macOS where Piper TTS audio files were being created but not playing. The fix adds platform detection to use the native macOS `afplay` audio player instead of trying to use Linux-only audio players (mpv/aplay/paplay) that don't exist on macOS.
6
+
7
+ ## 📋 Changes
8
+
9
+ ### 🐛 Bug Fixes
10
+ - **Fixed macOS Audio Playback in Piper TTS**
11
+ - Added platform detection to use `afplay` on macOS (Darwin)
12
+ - Keeps existing Linux audio players (mpv/aplay/paplay) for WSL/Linux
13
+ - Audio files now play correctly on macOS instead of silently failing
14
+ - File: `.claude/hooks/play-tts-piper.sh` line 329-339
15
+
16
+ ## 🎯 User Impact
17
+
18
+ **For macOS Users**: Audio playback now works! If you were seeing "🎵 Saved to:" messages but hearing no sound, this update fixes that. Simply run `npx agentvibes@latest install --yes` to get the fix.
19
+
20
+ **What Was Broken**: After v2.4.0 added macOS Piper TTS support, audio files were being generated successfully but the playback failed silently because the script was trying to use Linux audio players that don't exist on macOS.
21
+
22
+ **What's Fixed**: The script now detects macOS and uses the native `afplay` command for audio playback.
23
+
24
+ ## 📦 Files Changed
25
+
26
+ ### Modified
27
+ - `.claude/hooks/play-tts-piper.sh` - Added macOS platform detection for audio playback
28
+
29
+ ### Statistics
30
+ - 1 file changed
31
+ - 10 insertions(+)
32
+ - 2 deletions(-)
33
+
34
+ ## 🔄 Breaking Changes
35
+
36
+ None. This is a pure bug fix release.
37
+
38
+ ## 🚀 Upgrade Notes
39
+
40
+ Simply run:
41
+ ```bash
42
+ npx agentvibes@latest install --yes
43
+ ```
44
+
45
+ This will update the hooks with the fixed audio playback script.
46
+
47
+ ## 🙏 Credits
48
+
49
+ Special thanks to:
50
+ - **BMadCode** for reporting the issue and testing on macOS! (Official AgentVibes contributor 🎉)
51
+ - macOS users who helped identify the silent audio playback problem
52
+
53
+ ## 🔗 Related
54
+
55
+ - v2.4.0 - Initial macOS Piper TTS support
56
+ - Issue: Audio files created but not playing on macOS
57
+ - Fix: Platform detection for native audio player selection
58
+
59
+ ---
60
+
61
+ **Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.4.0...v2.4.1
62
+
63
+ ---
64
+
65
+ # Release v2.4.0 - macOS Piper TTS Support (2025-01-15)
66
+
67
+ ## 🤖 AI Summary
68
+
69
+ 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.
70
+
71
+ ## 📋 Changes
72
+
73
+ ### ✨ New Features
74
+ - **macOS Piper TTS Support via Precompiled Binaries**
75
+ - Downloads official Piper binaries from rhasspy/piper releases
76
+ - Automatic architecture detection (Apple Silicon M1/M2/M3 vs Intel)
77
+ - Installs to `~/.local/bin/piper` with no Python dependencies
78
+ - Zero pipx or pip conflicts - pure binary installation
79
+ - Supports both `arm64` (Apple Silicon) and `x86_64` (Intel) architectures
80
+
81
+ - **Comprehensive macOS CI Testing**
82
+ - Tests Piper binary installation on macOS 13, 14, and 15
83
+ - Tests user-reported `--no-deps` pip workaround method
84
+ - Validates both Intel and Apple Silicon architectures
85
+ - Confirms standard pipx failure and binary success
86
+ - Runs across 9 macOS configurations (3 OS × 3 Node versions)
87
+
88
+ ### 🐛 Bug Fixes
89
+ - **Fixed macOS Piper Installation Failures**
90
+ - Resolved pipx dependency conflict issues reported by users
91
+ - Removed incorrect platform restriction blocking macOS
92
+ - Fixed "Piper TTS is only supported on WSL and Linux" error
93
+
94
+ ### 📚 Documentation
95
+ - **Updated Provider Documentation**
96
+ - Corrected platform support matrix to include macOS
97
+ - Added macOS-specific installation requirements
98
+ - Clarified binary vs pipx installation methods
99
+ - Updated "Choose Piper TTS if" section with macOS callout
100
+
101
+ - **Installer Script Documentation**
102
+ - Added platform detection logic documentation
103
+ - Documented binary download and extraction process
104
+ - Added PATH setup instructions for macOS users
105
+
106
+ ### 🔧 Maintenance
107
+ - **Refactored Release Process**
108
+ - Extracted `showReleaseInfo()` function for code reuse
109
+ - Added critical ordering warning to `/release` command
110
+ - Documented README update before npm publish requirement
111
+
112
+ ## 🎯 User Impact
113
+
114
+ **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).
115
+
116
+ **For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
117
+
118
+ **Installation is Simple**:
119
+ ```bash
120
+ # Run AgentVibes installer
121
+ npx agentvibes install --yes
122
+
123
+ # Or directly run Piper installer
124
+ .claude/hooks/piper-installer.sh
125
+
126
+ # Add to PATH (if needed)
127
+ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
128
+ source ~/.zshrc
129
+ ```
130
+
131
+ **Architecture Support**:
132
+ - ✅ Apple Silicon (M1/M2/M3): Downloads `piper_macos_aarch64.tar.gz`
133
+ - ✅ Intel Mac (x86_64): Downloads `piper_macos_x64.tar.gz`
134
+
135
+ ## 📦 Files Changed
136
+
137
+ ### Modified
138
+ - `.claude/hooks/piper-installer.sh` - Added macOS binary installation support
139
+ - `.github/workflows/test-macos.yml` - Added comprehensive Piper installation tests
140
+ - `docs/providers.md` - Updated macOS support documentation
141
+ - `.claude/commands/release.md` - Added README update ordering warning
142
+ - `src/installer.js` - Refactored release info display
143
+
144
+ ### Statistics
145
+ - 5 files changed
146
+ - 241 insertions(+)
147
+ - 130 deletions(-)
148
+
149
+ ## 🔄 Breaking Changes
150
+
151
+ None. This release is fully backward compatible. Linux/WSL users continue using pipx installation, macOS users now get binary installation.
152
+
153
+ ## 🚀 Upgrade Notes
154
+
155
+ Simply run:
156
+ ```bash
157
+ npx agentvibes@latest install --yes
158
+ ```
159
+
160
+ Existing configurations are preserved. If you're on macOS and previously couldn't install Piper, it will work now!
161
+
162
+ ## 🙏 Credits
163
+
164
+ Special thanks to:
165
+ - **BMadCode** for reporting the macOS installation issue
166
+ - **rhasspy/piper** project for providing macOS binaries
167
+ - Community members who suggested the `--no-deps` workaround
168
+
169
+ ## 📊 Testing
170
+
171
+ This release includes extensive CI testing:
172
+ - ✅ 9 macOS configurations (macOS 13/14/15 × Node 18/20/22)
173
+ - ✅ Both architecture types (Intel and Apple Silicon)
174
+ - ✅ Binary download and extraction validation
175
+ - ✅ Piper execution tests
176
+ - ✅ Fallback to pipx testing (confirms original issue)
177
+
178
+ ---
179
+
180
+ **Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.3.1...v2.4.0
181
+
182
+ ---
2
183
 
3
184
  ## v2.3.0 - Command Visibility Management & Maintenance (2025-11-06)
4
185
 
@@ -103,4 +284,122 @@ This patch release improves the user experience during installation and updates
103
284
 
104
285
  ### 🤖 AI Summary
105
286
 
106
- 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.
287
+ 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)
288
+
289
+ ## 🤖 AI Summary
290
+
291
+ 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.
292
+
293
+ ## 📋 Changes
294
+
295
+ ### ✨ New Features
296
+ - **macOS Piper TTS Support via Precompiled Binaries**
297
+ - Downloads official Piper binaries from rhasspy/piper releases
298
+ - Automatic architecture detection (Apple Silicon M1/M2/M3 vs Intel)
299
+ - Installs to `~/.local/bin/piper` with no Python dependencies
300
+ - Zero pipx or pip conflicts - pure binary installation
301
+ - Supports both `arm64` (Apple Silicon) and `x86_64` (Intel) architectures
302
+
303
+ - **Comprehensive macOS CI Testing**
304
+ - Tests Piper binary installation on macOS 13, 14, and 15
305
+ - Tests user-reported `--no-deps` pip workaround method
306
+ - Validates both Intel and Apple Silicon architectures
307
+ - Confirms standard pipx failure and binary success
308
+ - Runs across 9 macOS configurations (3 OS × 3 Node versions)
309
+
310
+ ### 🐛 Bug Fixes
311
+ - **Fixed macOS Piper Installation Failures**
312
+ - Resolved pipx dependency conflict issues reported by users
313
+ - Removed incorrect platform restriction blocking macOS
314
+ - Fixed "Piper TTS is only supported on WSL and Linux" error
315
+
316
+ ### 📚 Documentation
317
+ - **Updated Provider Documentation**
318
+ - Corrected platform support matrix to include macOS
319
+ - Added macOS-specific installation requirements
320
+ - Clarified binary vs pipx installation methods
321
+ - Updated "Choose Piper TTS if" section with macOS callout
322
+
323
+ - **Installer Script Documentation**
324
+ - Added platform detection logic documentation
325
+ - Documented binary download and extraction process
326
+ - Added PATH setup instructions for macOS users
327
+
328
+ ### 🔧 Maintenance
329
+ - **Refactored Release Process**
330
+ - Extracted `showReleaseInfo()` function for code reuse
331
+ - Added critical ordering warning to `/release` command
332
+ - Documented README update before npm publish requirement
333
+
334
+ ## 🎯 User Impact
335
+
336
+ **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).
337
+
338
+ **For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
339
+
340
+ **Installation is Simple**:
341
+ ```bash
342
+ # Run AgentVibes installer
343
+ npx agentvibes install --yes
344
+
345
+ # Or directly run Piper installer
346
+ .claude/hooks/piper-installer.sh
347
+
348
+ # Add to PATH (if needed)
349
+ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
350
+ source ~/.zshrc
351
+ ```
352
+
353
+ **Architecture Support**:
354
+ - ✅ Apple Silicon (M1/M2/M3): Downloads `piper_macos_aarch64.tar.gz`
355
+ - ✅ Intel Mac (x86_64): Downloads `piper_macos_x64.tar.gz`
356
+
357
+ ## 📦 Files Changed
358
+
359
+ ### Modified
360
+ - `.claude/hooks/piper-installer.sh` - Added macOS binary installation support
361
+ - `.github/workflows/test-macos.yml` - Added comprehensive Piper installation tests
362
+ - `docs/providers.md` - Updated macOS support documentation
363
+ - `.claude/commands/release.md` - Added README update ordering warning
364
+ - `src/installer.js` - Refactored release info display
365
+
366
+ ### Statistics
367
+ - 5 files changed
368
+ - 241 insertions(+)
369
+ - 130 deletions(-)
370
+
371
+ ## 🔄 Breaking Changes
372
+
373
+ None. This release is fully backward compatible. Linux/WSL users continue using pipx installation, macOS users now get binary installation.
374
+
375
+ ## 🚀 Upgrade Notes
376
+
377
+ Simply run:
378
+ ```bash
379
+ npx agentvibes@latest install --yes
380
+ ```
381
+
382
+ Existing configurations are preserved. If you're on macOS and previously couldn't install Piper, it will work now!
383
+
384
+ ## 🙏 Credits
385
+
386
+ Special thanks to:
387
+ - **BMadCode** for reporting the macOS installation issue
388
+ - **rhasspy/piper** project for providing macOS binaries
389
+ - Community members who suggested the `--no-deps` workaround
390
+
391
+ ## 📊 Testing
392
+
393
+ This release includes extensive CI testing:
394
+ - ✅ 9 macOS configurations (macOS 13/14/15 × Node 18/20/22)
395
+ - ✅ Both architecture types (Intel and Apple Silicon)
396
+ - ✅ Binary download and extraction validation
397
+ - ✅ Piper execution tests
398
+ - ✅ Fallback to pipx testing (confirms original issue)
399
+
400
+ ---
401
+
402
+ **Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.3.1...v2.4.0
403
+
404
+ ---
405
+
package/docs/providers.md CHANGED
@@ -27,14 +27,15 @@ AgentVibes v2.0 introduces **multi-provider TTS support** - choose between premi
27
27
  - 50+ neural voices, completely free
28
28
  - 18 languages supported
29
29
  - No API key required
30
- - Works offline (perfect for Windows, WSL, and Linux)
30
+ - Works offline (perfect for all platforms!)
31
31
  - Privacy-focused local processing
32
- - Cross-platform support (Windows, macOS, Linux)
32
+ - Cross-platform support (Windows, macOS, Linux, WSL)
33
33
 
34
34
  **Requirements:**
35
- - None! Works out of the box
35
+ - **macOS**: Precompiled binaries (no Python dependencies!)
36
+ - **Linux/WSL**: Python pipx (auto-installed)
37
+ - **Windows**: Native support - no additional setup
36
38
  - Automatic voice download on first use
37
- - Native Windows support - no additional setup needed
38
39
 
39
40
  ## Provider Commands
40
41
 
@@ -100,12 +101,13 @@ If ElevenLabs API key is missing, AgentVibes automatically falls back to Piper T
100
101
  - You have a budget for API costs
101
102
 
102
103
  **Choose Piper TTS if:**
103
- - You want completely free TTS (especially great for Windows!)
104
+ - You want completely free TTS (works on ALL platforms!)
104
105
  - You prefer offline/local processing
105
- - You're on Windows, WSL, or Linux
106
+ - You're on macOS, Windows, WSL, or Linux
106
107
  - You value privacy and data control
107
108
  - You're in development/testing phase
108
109
  - You don't want to manage API keys or billing
110
+ - **macOS users**: Piper now works via precompiled binaries!
109
111
 
110
112
  **Pro Tip:** Use Piper for development and ElevenLabs for production/demos!
111
113
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "agentvibes",
4
- "version": "2.3.1",
4
+ "version": "2.4.1",
5
5
  "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
6
6
  "homepage": "https://agentvibes.org",
7
7
  "keywords": [