agentvibes 2.0.17 → 2.0.20

package/agentvibes.org/content/blog/introducing-agentvibes-v2.mdx

@@ -0,0 +1,250 @@
+---
+title: "Introducing AgentVibes v2.0.17 - Finally! Your Agents Can Talk Back!"
+description: "AgentVibes v2.0.17 brings MCP server support, language learning mode, SSH audio optimization, and professional text-to-speech to Claude Code, Claude Desktop, and Warp Terminal."
+date: "2025-10-10"
+author: "Paul Preibisch"
+tags: ["release", "features", "voice", "mcp"]
+---
+
+# Introducing AgentVibes v2.0.17
+
+**Finally! Your agents can talk back!** 🎤
+
+We're thrilled to announce **AgentVibes v2.0.17** - our biggest release yet, transforming how you interact with AI assistants across Claude Code, Claude Desktop, and Warp Terminal.
+
+## 🌟 Headline Features
+
+### 🎙️ AgentVibes MCP Server - Natural Language Control
+
+The game-changer: **MCP (Model Context Protocol) server support**!
+
+What does this mean? Instead of memorizing slash commands like `/agent-vibes:switch Aria`, you can now simply say:
+
+> *"Switch to Aria voice"*
+> *"Change personality to sarcastic"*
+> *"Speak in French"*
+
+The MCP server is essentially a plugin that exposes AgentVibes functionality directly to your AI assistant. Your assistant understands what you want and calls the right functions automatically.
+
+**The Big Win:** This enables **Claude Desktop** support! 🎉
+
+AgentVibes started as a Claude Code exclusive, but with MCP, it now works seamlessly in Claude Desktop (Anthropic's ChatGPT competitor). Give Claude Desktop the command:
+
+> *"Every time I give you a command, speak the acknowledgement using AgentVibes and confirm what you completed when done"*
+
+Watch the magic happen!
+
+**Supported Platforms:**
+- **Claude Code** - Original platform, now with slash commands OR MCP
+- **[Claude Desktop](https://claude.ai/download)** - NEW! Full MCP support
+- **Warp Terminal** - AI-powered terminal with voice feedback
+
+[→ Learn more about MCP Setup](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/mcp-setup.md)
+
+### 📚 Language Learning Mode - Learn While You Code
+
+**Turn your coding sessions into immersive language learning experiences!**
+
+Every task acknowledgment plays **twice**:
+1. First in your native language (English)
+2. Then in your target language (Spanish, French, German, etc.)
+
+Example:
+```
+Claude: "I'll check that git status for you" 🔊
+Claude: "Voy a revisar ese estado de git para ti" 🔊
+```
+
+Repetition is key to learning - hearing phrases over and over in context helps them stick. Plus, it makes your coding journey way more fun!
+
+**Quick Start:**
+```bash
+/agent-vibes:learn                    # Enable learning mode
+/agent-vibes:target spanish           # Set target language
+/agent-vibes:set-speed target 0.75x   # Slow down for better comprehension
+```
+
+Supports 30+ languages including Spanish, French, German, Portuguese, Italian, Japanese, Korean, Chinese, and more!
+
+[→ Complete Language Learning Guide](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/language-learning-mode.md)
+
+### 🔊 SSH Audio Optimization - Perfect Remote Development
+
+Working on remote servers? **Auto-detected SSH audio optimization** eliminates static and clicking sounds!
+
+AgentVibes now automatically detects when you're in an SSH session (VS Code Remote SSH, regular SSH, cloud dev environments) and converts audio to the optimal format for perfect playback.
+
+No configuration needed - it just works! ✨
+
+## 🎯 Complete Feature List
+
+### Multi-Provider Support
+
+Choose your voice provider:
+
+- **ElevenLabs** - 150+ premium AI voices with incredible quality
+- **Piper TTS** - 50+ free voices that work offline (no API key!)
+
+Switch anytime with a single command:
+
+```bash
+/agent-vibes:provider switch piper
+/agent-vibes:provider switch elevenlabs
+```
+
+### 27+ Professional AI Voices
+
+From character voices to accents and unique personalities:
+- **Northern Terry** (Canadian charm)
+- **Aria** (Clear, professional)
+- **Antoni** (Warm, friendly)
+- **Pirate Marshal** (Arr, matey!)
+- **Rachel** (French accent)
+- And 20+ more!
+
+Preview before choosing:
+```bash
+/agent-vibes:preview          # Preview voices
+/agent-vibes:switch Aria      # Select your favorite
+```
+
+### 19 Built-in Personalities
+
+Make your AI assistant uniquely yours:
+
+🎭 **Character Personalities:**
+- Sarcastic 😏
+- Flirty 💋
+- Pirate 🏴‍☠️
+- Zen 🧘
+- Robot 🤖
+- Grandpa 👴
+
+🎨 **Speaking Styles:**
+- Dry Humor
+- Encouraging
+- Professional
+- Casual
+- Thoughtful
+
+Apply personalities with:
+```bash
+/agent-vibes:personality pirate
+/agent-vibes:personality sarcastic
+```
+
+### Advanced Sentiment System
+
+Want your favorite voice to sound different without changing it? **Sentiments** apply speaking styles to any voice:
+
+```bash
+/agent-vibes:sentiment sarcastic    # Make any voice sarcastic
+/agent-vibes:sentiment flirty       # Add flirty vibes
+/agent-vibes:sentiment professional # Keep it professional
+```
+
+**Personalities vs Sentiments:**
+- **Personalities** - Changes both voice AND style
+- **Sentiments** - Changes only style, keeps your current voice
+
+### 🌍 30+ Language Support
+
+Full multilingual support with native voice quality:
+- Spanish, French, German, Portuguese, Italian
+- Japanese, Korean, Chinese, Russian, Arabic
+- And 20+ more languages!
+
+```bash
+/agent-vibes:set-language spanish
+```
+
+### ⚡ Unified Speech Speed Control
+
+Fine-tune playback speed for both providers:
+
+```bash
+/agent-vibes:set-speed 2x      # Double speed
+/agent-vibes:set-speed 0.5x    # Half speed
+/agent-vibes:set-speed target 0.75x  # Slow target language for learning
+```
+
+### 🎵 Voice Replay & Management
+
+Missed what Claude said? Replay it:
+
+```bash
+/agent-vibes:replay             # Replay last message
+/agent-vibes:replay 5           # Replay 5th last message
+/agent-vibes:replay-target      # Replay last target language audio
+```
+
+### 🔌 Enhanced BMAD Plugin
+
+Auto voice switching for BMAD agents with multilingual support. Each agent can have its own voice and personality!
+
+### Audio Quality Improvements
+
+- Better bitrate preservation
+- Non-blocking playback
+- Improved provider switching
+- Smart context detection with project-specific settings
+
+## 🚀 Getting Started
+
+### For Claude Code Users
+
+One command installation:
+
+```bash
+npx agentvibes install
+```
+
+Enable the output style:
+
+```bash
+/output-style agent-vibes
+```
+
+### For Claude Desktop Users
+
+Add the MCP server to your Claude Desktop configuration:
+
+```json
+{
+  "mcpServers": {
+    "agentvibes": {
+      "command": "npx",
+      "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"],
+      "env": {
+        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+**Windows Users:** Check out our [Windows Setup Guide](https://github.com/paulpreibisch/AgentVibes/blob/main/mcp-server/WINDOWS_SETUP.md) for complete WSL and Python setup instructions.
+
+## 🎯 What's Next?
+
+We're continuously improving AgentVibes based on your feedback! Join our [GitHub Discussions](https://github.com/paulpreibisch/AgentVibes/discussions) to share ideas and feature requests.
+
+**Upcoming features:**
+- More voice options
+- Additional language learning modes
+- Enhanced personality customization
+- Community-created personalities
+
+## 📚 Resources
+
+- **[Full Documentation](https://github.com/paulpreibisch/AgentVibes)** - Complete guides and references
+- **[Voice Library](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/voice-library.md)** - Browse all 27+ voices
+- **[MCP Setup Guide](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/mcp-setup.md)** - Natural language setup
+- **[Language Learning Mode](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/language-learning-mode.md)** - Master a new language
+- **[Troubleshooting](https://github.com/paulpreibisch/AgentVibes/blob/main/docs/troubleshooting.md)** - Common issues & fixes
+
+---
+
+**Ready to give your AI a voice?** Install AgentVibes now and transform your coding experience!
+
+[Download on GitHub](https://github.com/paulpreibisch/AgentVibes) | [View Release Notes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.0.17-beta)

package/agentvibes.org/content/blog/language-learning-with-agentvibes.mdx

@@ -0,0 +1,142 @@
+---
+title: "Learn Spanish (or 30+ Languages) While You Code"
+description: "AgentVibes Language Learning Mode turns your coding sessions into immersive language learning experiences."
+date: "2025-10-12"
+author: "Paul Preibisch"
+tags: ["tutorial", "language-learning", "productivity"]
+---
+
+# Learn Spanish While You Code
+
+**What if you could learn a second language while programming?** That's exactly what AgentVibes Language Learning Mode enables!
+
+## Why Learn Mode?
+
+We believe that **repetition is the key to language learning**. Hearing phrases over and over again in another language - especially in real context - helps them stick in your memory naturally.
+
+But language learning shouldn't feel like a chore. It should be fun! That's why we built Learning Mode directly into your coding workflow. Every time Claude acknowledges a task, you hear it in both English and your target language. No extra effort, no interruption to your flow - just natural, contextual language learning that makes your coding journey more enjoyable.
+
+## How It Works
+
+When Language Learning Mode is enabled, every task acknowledgment plays **twice**:
+
+1. First in your main language (e.g., English)
+2. Then in your target language (e.g., Spanish)
+
+You hear the translation immediately, with context from your actual work!
+
+## Quick Setup
+
+### Step 1: Enable Learning Mode
+
+```bash
+/agent-vibes:learn
+```
+
+### Step 2: Set Your Target Language
+
+```bash
+/agent-vibes:target spanish
+```
+
+### Step 3: Code Normally!
+
+Now when Claude acknowledges tasks, you'll hear:
+
+> "I'll check that git status for you"
+> "Voy a revisar ese estado de git para ti"
+
+## Supported Languages
+
+AgentVibes supports **30+ languages**:
+
+- 🇪🇸 Spanish
+- 🇫🇷 French
+- 🇩🇪 German
+- 🇮🇹 Italian
+- 🇵🇹 Portuguese
+- 🇨🇳 Chinese
+- 🇯🇵 Japanese
+- 🇰🇷 Korean
+- And 22 more!
+
+View all languages:
+
+```bash
+/agent-vibes:set-language list
+```
+
+## Advanced Features
+
+### Control Speech Speed
+
+Slow down the target language for easier learning:
+
+```bash
+/agent-vibes:set-speed target 0.5x
+```
+
+### Replay Target Audio
+
+Want to hear that Spanish phrase again?
+
+```bash
+/agent-vibes:replay-target
+```
+
+### Mix with Personalities
+
+Learning mode works with any personality or sentiment:
+
+```bash
+/agent-vibes:personality pirate
+/agent-vibes:learn
+```
+
+Now you'll learn Spanish... from a pirate! 🏴‍☠️
+
+## Real-World Example
+
+Here's what a typical coding session looks like:
+
+```bash
+You: "Check git status"
+Claude: "I'll check the git status for you"
+Claude (Spanish): "Voy a revisar el estado de git para ti"
+
+[...runs git status...]
+
+Claude: "Your repository is clean"
+Claude (Spanish): "Tu repositorio está limpio"
+```
+
+## Learning Tips
+
+1. **Repeat Out Loud**: Say the target language phrase after hearing it
+2. **Adjust Speed**: Start slow, gradually increase
+3. **Focus on Tech Terms**: Learn programming vocabulary naturally
+4. **Use Replay**: Don't hesitate to replay phrases
+5. **Be Consistent**: Code daily for best results
+
+## Science Behind It
+
+Language Learning Mode uses **contextual immersion**:
+
+- **Context**: You know what the phrase means (you just asked for it!)
+- **Repetition**: You hear phrases multiple times throughout your session
+- **Relevance**: You're learning vocabulary you actually use
+- **Low Pressure**: No tests, just natural exposure
+
+## Disable When Needed
+
+Need to focus? Disable temporarily:
+
+```bash
+/agent-vibes:learn
+```
+
+(Toggle on/off with the same command)
+
+---
+
+**Start learning today**: [Install AgentVibes](https://github.com/paulpreibisch/AgentVibes) →

package/agentvibes.org/content/blog/voice-personalities-guide.mdx

@@ -0,0 +1,119 @@
+---
+title: "Complete Guide to Voice Personalities in AgentVibes"
+description: "Learn how to use the 19 built-in personalities and create custom ones to make your AI assistant truly unique."
+date: "2025-01-10"
+author: "Paul Preibisch"
+tags: ["guide", "personalities", "customization"]
+---
+
+# Complete Guide to Voice Personalities
+
+AgentVibes includes **19 built-in personalities** that transform how your AI assistant speaks. From sarcastic to flirty, pirate to zen - there's a personality for every mood!
+
+## What Are Personalities?
+
+Personalities in AgentVibes change **both the voice AND speaking style**. When you activate a personality, you get:
+
+- A unique voice character
+- Custom speaking patterns
+- Themed responses
+
+## Built-in Personalities
+
+### 😏 Sarcastic
+Voice: Jessica Anne Bogart
+Perfect for: Dry wit and cutting observations
+
+```bash
+/agent-vibes:personality sarcastic
+```
+
+### 💋 Flirty
+Voice: Jessica Anne Bogart
+Perfect for: Playful and charming interactions
+
+```bash
+/agent-vibes:personality flirty
+```
+
+### 🏴‍☠️ Pirate
+Voice: Pirate Marshal
+Perfect for: Adventurous coding sessions
+
+```bash
+/agent-vibes:personality pirate
+```
+
+### 🧘 Zen
+Voice: Northern Terry
+Perfect for: Calm, mindful development
+
+```bash
+/agent-vibes:personality zen
+```
+
+### 🤖 Robot
+Voice: Northern Terry
+Perfect for: Mechanical precision
+
+```bash
+/agent-vibes:personality robot
+```
+
+## Personalities vs Sentiments
+
+**Confused about personalities vs sentiments?** Here's the difference:
+
+- **Personalities**: Change BOTH voice AND style
+- **Sentiments**: Keep current voice, only change style
+
+Use **sentiments** when you love your current voice but want a different speaking style:
+
+```bash
+/agent-vibes:sentiment sarcastic
+```
+
+## Creating Custom Personalities
+
+Want to create your own personality? It's easy!
+
+```bash
+/agent-vibes:personality add mycustom
+```
+
+This creates a new file in `.claude/personalities/mycustom.md`. Edit it to customize:
+
+```markdown
+---
+name: mycustom
+description: Your custom personality
+elevenlabs_voice: Aria
+piper_voice: en_US-amy-medium
+---
+
+# My Custom Personality
+
+## AI Instructions
+
+Your custom instructions here...
+```
+
+## Pro Tips
+
+1. **Mix and Match**: Use personalities for fun, sentiments for precision
+2. **Project-Specific**: Different projects can have different personalities
+3. **Preview Voices**: Use `/agent-vibes:preview` to hear all voices before choosing
+4. **Replay**: Use `/agent-vibes:replay` to hear the last message again
+
+## Popular Combinations
+
+Here are some popular voice + sentiment combinations:
+
+- **Aria + Sarcastic**: Professional with attitude
+- **Northern Terry + Zen**: Calm wisdom
+- **Jessica + Flirty**: Playful charm
+- **Pirate Marshal + Angry**: Fierce determination
+
+---
+
+**Explore all personalities**: [View the complete list](https://github.com/paulpreibisch/AgentVibes/tree/master/.claude/personalities) →

package/agentvibes.org/lib/blog.ts

@@ -0,0 +1,73 @@
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+
+const postsDirectory = path.join(process.cwd(), 'content/blog');
+
+export interface BlogPost {
+  slug: string;
+  title: string;
+  description: string;
+  date: string;
+  author: string;
+  tags: string[];
+  content: string;
+}
+
+export function getAllPosts(): BlogPost[] {
+  const fileNames = fs.readdirSync(postsDirectory);
+  const allPostsData = fileNames
+    .filter((fileName) => fileName.endsWith('.mdx'))
+    .map((fileName) => {
+      const slug = fileName.replace(/\.mdx$/, '');
+      const fullPath = path.join(postsDirectory, fileName);
+      const fileContents = fs.readFileSync(fullPath, 'utf8');
+      const { data, content } = matter(fileContents);
+
+      return {
+        slug,
+        title: data.title,
+        description: data.description,
+        date: data.date,
+        author: data.author,
+        tags: data.tags || [],
+        content,
+      } as BlogPost;
+    });
+
+  // Sort posts by date
+  return allPostsData.sort((a, b) => {
+    if (a.date < b.date) {
+      return 1;
+    } else {
+      return -1;
+    }
+  });
+}
+
+export function getPostBySlug(slug: string): BlogPost | null {
+  try {
+    const fullPath = path.join(postsDirectory, `${slug}.mdx`);
+    const fileContents = fs.readFileSync(fullPath, 'utf8');
+    const { data, content } = matter(fileContents);
+
+    return {
+      slug,
+      title: data.title,
+      description: data.description,
+      date: data.date,
+      author: data.author,
+      tags: data.tags || [],
+      content,
+    } as BlogPost;
+  } catch (error) {
+    return null;
+  }
+}
+
+export function getAllSlugs(): string[] {
+  const fileNames = fs.readdirSync(postsDirectory);
+  return fileNames
+    .filter((fileName) => fileName.endsWith('.mdx'))
+    .map((fileName) => fileName.replace(/\.mdx$/, ''));
+}

package/agentvibes.org/next.config.js

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  pageExtensions: ['js', 'jsx', 'ts', 'tsx', 'md', 'mdx'],
+};
+
+module.exports = nextConfig;