agentvibes 4.2.0 → 4.4.0

package/.agentvibes/bmad/bmad-voices.md

@@ -1,69 +1,69 @@
----
-plugin: bmad-voices
-version: 2.0.0
-enabled: true
-description: Provider-aware voice mappings for BMAD agents
----
-
-# BMAD Voice Plugin
-
-This plugin automatically assigns voices to BMAD agents based on their role and active TTS provider.
-
-## Agent Voice Mappings (Provider-Aware)
-
-| Agent ID | Agent Name | Intro | Piper TTS Voice | Piper Voice | Personality |
-|----------|------------|-------|------------------|-------------|-------------|
-| pm | John (Product Manager) | John, Product Manager here | Matthew Schmitz | en_US-john-medium | professional |
-| dev | Amelia (Developer) | Amelia, Developer here | Aria | en_US-amy-medium | normal |
-| analyst | Mary (Business Analyst) | Mary, Business Analyst here | Jessica Anne Bogart | en_US-kristin-medium | normal |
-| architect | Winston (Architect) | Winston, Architect here | Michael | en_GB-alan-medium | normal |
-| sm | Bob (Scrum Master) | Bob, Scrum Master here | Matthew Schmitz | en_US-joe-medium | professional |
-| tea | Murat (Test Architect) | Murat, Test Architect here | Michael | en_US-kusal-medium | normal |
-| tech-writer | Paige (Technical Writer) | Paige, Technical Writer here | Aria | en_US-lessac-medium | normal |
-| ux-designer | Sally (UX Designer) | Sally, UX Designer here | Jessica Anne Bogart | en_US-lessac-high | normal |
-| frame-expert | Saif (Visual Designer) | Saif, Visual Designer here | Matthew Schmitz | en_GB-alan-medium | normal |
-| bmad-master | BMad Master | BMad Master here | Michael | en_US-libritts-high | zen |
-| quick-flow-solo-dev | Barry (Quick Flow Solo Dev) | Barry, Quick Flow Solo Dev here | Matthew Schmitz | en_US-john-medium | professional |
-
-## How It Works
-
-The voice manager automatically selects the appropriate voice based on your active TTS provider:
-- **Piper TTS active**: Uses voices from the "Piper TTS Voice" column
-- **Piper active**: Uses voices from the "Piper Voice" column
-
-This ensures BMAD agents work seamlessly regardless of which provider you're using.
-
-### Supports Both Display Names and Agent IDs
-
-The `bmad-speak.sh` script accepts both formats:
-
-**Party Mode** (multiple agents, uses display names):
-```bash
-.claude/hooks/bmad-speak.sh "Winston" "I recommend microservices for scalability"
-```
-
-**Individual Agents** (single agent sessions, uses agent IDs):
-```bash
-.claude/hooks/bmad-speak.sh "architect" "I recommend microservices for scalability"
-```
-
-Both formats map to the same voice configuration based on the agent ID in the table above. This allows BMAD to use customizable display names while maintaining stable voice mappings.
-
-## How to Edit
-
-Simply edit the table above to change voice mappings. The format is:
-- **Agent ID**: Must match BMAD's `agent.id` field (pm, dev, qa, etc.)
-- **Agent Name**: Display name (for reference only)
-- **Intro**: Text spoken before agent's message (e.g., "John, Product Manager here"). Leave empty to disable.
-- **Piper TTS Voice**: Voice name for Piper TTS provider
-- **Piper Voice**: Voice model name for Piper provider
-- **Personality**: Optional personality to apply (or "normal" for none)
-
-## Commands
-
-- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
-- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
-- `/agent-vibes:bmad status` - Show plugin status
-- `/agent-vibes:bmad edit` - Open this file for editing
-- `/agent-vibes:bmad list` - List all agent voice mappings
-- `/agent-vibes:bmad set <agent-id> <piper-voice> <piper-voice> [personality]` - Set voices for specific agent
+---
+plugin: bmad-voices
+version: 2.0.0
+enabled: true
+description: Provider-aware voice mappings for BMAD agents
+---
+
+# BMAD Voice Plugin
+
+This plugin automatically assigns voices to BMAD agents based on their role and active TTS provider.
+
+## Agent Voice Mappings (Provider-Aware)
+
+| Agent ID | Agent Name | Intro | Piper TTS Voice | Piper Voice | Personality |
+|----------|------------|-------|------------------|-------------|-------------|
+| pm | John (Product Manager) | John, Product Manager here | Matthew Schmitz | en_US-john-medium | professional |
+| dev | Amelia (Developer) | Amelia, Developer here | Aria | en_US-amy-medium | normal |
+| analyst | Mary (Business Analyst) | Mary, Business Analyst here | Jessica Anne Bogart | en_US-kristin-medium | normal |
+| architect | Winston (Architect) | Winston, Architect here | Michael | en_GB-alan-medium | normal |
+| sm | Bob (Scrum Master) | Bob, Scrum Master here | Matthew Schmitz | en_US-joe-medium | professional |
+| tea | Murat (Test Architect) | Murat, Test Architect here | Michael | en_US-kusal-medium | normal |
+| tech-writer | Paige (Technical Writer) | Paige, Technical Writer here | Aria | en_US-lessac-medium | normal |
+| ux-designer | Sally (UX Designer) | Sally, UX Designer here | Jessica Anne Bogart | en_US-lessac-high | normal |
+| frame-expert | Saif (Visual Designer) | Saif, Visual Designer here | Matthew Schmitz | en_GB-alan-medium | normal |
+| bmad-master | BMad Master | BMad Master here | Michael | en_US-libritts-high | zen |
+| quick-flow-solo-dev | Barry (Quick Flow Solo Dev) | Barry, Quick Flow Solo Dev here | Matthew Schmitz | en_US-john-medium | professional |
+
+## How It Works
+
+The voice manager automatically selects the appropriate voice based on your active TTS provider:
+- **Piper TTS active**: Uses voices from the "Piper TTS Voice" column
+- **Piper active**: Uses voices from the "Piper Voice" column
+
+This ensures BMAD agents work seamlessly regardless of which provider you're using.
+
+### Supports Both Display Names and Agent IDs
+
+The `bmad-speak.sh` script accepts both formats:
+
+**Party Mode** (multiple agents, uses display names):
+```bash
+.claude/hooks/bmad-speak.sh "Winston" "I recommend microservices for scalability"
+```
+
+**Individual Agents** (single agent sessions, uses agent IDs):
+```bash
+.claude/hooks/bmad-speak.sh "architect" "I recommend microservices for scalability"
+```
+
+Both formats map to the same voice configuration based on the agent ID in the table above. This allows BMAD to use customizable display names while maintaining stable voice mappings.
+
+## How to Edit
+
+Simply edit the table above to change voice mappings. The format is:
+- **Agent ID**: Must match BMAD's `agent.id` field (pm, dev, qa, etc.)
+- **Agent Name**: Display name (for reference only)
+- **Intro**: Text spoken before agent's message (e.g., "John, Product Manager here"). Leave empty to disable.
+- **Piper TTS Voice**: Voice name for Piper TTS provider
+- **Piper Voice**: Voice model name for Piper provider
+- **Personality**: Optional personality to apply (or "normal" for none)
+
+## Commands
+
+- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
+- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
+- `/agent-vibes:bmad status` - Show plugin status
+- `/agent-vibes:bmad edit` - Open this file for editing
+- `/agent-vibes:bmad list` - List all agent voice mappings
+- `/agent-vibes:bmad set <agent-id> <piper-voice> <piper-voice> [personality]` - Set voices for specific agent

