agentvibes 2.0.9 → 2.0.12

package/agentvibes.org/.claude/commands/agent-vibes/provider.md

@@ -0,0 +1,54 @@
+---
+description: Manage TTS providers (list, switch, info, test)
+argument-hint: [command] [args...]
+---
+
+# Provider Management Commands
+
+Manage TTS providers (ElevenLabs, Piper) - switch between providers, view details, and test.
+
+## Usage
+
+```bash
+/agent-vibes:provider list              # Show all available providers
+/agent-vibes:provider switch <name>     # Switch to a different provider
+/agent-vibes:provider info <name>       # Show detailed provider information
+/agent-vibes:provider test              # Test current provider
+/agent-vibes:provider get               # Show current active provider
+/agent-vibes:provider help              # Show this help
+```
+
+## Examples
+
+```bash
+# List available providers
+/agent-vibes:provider list
+
+# Switch to Piper (free, offline)
+/agent-vibes:provider switch piper
+
+# Switch to ElevenLabs (premium quality)
+/agent-vibes:provider switch elevenlabs
+
+# Get info about a provider
+/agent-vibes:provider info piper
+
+# Test current provider
+/agent-vibes:provider test
+
+# Show current provider
+/agent-vibes:provider get
+```
+
+## Provider Comparison
+
+| Feature | ElevenLabs | Piper |
+|---------|------------|-------|
+| Quality | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
+| Cost | Free tier + $5-22/mo | Free forever |
+| Offline | No | Yes |
+| Platform | All | WSL/Linux only |
+
+Learn more: agentvibes.org/providers
+
+!bash .claude/hooks/provider-commands.sh $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/replay.md

@@ -0,0 +1,19 @@
+---
+description: Replay recently played TTS audio
+argument-hint: [N]
+---
+
+Replay previously played TTS audio from history.
+
+Usage:
+- `/agent-vibes:replay` - Replay last audio (most recent)
+- `/agent-vibes:replay 1` - Replay last audio
+- `/agent-vibes:replay 2` - Replay second-to-last audio
+- `/agent-vibes:replay 3` - Replay third-to-last audio
+
+The system keeps the last 10 audio files in history. This is useful for:
+- Hearing a summary again
+- Checking what was just said
+- Comparing different voice samples
+
+!bash .claude/hooks/voice-manager.sh replay $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/sample.md

@@ -0,0 +1,12 @@
+---
+description: Test a voice with sample text
+argument-hint: <voice-name>
+---
+
+Test a specific ElevenLabs voice by playing sample text.
+
+Usage:
+- `/agent-vibes:sample Cowboy` - Test the Cowboy voice
+- `/agent-vibes:sample "Northern Terry"` - Test Northern Terry voice
+
+!bash .claude/hooks/voice-manager.sh sample $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/sentiment.md

@@ -0,0 +1,52 @@
+---
+description: Set sentiment/personality for your current voice
+argument-hint: [personality_name|list|get]
+---
+
+# Agent Vibes Sentiment Command
+
+Set the sentiment/personality style for your current voice without changing the voice itself.
+
+```bash
+.claude/hooks/sentiment-manager.sh "$@"
+```
+
+## Usage
+
+```bash
+# Set sentiment for current voice
+/agent-vibes:sentiment flirty
+/agent-vibes:sentiment sarcastic
+/agent-vibes:sentiment angry
+
+# See current sentiment
+/agent-vibes:sentiment get
+
+# List available sentiments
+/agent-vibes:sentiment list
+```
+
+## What This Does
+
+The sentiment command allows you to:
+- Keep your current voice (e.g., your custom voice)
+- Apply a personality style (flirty, sarcastic, angry, etc.)
+- Change how AI speaks without changing WHO speaks
+
+## Example
+
+```bash
+# You're using your custom voice "MyVoice"
+/agent-vibes:switch MyVoice
+
+# Now add a sarcastic sentiment to MyVoice
+/agent-vibes:sentiment sarcastic
+# AI will now respond with sarcasm in MyVoice
+
+# Or set both at once
+/agent-vibes:switch MyVoice --sentiment flirty
+```
+
+## Available Sentiments
+
+Run `/agent-vibes:sentiment list` to see all available personality styles.

