Getting Started with AgentVibes

Ready to give your AI assistant a voice with personality? AgentVibes brings professional text-to-speech to your coding sessions!

What is AgentVibes?

AgentVibes was originally built for Claude Code using slash commands - a plugin system that lets you extend your AI assistant's capabilities. But we've evolved beyond that.

Introducing MCP Server Support - We now include an MCP (Model Context Protocol) server, which is essentially a plugin for AI assistants that enables natural language control. Instead of typing slash commands like /agent-vibes:switch Aria, you can simply say "Switch to Aria voice" and your AI assistant will understand.

This breakthrough means AgentVibes now works with:

• Claude Code - Anthropic's official CLI tool (using slash commands OR MCP)
• Claude Desktop - Anthropic's desktop app (using MCP)
• Warp Terminal - Advanced terminal with AI features (using slash commands)

Think of it as giving your AI assistant the ability to talk back with 150+ voices, 30+ languages, and 19 unique personalities!

Stay in Flow State with Auditory Feedback

The magic of AgentVibes isn't just about voices—it's about keeping you in flow state while coding. Here's how:

🎯 Auditory acknowledgments - When you give Claude a task, you immediately hear a spoken confirmation. No need to break your mental focus by watching the screen—your ears tell you Claude is working.

✅ Completion notifications - When Claude finishes, you hear it instantly. Whether you're reading documentation, sketching architecture, or deep in thought, the auditory signal brings you back at exactly the right moment.

🧠 Multitask without context switching - The human brain processes audio in parallel with visual tasks. You can keep your eyes on your code, documentation, or design mockups while Claude works in the background. When you hear "Done!", you know it's time to review—no constant screen-checking required.

This is the difference between monitoring your AI assistant (breaking flow) and collaborating with it (staying in flow). Your ears handle the status updates, your brain stays focused on the problem.

Choose Your Installation Path

Option 1: Claude Code (Quick Install)

For Claude Code users, installation is a single command:

npx agentvibes install

This automatically installs:

• All slash commands in .claude/commands/
• Voice management hooks in .claude/hooks/
• 19 built-in personalities
• AgentVibes output style

Option 2: Claude Desktop (MCP Server)

For Claude Desktop users, you'll need to install as an MCP server.

Requirements:

• Node.js (v14 or higher)
• Claude Desktop installed
• ElevenLabs API Key (optional - for premium voices) OR Piper TTS (free)

Quick setup:

• Windows users: Follow the Windows Installation Guide
• Mac/Linux users: Configure the MCP server in your Claude Desktop settings

For detailed MCP setup instructions, see the GitHub repo installation guide.

Step 2: Set Your API Key

If you're using ElevenLabs (premium voices), set your API key:

export ELEVENLABS_API_KEY="your-api-key-here"

Or add it to your shell profile:

echo 'export ELEVENLABS_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

Want to use free voices? No problem! Switch to Piper TTS:

/agent-vibes:provider switch piper

Step 3: Enable the Output Style

Activate AgentVibes in Claude Code:

/output-style agent-vibes

Your First Voice Session

Now test it out! Ask Claude to do something:

You: "Check git status"
Claude: "I'll check that git status for you" 🔊

You should hear Claude's response!

Configuration

Switch Voices

Try different voices:

# List all available voices
/agent-vibes:list

# Switch to a specific voice
/agent-vibes:switch Aria

# Preview voices before choosing
/agent-vibes:preview

Add Personality

Make Claude more fun:

# See all personalities
/agent-vibes:personality list

# Switch to pirate personality
/agent-vibes:personality pirate

# Or try sarcastic
/agent-vibes:personality sarcastic

Multilingual Support

Want to code in another language?

// Set language
/agent-vibes:set-language spanish

// Now Claude speaks Spanish!
// "Voy a revisar ese estado de git para ti"

MCP Setup (Natural Language Control)

For the best experience, install the AgentVibes MCP server. This lets you control AgentVibes with natural language instead of slash commands.

Add to your .mcp-minimal.json:

{
  "mcpServers": {
    "agentvibes": {
      "command": "npx",
      "args": ["-y", "agentvibes@beta", "agentvibes-mcp-server"],
      "env": {
        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
      }
    }
  }
}

Now just say:

• "Switch to Northern Terry voice"
• "Change personality to flirty"
• "Speak in French"

Tips & Tricks

1. Replay Audio

Missed what Claude said?

/agent-vibes:replay

2. Adjust Speed

Make it faster or slower:

/agent-vibes:set-speed 2x    # Double speed
/agent-vibes:set-speed 0.5x  # Half speed

3. Project-Specific Settings

Each project can have its own voice and personality! Settings are saved in .claude/ directory.

4. Custom Personalities

Create your own:

/agent-vibes:personality add mycustom

Edit .claude/personalities/mycustom.md to customize.

Troubleshooting

No Audio?

1. Check API key: echo $ELEVENLABS_API_KEY
2. Enable output style: /output-style agent-vibes
3. Test: /agent-vibes:sample Aria

Commands Not Found?

Reinstall:

npx agentvibes install --yes

Still Having Issues?

Check our troubleshooting guide or open an issue.

What's Next?

• Explore personalities: Try all 19 built-in personalities
• Language learning: Enable learning mode to learn Spanish while coding
• BMAD integration: Auto voice switching for BMAD agents
• Custom voices: Add your own ElevenLabs voices

---

Ready for more? Check out our complete documentation →