package/.agentvibes/config.json

@@ -0,0 +1,12 @@
+{
+  "backgroundMusic": {
+    "track": "agent_vibes_cumbia_v1_loop.mp3",
+    "enabled": false,
+    "volume": 20
+  },
+  "provider": "piper",
+  "voice": "en_US-libritts-high::Evan-8",
+  "effects": {
+    "reverbPreset": "off"
+  }
+}

package/.claude/activation-instructions

@@ -1,54 +1,54 @@
-# BMAD Agent Activation Instructions
-
-When a BMAD agent activates, follow these steps EXACTLY:
-
-## STEP 3.5a: Create BMAD Context File (CRITICAL)
-
-**IMMEDIATELY after agent identification, create the context file:**
-
-```bash
-echo "$AGENT_ID" > .bmad-agent-context
-```
-
-Where `$AGENT_ID` is one of:
-- `pm` (Product Manager)
-- `dev` (Developer)
-- `qa` (QA)
-- `architect` (Architect)
-- `po` (Product Owner)
-- `analyst` (Analyst)
-- `sm` (Scrum Master)
-- `ux-expert` (UX Expert)
-- `bmad-master` (BMAD Master)
-- `bmad-orchestrator` (Orchestrator)
-
-**Example:**
-```bash
-# For Product Manager agent
-echo "pm" > .bmad-agent-context
-```
-
-This file allows AgentVibes to:
-1. Detect which BMAD agent is active
-2. Look up the correct voice mapping
-3. Automatically speak questions using the agent's assigned voice
-
-## STEP 10: Clean Up on Exit
-
-**Before exiting the agent, remove the context file:**
-
-```bash
-rm -f .bmad-agent-context
-```
-
-This ensures voice switching only happens when an agent is active.
-
-## Why This Matters
-
-Without the `.bmad-agent-context` file:
-- AgentVibes cannot detect which agent is active
-- Questions won't be spoken automatically
-- Voice switching won't work
-- The BMAD voice plugin becomes non-functional
-
-**This is MANDATORY for BMAD voice integration to work!**
+# BMAD Agent Activation Instructions
+
+When a BMAD agent activates, follow these steps EXACTLY:
+
+## STEP 3.5a: Create BMAD Context File (CRITICAL)
+
+**IMMEDIATELY after agent identification, create the context file:**
+
+```bash
+echo "$AGENT_ID" > .bmad-agent-context
+```
+
+Where `$AGENT_ID` is one of:
+- `pm` (Product Manager)
+- `dev` (Developer)
+- `qa` (QA)
+- `architect` (Architect)
+- `po` (Product Owner)
+- `analyst` (Analyst)
+- `sm` (Scrum Master)
+- `ux-expert` (UX Expert)
+- `bmad-master` (BMAD Master)
+- `bmad-orchestrator` (Orchestrator)
+
+**Example:**
+```bash
+# For Product Manager agent
+echo "pm" > .bmad-agent-context
+```
+
+This file allows AgentVibes to:
+1. Detect which BMAD agent is active
+2. Look up the correct voice mapping
+3. Automatically speak questions using the agent's assigned voice
+
+## STEP 10: Clean Up on Exit
+
+**Before exiting the agent, remove the context file:**
+
+```bash
+rm -f .bmad-agent-context
+```
+
+This ensures voice switching only happens when an agent is active.
+
+## Why This Matters
+
+Without the `.bmad-agent-context` file:
+- AgentVibes cannot detect which agent is active
+- Questions won't be spoken automatically
+- Voice switching won't work
+- The BMAD voice plugin becomes non-functional
+
+**This is MANDATORY for BMAD voice integration to work!**