package/agentvibes.org/.claude/commands/agent-vibes/set-language.md

@@ -0,0 +1,47 @@
+# /agent-vibes:set-language
+
+Set the language for TTS narration. AgentVibes will automatically use multilingual voices and speak in your chosen language.
+
+## Usage
+
+```bash
+# Set language
+/agent-vibes:set-language spanish
+/agent-vibes:set-language french
+/agent-vibes:set-language german
+
+# Show current language
+/agent-vibes:set-language
+
+# Reset to English (default)
+/agent-vibes:set-language english
+/agent-vibes:set-language reset
+```
+
+## Supported Languages
+
+Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Polish, Dutch, Turkish, Russian, Arabic, Hindi, Swedish, Danish, Norwegian, Finnish, Czech, Romanian, Ukrainian, Greek, Bulgarian, Croatian, Slovak, and 20+ more.
+
+## How It Works
+
+1. **Sets Language**: Stores your language preference in `.claude/tts-language.txt`
+2. **Voice Selection**: Automatically uses multilingual voices (Antoni, Rachel, Domi, Bella)
+3. **BMAD Integration**: Works with BMAD plugin - agents speak in your language
+4. **Personality Preserved**: Keeps your current personality/sentiment style
+
+## Multilingual Voice Recommendations
+
+- **Spanish**: Antoni, Matilda
+- **French**: Rachel, Charlotte
+- **German**: Domi, Charlotte
+- **Italian**: Bella
+- **Portuguese**: Matilda
+- **Other Languages**: Antoni (best all-around multilingual)
+
+## Implementation
+
+This command tells Claude AI to:
+1. Validate the language is supported
+2. Save to `.claude/tts-language.txt`
+3. Switch to an appropriate multilingual voice if needed
+4. Inform user of the change

package/agentvibes.org/.claude/commands/agent-vibes/set-pretext.md

@@ -0,0 +1,65 @@
+---
+description: Set a pretext word/phrase that prefixes all TTS announcements
+---
+
+# Set TTS Pretext
+
+Configure a word or phrase that will be spoken before every TTS message.
+
+## Usage
+
+```bash
+/agent-vibes:set-pretext <word>
+```
+
+## Examples
+
+Set "AgentVibes" as the pretext:
+```bash
+/agent-vibes:set-pretext AgentVibes
+```
+
+Set a phrase:
+```bash
+/agent-vibes:set-pretext "Project Alpha"
+```
+
+Clear the pretext:
+```bash
+/agent-vibes:set-pretext ""
+```
+
+## What It Does
+
+When a pretext is set:
+- **Without pretext**: "I'll do the task"
+- **With pretext**: "AgentVibes: I'll do the task"
+
+The pretext is saved locally in `.claude/config/agentvibes.json` and persists across sessions.
+
+!bash
+CONFIG_DIR="${CLAUDE_PROJECT_DIR:-.}/.claude/config"
+CONFIG_FILE="$CONFIG_DIR/agentvibes.json"
+
+# Get the pretext from arguments
+PRETEXT="$ARGUMENTS"
+
+# Create config directory if it doesn't exist
+mkdir -p "$CONFIG_DIR"
+
+# Initialize config file if it doesn't exist
+if [ ! -f "$CONFIG_FILE" ]; then
+    echo '{}' > "$CONFIG_FILE"
+fi
+
+# Update or clear the pretext
+if [ -z "$PRETEXT" ]; then
+    # Clear pretext
+    jq 'del(.pretext)' "$CONFIG_FILE" > "${CONFIG_FILE}.tmp" && mv "${CONFIG_FILE}.tmp" "$CONFIG_FILE"
+    echo "✅ Pretext cleared"
+else
+    # Set pretext
+    jq --arg pretext "$PRETEXT" '.pretext = $pretext' "$CONFIG_FILE" > "${CONFIG_FILE}.tmp" && mv "${CONFIG_FILE}.tmp" "$CONFIG_FILE"
+    echo "✅ Pretext set to: $PRETEXT"
+    echo "📢 All TTS messages will now start with: \"$PRETEXT:\""
+fi

package/agentvibes.org/.claude/commands/agent-vibes/switch.md

