Finally! Your agents can talk back!
Professional text-to-speech for Claude Code, Claude Desktop, and Warp Terminal - ElevenLabs AI or Piper TTS (Free!)
Author: Paul Preibisch (@997Fire) | Version: v2.1.0
| I want to... | Go here |
|---|---|
| Install AgentVibes | Quick Start Guide |
| Set up on Windows (Claude Desktop) | Windows Setup Guide |
| Use natural language | MCP Setup |
| Switch voices | Voice Library |
| Learn Spanish while coding | Language Learning Mode |
| Fix issues | Troubleshooting |
AgentVibes adds lively voice narration to your Claude AI sessions!
Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp Terminal - AgentVibes brings AI to life with professional voices and personalities.
- 🎙️ AgentVibes MCP - NEW! Natural language control for Claude Code, Claude Desktop & Warp (no slash commands!)
- 📚 Language Learning Mode - NEW! Learn a second language while you program (e.g., Learn Spanish as you code!)
- 🔊 SSH Audio Optimization - NEW! Auto-detects remote sessions and eliminates static (VS Code Remote SSH, cloud dev)
- 🎭 Multi-Provider Support - Choose ElevenLabs (150+ premium voices) or Piper TTS (50+ free voices)
- 🌍 30+ Languages - Multilingual support with native voice quality
- 🎙️ 27+ Professional AI Voices - Character voices, accents, and unique personalities
- 🎭 19 Built-in Personalities - From sarcastic to flirty, pirate to dry humor
- 💬 Advanced Sentiment System - Apply personality styles to ANY voice without changing it
- 🔌 Enhanced BMAD Plugin - Auto voice switching for BMAD agents with multilingual support
- 🔊 Live Audio Feedback - Hear task acknowledgments and completions in any language
- 🎵 Voice Preview & Replay - Listen before you choose, replay last 10 TTS messages
- 🆓 Free Option Available - Use Piper TTS with no API key required
- ⚡ One-Command Install - Get started in seconds
- 🚀 Quick Start - Install in 3 steps
- ✨ What is AgentVibes? - Overview & key features
- 📰 Latest Release - What's new
- 🪟 Windows Setup Guide for Claude Desktop - Complete Windows installation with WSL & Python
- 🎙️ AgentVibes MCP Overview - Easiest way - Natural language commands
- For Claude Desktop - Windows/WSL setup, Python requirements
- For Warp Terminal - Warp configuration
- For Claude Code - Project-specific setup
- 🎤 Commands Reference - All available commands
- 📚 Language Learning Mode - NEW! Learn Spanish while you program
- 🎭 Personalities vs Sentiments - Two systems explained
- 🗣️ Voice Library - 27+ professional voices
- 🔌 BMAD Plugin - Auto voice switching for BMAD agents
- 📦 Installation Structure - What gets installed
- 💡 Common Workflows - Quick examples
- 🔧 Advanced Features - Custom voices & personalities
- 🔊 Remote Audio Setup - Play TTS from remote servers
- 🔬 Technical Deep Dive - How AgentVibes works under the hood
- ❓ Troubleshooting - Common issues & fixes
- 🔗 Useful Links - Voice typing & AI tools
- 🔄 Updating - Keep AgentVibes current
- 🙏 Credits - Acknowledgments
- 🤝 Contributing - Show support
v2.1.0 - Streamlined Installation & CI Improvements 🎉
NEW: Automatic Piper Installation! No more manual steps - when you select Piper TTS, AgentVibes now automatically detects if it's installed and offers to install it for you. Plus streamlined CI workflow improvements!
Key highlights:
- 🚀 Automatic Piper Installation - Auto-detects missing Piper binary and prompts to install it during setup
- ⚡ One-Command Setup - Runs
.claude/hooks/piper-installer.shseamlessly with human approval - 🎯 Fully Unattended Mode - Support for
--yesflag for automated installation - 🔧 CI Workflow Cleanup - Removed deprecated v1 branch references, tests now run on master only
- ✅ 110 Tests Passing - Comprehensive test coverage with optimized GitHub Actions workflow
→ View Full Release Notes | → View All Releases
Agent Vibes was originally created to give the Claude Code assistant a voice! Simply install it with an npx command in your terminal, and Claude Code can talk back to you.
We've now enhanced this capability by adding an MCP (Model Context Protocol) server. This integration exposes Agent Vibes' functionality directly to your AI assistant, allowing you to configure and control Agent Vibes using natural language instead of typing "/" slash commands.
Setting it up is straightforward: just add the MCP server to your Claude Code configuration files.
But the convenience doesn't stop there. With the MCP server in place, Claude Desktop can now use Agent Vibes too! We've even tested it successfully with Warp, an AI assistant that helps you navigate Windows and other operating systems.
We're thrilled about this expansion because it means Claude Desktop and Warp can finally talk back as well!
If you decide to use the MCP server on Claude Desktop, after configuration, give Claude Desktop this command: "every time i give you a command, speak the acknowledgement using agentvibes and the confirmation about what you completed, when done"—and watch the magic happen!
🎯 Control AgentVibes with natural language - no slash commands to remember!
Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands.
Works in: Claude Desktop, Claude Code, Warp Terminal
→ View Complete MCP Setup Guide - Full setup for all platforms, configuration examples, available tools, and MCP vs slash commands comparison
Get AgentVibes running in 3 steps: Install → Choose Provider (Piper/ElevenLabs) → Enable Voice
→ View Complete Quick Start Guide - Full installation options, provider setup, and activation steps
ElevenLabs (premium AI voices) or Piper TTS (free, works offline) - pick one and switch anytime.
AgentVibes provides 50+ slash commands and natural language MCP equivalents.
Quick Examples:
# Voice control
/agent-vibes:switch Aria # Or: "Switch to Aria voice"
/agent-vibes:list # Or: "List all voices"
# Personality & sentiment
/agent-vibes:personality pirate # Or: "Set personality to pirate"
/agent-vibes:sentiment sarcastic # Or: "Apply sarcastic sentiment"
# Language & learning
/agent-vibes:set-language spanish # Or: "Speak in Spanish"
/agent-vibes:learn # Or: "Enable learning mode"→ View Complete Command Reference - All voice, system, personality, sentiment, language, and BMAD commands with MCP equivalents
🎯 Learn Spanish (or 30+ languages) while you program! 🌍
Every task acknowledgment plays twice - first in English, then in your target language. Context-based learning while you code!
→ View Complete Learning Mode Guide - Full tutorial, quick start, commands, speech rate control, supported languages, and pro tips
Two ways to add personality:
- 🎪 Personalities - Changes BOTH voice AND speaking style (e.g.,
piratepersonality = Pirate Marshal voice + pirate speak) - 💭 Sentiments - Keeps your current voice, only changes speaking style (e.g., Aria voice + sarcastic sentiment)
→ Complete Personalities Guide - All 19 personalities, create custom ones
AgentVibes includes 27 unique ElevenLabs voices with multilingual support.
💡 Tip: Click voice names to hear samples on ElevenLabs!
🎧 Try in Claude Code: /agent-vibes:preview to hear all voices
🌍 Multilingual: Use Antoni, Rachel, Domi, or Bella for automatic language detection
→ View Complete Voice Library - All 27 voices with clickable samples, descriptions, and best use cases
Automatically switch voices when using BMAD agents!
The BMAD plugin detects when you activate a BMAD agent (e.g., /BMad:agents:pm) and automatically uses the assigned voice for that role.
→ View Complete BMAD Documentation - All agent mappings, language support, plugin management, and customization
What gets installed: Commands, hooks, personalities, plugins, and output styles in .claude/ directory.
→ View Complete Installation Structure - Full directory tree, file descriptions, and settings storage
# Switch voices
/agent-vibes:list # See all voices
/agent-vibes:switch Aria # Change voice
# Try personalities
/agent-vibes:personality pirate # Pirate voice + style
/agent-vibes:personality list # See all 19 personalities
# Speak in other languages
/agent-vibes:set-language spanish # Speak in Spanish
/agent-vibes:set-language list # See 30+ languages
# Replay audio
/agent-vibes:replay # Replay last message💡 Tip: Using MCP? Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands.
AgentVibes supports custom personalities, custom voices, and integration with custom output styles.
Quick Examples:
# Create custom personality
/agent-vibes:personality add mycustom
# Add custom ElevenLabs voice
/agent-vibes:add "My Voice" abc123xyz789
# Use in custom output styles
[Bash: .claude/hooks/play-tts.sh "Starting" "Aria"]→ View Advanced Features Guide - Custom personalities, custom voices, output style integration
Running AgentVibes on a remote server? No problem!
✅ Auto-detects SSH sessions - Works with VS Code Remote SSH, regular SSH, cloud dev environments ✅ Zero configuration - Audio optimizes automatically ✅ No static/clicking - Clean playback through SSH tunnels
→ Remote Audio Setup Guide - Full PulseAudio configuration details
- 🎤 WhisperTyping - Fast voice-to-text typing for developers
- 🗣️ OpenWhisper (Azure) - Microsoft's speech-to-text service
- 🎙️ ElevenLabs - Premium AI voice synthesis
- 🆓 Piper TTS - Free offline neural TTS
- 🤖 Claude Code - AI coding assistant
- 🎭 BMAD METHOD - Multi-agent framework
- 📊 Usage Dashboard - Monitor ElevenLabs usage
- 💳 Pricing Page - ElevenLabs plans
- 🐛 Issues - Report bugs
- 📝 Changelog - Version history
- 📰 Technical Deep Dive - LinkedIn Article - How AgentVibes works under the hood
Common Issues:
No Audio Playing?
- Check API key:
echo $ELEVENLABS_API_KEY - Enable output style:
/output-style agent-vibes - Test:
/agent-vibes:sample Aria
Commands Not Found?
npx agentvibes install --yes→ View Complete Troubleshooting Guide - Solutions for audio issues, command problems, MCP errors, voice issues, and more
Quick Update (From Claude Code):
/agent-vibes:updateAlternative Methods:
# Via npx
npx agentvibes update --yes
# Via npm (if installed globally)
npm update -g agentvibes && agentvibes update --yesCheck Version: /agent-vibes:version
→ View Complete Update Guide - All update methods, version checking, what gets updated, and troubleshooting
API Costs & Usage:
- ElevenLabs usage may incur charges based on your subscription tier and character usage
- Users are solely responsible for their own API costs and usage
- Free tier: 10,000 characters/month | Paid plans: $5-99/month
- See ElevenLabs Pricing for current rates
Third-Party Services:
- This project integrates with ElevenLabs (TTS API) and Piper TTS (local processing)
- We are not affiliated with, endorsed by, or officially connected to ElevenLabs, Anthropic, or Claude
- ElevenLabs and Piper TTS are subject to their respective terms of service
Privacy & Data:
- ElevenLabs: Your text prompts are sent to ElevenLabs servers for processing
- Piper TTS: All processing happens locally on your machine, no external data transmission
- Review ElevenLabs Privacy Policy for their data handling
Software License:
- Provided "as-is" under Apache 2.0 License without warranty of any kind
- See LICENSE file for full terms
- No liability for data loss, bugs, service interruptions, or any damages
Use at Your Own Risk:
- This is open-source software maintained by the community
- Always test in development before production use
- Monitor your API usage and costs regularly
Built with ❤️ by Paul Preibisch
- 🐦 Twitter: @997Fire
- 💼 LinkedIn: paul-preibisch
- 🌐 GitHub: paulpreibisch
Powered by:
- ElevenLabs - Premium AI voices
- Piper TTS - Free neural voices
- Claude Code - AI coding assistant
- Licensed under Apache 2.0
Special Thanks:
- 💡 Claude Code Hooks Mastery by @disler - Hooks inspiration
- 🤖 BMAD METHOD - Multi-agent framework with auto voice switching integration
If AgentVibes makes your coding more fun:
- ⭐ Star this repo on GitHub
- 🐦 Tweet and tag @997Fire
- 🎥 Share videos of Claude with personality
- 💬 Tell dev friends about voice-powered AI
Ready to give Claude a voice? Install now and code with personality! 🎤✨