package/.claude/audio/tracks/README.md

@@ -1,52 +1,52 @@
-# Background Music for AgentVibes
-
-This folder contains background music tracks that play behind TTS voice output.
-
-## Adding Your Own Music
-
-1. **Copy audio files here:**
-   ```bash
-   cp ~/Music/your-track.mp3 .claude/audio/tracks/
-   ```
-
-2. **Edit the config** (`.claude/config/audio-effects.cfg`):
-   ```
-   # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|VOLUME
-
-   # Party mode (multi-agent discussions)
-   _party_mode||your-track.mp3|0.40
-
-   # Individual agents
-   John||electronica.mp3|0.30
-   Winston||ambient.mp3|0.25
-   ```
-
-3. **Enable background music:**
-   ```
-   /agent-vibes:background-music on
-   ```
-
-## Supported Formats
-
-- MP3 (`.mp3`) - recommended
-- WAV (`.wav`)
-- OGG (`.ogg`)
-
-## Tips
-
-- **Volume**: Use 0.20-0.40 range (20-40%) so voice stays clear
-- **Track length**: Longer tracks work better (2+ minutes)
-- **Genre**: Instrumental/ambient works best - vocals can compete with TTS
-- **Continuous playback**: Music continues from where it left off between messages
-
-## Included Tracks
-
-- `dreamy-house.mp3` - Upbeat electronic for energetic agents
-- `agent-vibes-dark-chill-step.mp3` - Atmospheric ambient for party mode
-
-## Commands
-
-- `/agent-vibes:background-music on` - Enable
-- `/agent-vibes:background-music off` - Disable
-- `/agent-vibes:background-music volume 0.3` - Set volume (0.0-1.0)
-- `/agent-vibes:background-music` - Show status
+# Background Music for AgentVibes
+
+This folder contains background music tracks that play behind TTS voice output.
+
+## Adding Your Own Music
+
+1. **Copy audio files here:**
+   ```bash
+   cp ~/Music/your-track.mp3 .claude/audio/tracks/
+   ```
+
+2. **Edit the config** (`.claude/config/audio-effects.cfg`):
+   ```
+   # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|VOLUME
+
+   # Party mode (multi-agent discussions)
+   _party_mode||your-track.mp3|0.40
+
+   # Individual agents
+   John||electronica.mp3|0.30
+   Winston||ambient.mp3|0.25
+   ```
+
+3. **Enable background music:**
+   ```
+   /agent-vibes:background-music on
+   ```
+
+## Supported Formats
+
+- MP3 (`.mp3`) - recommended
+- WAV (`.wav`)
+- OGG (`.ogg`)
+
+## Tips
+
+- **Volume**: Use 0.20-0.40 range (20-40%) so voice stays clear
+- **Track length**: Longer tracks work better (2+ minutes)
+- **Genre**: Instrumental/ambient works best - vocals can compete with TTS
+- **Continuous playback**: Music continues from where it left off between messages
+
+## Included Tracks
+
+- `dreamy-house.mp3` - Upbeat electronic for energetic agents
+- `agent-vibes-dark-chill-step.mp3` - Atmospheric ambient for party mode
+
+## Commands
+
+- `/agent-vibes:background-music on` - Enable
+- `/agent-vibes:background-music off` - Disable
+- `/agent-vibes:background-music volume 0.3` - Set volume (0.0-1.0)
+- `/agent-vibes:background-music` - Show status