@@ -0,0 +1,53 @@
+---
+description: Switch to a different ElevenLabs TTS voice
+argument-hint: [voice_name_or_number] [--sentiment personality_name]
+---
+
+# Voice Selection
+
+If no arguments provided, display this list:
+
+## 🎤 Available ElevenLabs Voices
+
+1. **Amy** - Young and friendly
+2. **Aria** - Clear professional
+3. **Cowboy Bob** - Western charm
+4. **Demon Monster** - Deep and spooky
+5. **Dr. Von Fusion** - Eccentric scientist
+6. **Drill Sergeant** - Military authority
+7. **Grandpa Spuds Oxley** - Wise elder
+8. **Jessica Anne Bogart** - Wickedly eloquent
+9. **Lutz Laugh** - Jovial and giggly
+10. **Matthew Schmitz** - Deep baritone
+11. **Michael** - British urban
+12. **Ms. Walker** - Warm teacher
+13. **Northern Terry** - Eccentric British
+14. **Ralf Eisend** - International speaker
+
+Then check current voice with: !bash .claude/hooks/voice-manager.sh get
+
+And inform user: "To switch voices, use `/agent-vibes:switch <number>` or `/agent-vibes:switch <name>`"
+
+If arguments ARE provided:
+
+1. Parse arguments for --sentiment flag
+2. If --sentiment is present:
+   - Extract voice name/number (everything before --sentiment)
+   - Extract sentiment name (after --sentiment)
+   - Execute: !bash .claude/hooks/voice-manager.sh switch <voice>
+   - Then execute: !bash .claude/hooks/sentiment-manager.sh set <sentiment>
+3. If no --sentiment flag:
+   - Execute: !bash .claude/hooks/voice-manager.sh switch $ARGUMENTS
+
+## Examples
+
+```bash
+# Switch voice only
+/agent-vibes:switch Jessica Anne Bogart
+
+# Switch voice and set sentiment
+/agent-vibes:switch Aria --sentiment sarcastic
+
+# Switch by number with sentiment
+/agent-vibes:switch 5 --sentiment flirty
+```

package/agentvibes.org/.claude/commands/agent-vibes/update.md

@@ -0,0 +1,20 @@
+---
+description: Update AgentVibes to the latest version
+argument-hint: [--yes]
+---
+
+Updates AgentVibes to the latest version from the npm registry.
+
+This will update:
+- All slash commands
+- TTS scripts and hooks
+- Personality templates (new ones added, existing ones updated)
+- Output styles
+
+Your custom settings and voice configurations will be preserved.
+
+Usage examples:
+- `/agent-vibes:update` - Update with confirmation prompt
+- `/agent-vibes:update --yes` - Update without confirmation
+
+!bash npx agent-vibes update $ARGUMENTS

package/agentvibes.org/.claude/commands/agent-vibes/version.md

@@ -0,0 +1,10 @@
+---
+description: Show the installed AgentVibes version
+---
+
+Display the currently installed version of AgentVibes.
+
+Usage:
+- `/agent-vibes:version` - Show version information
+
+!bash npx agent-vibes --version

package/agentvibes.org/.claude/commands/agent-vibes/whoami.md

@@ -0,0 +1,7 @@
+---
+description: Show the current active voice
+---
+
+Display the currently selected ElevenLabs TTS voice.
+
+!bash .claude/hooks/voice-manager.sh whoami

package/agentvibes.org/.claude/hooks/bmad-voice-manager.sh

