agentvibes 2.0.3 → 2.0.5

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

@@ -0,0 +1,79 @@
+---
+description: Set or customize the personality style for TTS messages
+argument-hint: [personality_name|list|add|edit|get|reset]
+---
+
+# /agent-vibes:personality
+
+Set or customize the personality style for TTS messages.
+
+This command allows you to add character and emotion to your TTS announcements by applying personality modifiers to messages.
+
+## Usage
+
+```bash
+# Set a personality
+/agent-vibes:personality flirty
+/agent-vibes:personality sarcastic
+
+# List all personalities
+/agent-vibes:personality list
+
+# Add custom personality
+/agent-vibes:personality add cowboy "Howdy partner!" "Yeehaw!"
+
+# Show current personality
+/agent-vibes:personality get
+
+# Reset to normal
+/agent-vibes:personality reset
+```
+
+## Available Personalities
+
+- **normal** - Standard professional tone
+- **flirty** - Playful and charming
+- **angry** - Frustrated and irritated
+- **sassy** - Bold with attitude
+- **moody** - Melancholic and brooding
+- **funny** - Lighthearted and comedic
+- **sarcastic** - Dry wit and irony
+- **poetic** - Elegant and lyrical
+- **annoying** - Over-enthusiastic
+- **professional** - Formal and precise
+- **pirate** - Seafaring swagger
+- **robot** - Mechanical and precise
+- **surfer-dude** - Chill beach vibes
+- **millennial** - Internet generation speak
+- **zen** - Peaceful and mindful
+- **dramatic** - Theatrical flair
+- **crass** - Edgy and blunt
+- **random** - Picks a different personality each time!
+
+## Editing Personalities
+
+Each personality is stored as a markdown file in `.claude/personalities/`. You can:
+
+### Edit existing personalities:
+```bash
+/agent-vibes:personality edit flirty
+```
+This shows the file path - edit it directly to customize behavior.
+
+### Create new personalities:
+```bash
+/agent-vibes:personality add cowboy
+```
+Creates a new personality file, then edit it to customize.
+
+### Personality files contain:
+- **Prefix**: Text added before messages
+- **Suffix**: Text added after messages
+- **AI Instructions**: How the AI should speak
+- **Example Responses**: Sample messages
+
+Files are located in `.claude/personalities/[name].md`
+
+## Implementation
+
+!bash .claude/hooks/personality-manager.sh $ARGUMENTS

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

@@ -0,0 +1,16 @@
+---
+description: Preview ElevenLabs TTS voices by playing audio samples
+argument-hint: [voice_name|first|last] [N]
+---
+
+Preview ElevenLabs TTS voices by playing audio samples.
+
+Usage examples:
+- `/agent-vibes:preview` - Preview first 3 voices (default)
+- `/agent-vibes:preview 5` - Preview first 5 voices
+- `/agent-vibes:preview Jessica` - Preview Jessica Anne Bogart voice
+- `/agent-vibes:preview "Northern Terry"` - Preview Northern Terry voice
+- `/agent-vibes:preview first 10` - Preview first 10 voices
+- `/agent-vibes:preview last 5` - Preview last 5 voices
+
+!bash .claude/hooks/voice-manager.sh preview $ARGUMENTS

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