package/.claude/commands/agent-vibes/add.md

@@ -1,21 +1,21 @@
----
-description: Add a new custom Piper TTS TTS voice
-argument-hint: <voice_name> <voice_id>
----
-
-Add a new custom Piper TTS TTS voice to your voice library.
-
-Usage:
-- `/agent-vibes:add "My Custom Voice" abc123xyz456789`
-- `/agent-vibes:add Narrator KTPVrSVAEUSJRClDzBw7`
-
-The voice ID should be a 15-30 character alphanumeric string from your Piper TTS account.
-
-To find your voice IDs:
-1. Go to https://piper.io/app/voice-library
-2. Click on a voice
-3. Copy the voice ID from the URL or settings
-
-After adding, you can switch to it with `/agent-vibes:switch "Voice Name"`
-
-!bash .claude/hooks/voice-manager.sh add $ARGUMENTS
+---
+description: Add a new custom Piper TTS TTS voice
+argument-hint: <voice_name> <voice_id>
+---
+
+Add a new custom Piper TTS TTS voice to your voice library.
+
+Usage:
+- `/agent-vibes:add "My Custom Voice" abc123xyz456789`
+- `/agent-vibes:add Narrator KTPVrSVAEUSJRClDzBw7`
+
+The voice ID should be a 15-30 character alphanumeric string from your Piper TTS account.
+
+To find your voice IDs:
+1. Go to https://piper.io/app/voice-library
+2. Click on a voice
+3. Copy the voice ID from the URL or settings
+
+After adding, you can switch to it with `/agent-vibes:switch "Voice Name"`
+
+!bash .claude/hooks/voice-manager.sh add $ARGUMENTS

package/.claude/commands/agent-vibes/agent-vibes.md