@@ -0,0 +1,278 @@
+#!/bin/bash
+
+PLUGIN_DIR=".claude/plugins"
+PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
+ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+
+# Auto-enable plugin if BMAD is detected
+auto_enable_if_bmad_detected() {
+    # Check if BMAD is installed
+    if [[ -f ".bmad-core/install-manifest.yaml" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
+        # BMAD detected but plugin not enabled - enable it silently
+        mkdir -p "$PLUGIN_DIR"
+        touch "$ENABLED_FLAG"
+        return 0
+    fi
+    return 1
+}
+
+# Parse markdown table to get voice mapping
+get_agent_voice() {
+    local agent_id="$1"
+
+    # Auto-enable if BMAD is detected
+    auto_enable_if_bmad_detected
+
+    if [[ ! -f "$ENABLED_FLAG" ]]; then
+        echo ""  # Plugin disabled
+        return
+    fi
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo ""  # Plugin file missing
+        return
+    fi
+
+    # Extract voice from markdown table
+    local voice=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+                  awk -F'|' '{print $4}' | \
+                  sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$voice"
+}
+
+# Get personality for agent
+get_agent_personality() {
+    local agent_id="$1"
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo ""
+        return
+    fi
+
+    local personality=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+                       awk -F'|' '{print $5}' | \
+                       sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$personality"
+}
+
+# Check if plugin is enabled
+is_plugin_enabled() {
+    [[ -f "$ENABLED_FLAG" ]] && echo "true" || echo "false"
+}
+
+# Enable plugin
+enable_plugin() {
+    mkdir -p "$PLUGIN_DIR"
+
+    # Save current settings before enabling
+    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+
+    # Save current voice
+    if [[ -f ".claude/tts-voice.txt" ]]; then
+        CURRENT_VOICE=$(cat .claude/tts-voice.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-voice.txt" ]]; then
+        CURRENT_VOICE=$(cat "$HOME/.claude/tts-voice.txt" 2>/dev/null)
+    else
+        CURRENT_VOICE="Aria"
+    fi
+
+    # Save current personality
+    if [[ -f ".claude/tts-personality.txt" ]]; then
+        CURRENT_PERSONALITY=$(cat .claude/tts-personality.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-personality.txt" ]]; then
+        CURRENT_PERSONALITY=$(cat "$HOME/.claude/tts-personality.txt" 2>/dev/null)
+    else
+        CURRENT_PERSONALITY="normal"
+    fi
+
+    # Save current sentiment
+    if [[ -f ".claude/tts-sentiment.txt" ]]; then
+        CURRENT_SENTIMENT=$(cat .claude/tts-sentiment.txt 2>/dev/null)
+    elif [[ -f "$HOME/.claude/tts-sentiment.txt" ]]; then
+        CURRENT_SENTIMENT=$(cat "$HOME/.claude/tts-sentiment.txt" 2>/dev/null)
+    else
+        CURRENT_SENTIMENT=""
+    fi
+
+    # Write backup
+    cat > "$BACKUP_FILE" <<EOF
+VOICE=$CURRENT_VOICE
+PERSONALITY=$CURRENT_PERSONALITY
+SENTIMENT=$CURRENT_SENTIMENT
+EOF
+
+    touch "$ENABLED_FLAG"
+    echo "✅ BMAD voice plugin enabled"
+    echo "💾 Previous settings backed up:"
+    echo "   Voice: $CURRENT_VOICE"
+    echo "   Personality: $CURRENT_PERSONALITY"
+    [[ -n "$CURRENT_SENTIMENT" ]] && echo "   Sentiment: $CURRENT_SENTIMENT"
+    echo ""
+    list_mappings
+}
+
+# Disable plugin
+disable_plugin() {
+    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+
+    # Check if we have a backup to restore
+    if [[ -f "$BACKUP_FILE" ]]; then
+        source "$BACKUP_FILE"
+
+        echo "❌ BMAD voice plugin disabled"
+        echo "🔄 Restoring previous settings:"
+        echo "   Voice: $VOICE"
+        echo "   Personality: $PERSONALITY"
+        [[ -n "$SENTIMENT" ]] && echo "   Sentiment: $SENTIMENT"
+
+        # Restore voice
+        if [[ -n "$VOICE" ]]; then
+            echo "$VOICE" > .claude/tts-voice.txt 2>/dev/null || echo "$VOICE" > "$HOME/.claude/tts-voice.txt"
+        fi
+
+        # Restore personality
+        if [[ -n "$PERSONALITY" ]] && [[ "$PERSONALITY" != "normal" ]]; then
+            echo "$PERSONALITY" > .claude/tts-personality.txt 2>/dev/null || echo "$PERSONALITY" > "$HOME/.claude/tts-personality.txt"
+        fi
+
+        # Restore sentiment
+        if [[ -n "$SENTIMENT" ]]; then
+            echo "$SENTIMENT" > .claude/tts-sentiment.txt 2>/dev/null || echo "$SENTIMENT" > "$HOME/.claude/tts-sentiment.txt"
+        fi
+
+        # Clean up backup
+        rm -f "$BACKUP_FILE"
+    else
+        echo "❌ BMAD voice plugin disabled"
+        echo "⚠️  No previous settings found to restore"
+        echo "AgentVibes will use current voice/personality settings"
+    fi
+
+    rm -f "$ENABLED_FLAG"
+}
+
+# List all mappings
+list_mappings() {
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    echo "📊 BMAD Agent Voice Mappings:"
+    echo ""
+
+    grep "^| " "$PLUGIN_FILE" | grep -v "Agent ID" | grep -v "^|---" | \
+    while IFS='|' read -r _ agent_id name voice personality _; do
+        agent_id=$(echo "$agent_id" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        name=$(echo "$name" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        voice=$(echo "$voice" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+        personality=$(echo "$personality" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+        [[ -n "$agent_id" ]] && echo "   $agent_id → $voice [$personality]"
+    done
+}
+
+# Set voice for agent
+set_agent_voice() {
+    local agent_id="$1"
+    local voice="$2"
+    local personality="${3:-normal}"
+
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    # Check if agent exists
+    if ! grep -q "^| $agent_id " "$PLUGIN_FILE"; then
+        echo "❌ Agent '$agent_id' not found in plugin"
+        return 1
+    fi
+
+    # Update the voice and personality in the table
+    sed -i.bak "s/^| $agent_id |.*| .* | .* |$/| $agent_id | $(grep "^| $agent_id " "$PLUGIN_FILE" | awk -F'|' '{print $3}') | $voice | $personality |/" "$PLUGIN_FILE"
+
+    echo "✅ Updated $agent_id → $voice [$personality]"
+}
+
+# Show status
+show_status() {
+    # Check for BMAD installation
+    local bmad_installed="false"
+    if [[ -f ".bmad-core/install-manifest.yaml" ]]; then
+        bmad_installed="true"
+    fi
+
+    if [[ $(is_plugin_enabled) == "true" ]]; then
+        echo "✅ BMAD voice plugin: ENABLED"
+        if [[ "$bmad_installed" == "true" ]]; then
+            echo "🔍 BMAD detected: Auto-enabled"
+        fi
+    else
+        echo "❌ BMAD voice plugin: DISABLED"
+        if [[ "$bmad_installed" == "true" ]]; then
+            echo "⚠️  BMAD detected but plugin disabled (enable with: /agent-vibes-bmad enable)"
+        fi
+    fi
+    echo ""
+    list_mappings
+}
+
+# Edit plugin file
+edit_plugin() {
+    if [[ ! -f "$PLUGIN_FILE" ]]; then
+        echo "❌ Plugin file not found: $PLUGIN_FILE"
+        return 1
+    fi
+
+    echo "Opening $PLUGIN_FILE for editing..."
+    echo "Edit the markdown table to change voice mappings"
+}
+
+# Main command dispatcher
+case "${1:-help}" in
+    enable)
+        enable_plugin
+        ;;
+    disable)
+        disable_plugin
+        ;;
+    status)
+        show_status
+        ;;
+    list)
+        list_mappings
+        ;;
+    set)
+        if [[ -z "$2" ]] || [[ -z "$3" ]]; then
+            echo "Usage: bmad-voice-manager.sh set <agent-id> <voice> [personality]"
+            exit 1
+        fi
+        set_agent_voice "$2" "$3" "$4"
+        ;;
+    get-voice)
+        get_agent_voice "$2"
+        ;;
+    get-personality)
+        get_agent_personality "$2"
+        ;;
+    edit)
+        edit_plugin
+        ;;
+    *)
+        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-personality|edit}"
+        echo ""
+        echo "Commands:"
+        echo "  enable              Enable BMAD voice plugin"
+        echo "  disable             Disable BMAD voice plugin"
+        echo "  status              Show plugin status and mappings"
+        echo "  list                List all agent voice mappings"
+        echo "  set <id> <voice>    Set voice for agent"
+        echo "  get-voice <id>      Get voice for agent"
+        echo "  get-personality <id> Get personality for agent"
+        echo "  edit                Edit plugin configuration"
+        exit 1
+        ;;
+esac