agentvibes 3.0.0 → 3.2.0

package/README.md

@@ -4,14 +4,14 @@
 >
 > 🌐 **[agentvibes.org](https://agentvibes.org)**
 >
-> Professional text-to-speech for **Claude Code**, **Claude Desktop**, and **Warp Terminal** - **Piper TTS (Free!)** or **macOS Say (Built-in!)**
+> Professional text-to-speech for **Claude Code**, **Claude Desktop**, **Warp Terminal**, and **Clawdbot** - **Piper TTS (Free!)** or **macOS Say (Built-in!)**
 
 [![npm version](https://img.shields.io/npm/v/agentvibes)](https://www.npmjs.com/package/agentvibes)
 [![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml)
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v3.0.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v3.2.0
 
 ---
 
@@ -22,6 +22,8 @@
 | **Install AgentVibes** (just `npx`, no git!) | [Quick Start Guide](docs/quick-start.md) |
 | **Understand what I need** (spoiler: just Node.js!) | [Prerequisites](#-prerequisites) |
 | **Set up on Windows (Claude Desktop)** | [Windows Setup Guide](mcp-server/WINDOWS_SETUP.md) |
+| **Use with Clawdbot** | [Clawdbot Integration](#-clawdbot-integration) |
+| **Run Claude Code on Android** | [Android/Termux Setup](#-android--termux) |
 | **Use natural language** | [MCP Setup](docs/mcp-setup.md) |
 | **Switch voices** | [Voice Library](docs/voice-library.md) |
 | **Learn Spanish while coding** | [Language Learning Mode](docs/language-learning-mode.md) |
@@ -33,7 +35,7 @@
 
 **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.
+Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Terminal, or running Clawdbot - AgentVibes brings AI to life with professional voices and personalities.
 
 ### 🎯 Key Features
 
@@ -115,17 +117,17 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v3.0.0 - Cross-Platform Remote Audio: Termux SSH Provider](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.0.0)** 📱
+**[v3.2.0 - Clawdbot Integration: AI Assistants on Any Messenger](https://github.com/paulpreibisch/AgentVibes/releases/tag/v3.2.0)** 🤖
 
-AgentVibes v3.0.0 introduces the termux-ssh TTS provider, enabling **true mobile-first interactive conversations with Claude Code**. Route TTS audio to your Android device via SSH—whether coding locally on your laptop or on remote servers—and have hands-free, voice-driven conversations with Claude using just your phone. This major release includes comprehensive Tailscale VPN setup documentation for internet-wide access, full MCP server integration, and transforms how developers interact with AI assistants. Perfect for developers who want to experience AI conversations naturally through their mobile device while their hands stay on the keyboard.
+AgentVibes v3.2.0 introduces seamless integration with Clawdbot, the revolutionary AI assistant accessible via any instant messenger. With this release, Clawdbot users get professional TTS with 50+ voices, remote SSH audio support for server deployments, and zero-configuration setup—just install AgentVibes and the Clawdbot skill is ready. The release also includes SonarCloud workflow fixes and improved test coverage validation.
 
 **Key Highlights:**
-- 📱 **Mobile-First AI Conversations** - Have fully interactive, hands-free conversations with Claude Code using just your Android device
-- 💻 **Local + Remote Development** - Works for both local coding (laptop → phone audio) and remote server development
-- 🌐 **Tailscale Integration** - Comprehensive guide for internet-wide device access without port forwarding or firewall configuration
-- 🎥 **Demo Video** - Watch it in action: [Mobile-First AI Conversations](https://youtu.be/ngLiA_KQtTA?si=wTwS4CJidIxWqLIP)
-- 🎯 **Full MCP Compatibility** - Complete integration with all MCP commands and workflows
-- 🛡️ **Quality Gates Integration** - Automated security validation in release process
+- 🤖 **Clawdbot Integration** - Native TTS support for Clawdbot AI assistant framework
+- 💬 **Messenger Platforms** - Works with WhatsApp, Telegram, Discord via Clawdbot
+- 🔊 **Remote SSH Audio** - Perfect for Clawdbot on remote servers with PulseAudio tunneling
+- 📦 **Simple Install** - Just `npx agentvibes install` and it works
+- 🛡️ **SonarCloud Fixes** - Quality gate workflow improvements and documentation
+- ✅ **Full Test Coverage** - All 213 BATS + 47 Node tests passing
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`
 
@@ -319,6 +321,85 @@ Then follow Linux requirements above inside WSL.
 - Audio routing from WSL to Windows requires PulseAudio configuration
 - See [Windows Setup Guide](mcp-server/WINDOWS_SETUP.md) for detailed audio setup
 
+#### 🤖 Android / Termux
+
+**Running Claude Code on Your Android Using Termux**
+
+AgentVibes fully supports Android devices through the [Termux app](https://termux.dev/). This enables you to run Claude Code with professional TTS voices directly on your Android phone or tablet!
+
+**Quick Setup:**
+
+```bash
+# 1. Install Termux from F-Droid (NOT Google Play - it's outdated)
+# Download: https://f-droid.org/en/packages/com.termux/
+
+# 2. Install Node.js in Termux
+pkg update && pkg upgrade
+pkg install nodejs-lts
+
+# 3. Install AgentVibes (auto-detects Android and runs Termux installer)
+npx agentvibes install
+```
+
+**What Gets Installed?**
+
+The Termux installer automatically sets up:
+- **proot-distro** with Debian (for glibc compatibility)
+- **Piper TTS** via proot wrapper (Android uses bionic libc, not glibc)
+- **termux-media-player** for audio playback (`paplay` doesn't work on Android)
+- **Audio dependencies**: ffmpeg, sox, bc for processing
+- **termux-api** for Android-specific audio routing
+
+**Why Termux Instead of Standard Installation?**
+
+Android's architecture requires special handling:
+- ❌ Standard pip/pipx fails (missing wheels for bionic libc)
+- ❌ Linux binaries require glibc (Android uses bionic)
+- ❌ `/tmp` directory is not accessible on Android
+- ❌ Standard audio tools like `paplay` don't exist
+
+✅ Termux installer solves all these issues with proot-distro and Android-native audio playback!
+
+**Requirements:**
+- [Termux app](https://f-droid.org/en/packages/com.termux/) (from F-Droid, NOT Google Play)
+- [Termux:API](https://f-droid.org/en/packages/com.termux.api/) (for audio playback)
+- Android 7.0+ (recommended: Android 10+)
+- ~500MB free storage (for Piper TTS + voice models)
+
+**Audio Playback:**
+- Uses `termux-media-player` instead of `paplay`
+- Audio automatically routes through Android's media system
+- Supports all Piper TTS voices (50+ languages)
+
+**Verifying Your Setup:**
+
+```bash
+# Check Termux environment
+echo $PREFIX               # Should show /data/data/com.termux/files/usr
+
+# Check Node.js
+node --version             # Should be ≥16.0
+
+# Check if Piper is installed
+which piper                # Should return /data/data/com.termux/files/usr/bin/piper
+
+# Test audio playback
+termux-media-player play /path/to/audio.wav
+```
+
+**Troubleshooting:**
+
+| Issue | Solution |
+|-------|----------|
+| "piper: not found" | Run `npx agentvibes install` - auto-detects Termux |
+| No audio playback | Install Termux:API from F-Droid |
+| Permission denied | Run `termux-setup-storage` to grant storage access |
+| Slow installation | Use WiFi, not mobile data (~300MB download) |
+
+**Why F-Droid and Not Google Play?**
+
+Google Play's Termux version is outdated and unsupported. Always use the [F-Droid version](https://f-droid.org/en/packages/com.termux/) for the latest security updates and compatibility.
+
 ### TTS Provider Requirements
 
 #### Piper TTS (Free, Offline)
@@ -545,6 +626,81 @@ This design means **any TTS provider** can integrate with BMAD by replacing thes
 
 ---
 
+## 🤖 Clawdbot Integration
+
+**Use AgentVibes TTS with Clawdbot - the revolutionary AI assistant you can access via any instant messenger!**
+
+**What is Clawdbot?** [Clawdbot](https://clawd.bot) is a revolutionary AI assistant that brings Claude AI to your favorite messaging platforms - WhatsApp, Telegram, Discord, and more. No apps to install, no websites to visit - just message your AI assistant like you would a friend.
+
+🌐 **Website**: https://clawd.bot
+
+AgentVibes seamlessly integrates with Clawdbot, providing professional text-to-speech for AI assistants running on messaging platforms and remote servers.
+
+### 🎯 Key Benefits
+
+- **Free & Offline**: No API costs, works without internet
+- **Remote SSH Audio**: Audio tunnels from server to local machine via PulseAudio
+- **50+ Voices**: Professional AI voices in 30+ languages
+- **Zero Config**: Automatic when AgentVibes is installed
+
+### 🚀 Installation
+
+```bash
+npx agentvibes install
+```
+
+That's it! AgentVibes is ready to use.
+
+### 📝 Usage
+
+```bash
+# Basic TTS
+npx agentvibes speak "Hello from Clawdbot"
+
+# With different voices
+npx agentvibes speak "Hello" --voice en_US-amy-medium
+npx agentvibes speak "Bonjour" --voice fr_FR-siwis-medium
+
+# List available voices
+npx agentvibes voices
+```
+
+### 🔊 Remote SSH Audio
+
+Perfect for running Clawdbot on a remote server with audio on your local machine:
+
+**Quick Setup:**
+
+1. **Remote server** - Configure PulseAudio:
+```bash
+echo 'export PULSE_SERVER=tcp:localhost:14713' >> ~/.bashrc
+source ~/.bashrc
+```
+
+2. **Local machine** - Add SSH tunnel (`~/.ssh/config`):
+```
+Host your-server
+    RemoteForward 14713 localhost:14713
+```
+
+3. **Connect and test**:
+```bash
+ssh your-server
+agentvibes speak "Testing remote audio from Clawdbot"
+```
+
+Audio plays on your local speakers! 🔊
+
+### 📚 Documentation
+
+- **Clawdbot Skill**: [.clawdbot/README.md](.clawdbot/README.md)
+- **Clawdbot Website**: https://clawd.bot
+- **Remote Audio Setup**: [docs/remote-audio-setup.md](docs/remote-audio-setup.md)
+
+[↑ Back to top](#-table-of-contents)
+
+---
+
 ## 📦 Installation Structure
 
 **What gets installed:** Commands, hooks, personalities, and plugins in `.claude/` directory.