@@ -1,101 +1,101 @@
----
-description: Piper TTS TTS voice management commands
----
-
-# 🎤 AgentVibes Voice Management
-
-Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say).
-
-## Available Commands
-
-### `/agent-vibes:mute`
-Mute all TTS output (persists across sessions)
-- Creates a mute flag that silences all voice output
-- Shows 🔇 indicator when TTS would have played
-
-### `/agent-vibes:unmute`
-Unmute TTS output
-- Removes mute flag and restores voice output
-
-### `/agent-vibes:list [first|last] [N]`
-List all available voices, with optional filtering
-- `/agent-vibes:list` - Show all voices
-- `/agent-vibes:list first 5` - Show first 5 voices
-- `/agent-vibes:list last 3` - Show last 3 voices
-
-### `/agent-vibes:preview [first|last] [N]`
-Preview voices by playing audio samples
-- `/agent-vibes:preview` - Preview first 3 voices
-- `/agent-vibes:preview 5` - Preview first 5 voices
-- `/agent-vibes:preview last 5` - Preview last 5 voices
-
-### `/agent-vibes:switch <voice_name>`
-Switch to a different default voice
-- `/agent-vibes:switch Northern Terry`
-- `/agent-vibes:switch "Cowboy Bob"`
-
-### `/agent-vibes:get`
-Display the currently selected voice
-
-### `/agent-vibes:add <name> <voice_id>`
-Add a new custom voice from your Piper TTS account
-- `/agent-vibes:add "My Voice" abc123xyz456`
-
-### `/agent-vibes:replay [N]`
-Replay recently played TTS audio
-- `/agent-vibes:replay` - Replay last audio
-- `/agent-vibes:replay 1` - Replay most recent
-- `/agent-vibes:replay 2` - Replay second-to-last
-- `/agent-vibes:replay 3` - Replay third-to-last
-
-Keeps last 10 audio files in history.
-
-### `/agent-vibes:set-pretext <word>`
-Set a prefix word/phrase for all TTS messages
-- `/agent-vibes:set-pretext AgentVibes` - All TTS starts with "AgentVibes:"
-- `/agent-vibes:set-pretext "Project Alpha"` - Custom phrase
-- `/agent-vibes:set-pretext ""` - Clear pretext
-
-Saved locally in `.agentvibes/config/agentvibes.json`
-
-## Provider Management
-
-### `/agent-vibes:provider list`
-Show all available TTS providers
-
-### `/agent-vibes:provider switch <name>`
-Switch between providers:
-- `/agent-vibes:provider switch piper` - Free, offline (Linux/WSL)
-- `/agent-vibes:provider switch piper` - Premium AI voices
-- `/agent-vibes:provider switch macos` - Native macOS (Mac only)
-
-### `/agent-vibes:provider info <name>`
-Get details about a specific provider
-
-## Providers
-
-| Provider | Platform | Cost | Quality |
-|----------|----------|------|---------|
-| **macOS Say** | macOS only | Free (built-in) | ⭐⭐⭐⭐ |
-| **Piper** | Linux/WSL | Free | ⭐⭐⭐⭐ |
-| **Piper TTS** | All | Free tier + paid | ⭐⭐⭐⭐⭐ |
-
-On macOS, the native `say` provider is automatically detected and recommended.
-
-## Getting Voice IDs (Piper TTS)
-
-To add your own custom Piper TTS voices:
-1. Go to https://piper.io/app/voice-library
-2. Select or create a voice
-3. Copy the voice ID (15-30 character alphanumeric string)
-4. Use `/agent-vibes:add` to add it
-
-## Default Voices
-
-**Piper TTS:** Northern Terry, Grandpa Spuds Oxley, Ms. Walker, Ralf Eisend, Amy, Michael, Jessica Anne Bogart, Aria, Lutz Laugh, Dr. Von Fusion, Matthew Schmitz, Demon Monster, Cowboy Bob, Drill Sergeant
-
-**Piper:** en_US-lessac-medium, en_US-amy-medium, en_GB-alan-medium, and many more
-
-**macOS Say:** Samantha, Alex, Daniel, Victoria, Karen, Moira, and 100+ more built-in voices
-
-Enjoy your TTS experience! 🎵
+---
+description: Piper TTS TTS voice management commands
+---
+
+# 🎤 AgentVibes Voice Management
+
+Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say).
+
+## Available Commands
+
+### `/agent-vibes:mute`
+Mute all TTS output (persists across sessions)
+- Creates a mute flag that silences all voice output
+- Shows 🔇 indicator when TTS would have played
+
+### `/agent-vibes:unmute`
+Unmute TTS output
+- Removes mute flag and restores voice output
+
+### `/agent-vibes:list [first|last] [N]`
+List all available voices, with optional filtering
+- `/agent-vibes:list` - Show all voices
+- `/agent-vibes:list first 5` - Show first 5 voices
+- `/agent-vibes:list last 3` - Show last 3 voices
+
+### `/agent-vibes:preview [first|last] [N]`
+Preview voices by playing audio samples
+- `/agent-vibes:preview` - Preview first 3 voices
+- `/agent-vibes:preview 5` - Preview first 5 voices
+- `/agent-vibes:preview last 5` - Preview last 5 voices
+
+### `/agent-vibes:switch <voice_name>`
+Switch to a different default voice
+- `/agent-vibes:switch Northern Terry`
+- `/agent-vibes:switch "Cowboy Bob"`
+
+### `/agent-vibes:get`
+Display the currently selected voice
+
+### `/agent-vibes:add <name> <voice_id>`
+Add a new custom voice from your Piper TTS account
+- `/agent-vibes:add "My Voice" abc123xyz456`
+
+### `/agent-vibes:replay [N]`
+Replay recently played TTS audio
+- `/agent-vibes:replay` - Replay last audio
+- `/agent-vibes:replay 1` - Replay most recent
+- `/agent-vibes:replay 2` - Replay second-to-last
+- `/agent-vibes:replay 3` - Replay third-to-last
+
+Keeps last 10 audio files in history.
+
+### `/agent-vibes:set-pretext <word>`
+Set a prefix word/phrase for all TTS messages
+- `/agent-vibes:set-pretext AgentVibes` - All TTS starts with "AgentVibes:"
+- `/agent-vibes:set-pretext "Project Alpha"` - Custom phrase
+- `/agent-vibes:set-pretext ""` - Clear pretext
+
+Saved locally in `.agentvibes/config/agentvibes.json`
+
+## Provider Management
+
+### `/agent-vibes:provider list`
+Show all available TTS providers
+
+### `/agent-vibes:provider switch <name>`
+Switch between providers:
+- `/agent-vibes:provider switch piper` - Free, offline (Linux/WSL)
+- `/agent-vibes:provider switch piper` - Premium AI voices
+- `/agent-vibes:provider switch macos` - Native macOS (Mac only)
+
+### `/agent-vibes:provider info <name>`
+Get details about a specific provider
+
+## Providers
+
+| Provider | Platform | Cost | Quality |
+|----------|----------|------|---------|
+| **macOS Say** | macOS only | Free (built-in) | ⭐⭐⭐⭐ |
+| **Piper** | Linux/WSL | Free | ⭐⭐⭐⭐ |
+| **Piper TTS** | All | Free tier + paid | ⭐⭐⭐⭐⭐ |
+
+On macOS, the native `say` provider is automatically detected and recommended.
+
+## Getting Voice IDs (Piper TTS)
+
+To add your own custom Piper TTS voices:
+1. Go to https://piper.io/app/voice-library
+2. Select or create a voice
+3. Copy the voice ID (15-30 character alphanumeric string)
+4. Use `/agent-vibes:add` to add it
+
+## Default Voices
+
+**Piper TTS:** Northern Terry, Grandpa Spuds Oxley, Ms. Walker, Ralf Eisend, Amy, Michael, Jessica Anne Bogart, Aria, Lutz Laugh, Dr. Von Fusion, Matthew Schmitz, Demon Monster, Cowboy Bob, Drill Sergeant
+
+**Piper:** en_US-lessac-medium, en_US-amy-medium, en_GB-alan-medium, and many more
+
+**macOS Say:** Samantha, Alex, Daniel, Victoria, Karen, Moira, and 100+ more built-in voices
+
+Enjoy your TTS experience! 🎵