agentvibes 5.3.0 → 5.5.0

package/.claude/settings.json

@@ -1,15 +1,25 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-settings.json",
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash .claude/hooks/session-start-tts.sh"
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$CLAUDE_PROJECT_DIR\\.claude\\hooks-windows\\session-start-tts.ps1\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-start-tts.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/verbosity.txt

@@ -1 +1 @@
-high
+high

package/.clawdbot/README.md

@@ -1,105 +1,105 @@
-# Clawdbot Integration
-
-AgentVibes TTS integration for Clawdbot - the AI assistant framework.
-
-## What is Clawdbot?
-
-Clawdbot is a powerful AI assistant framework that connects Claude AI to messaging platforms (WhatsApp, Telegram, Discord, etc.) and provides extensible skills.
-
-**Website**: https://clawd.bot
-**GitHub**: https://github.com/clawdbot/clawdbot
-
-## AgentVibes + Clawdbot
-
-This integration provides Clawdbot with professional TTS capabilities using AgentVibes:
-
-- **Free & Offline**: No API costs, works without internet
-- **50+ Voices**: Professional AI voices in 30+ languages
-- **Remote SSH Support**: Audio tunnels from server to local machine
-- **Zero Setup**: Automatic when AgentVibes is installed
-
-## Installation
-
-```bash
-npx agentvibes install
-```
-
-That's it! AgentVibes is ready to use.
-
-## Usage from Clawdbot
-
-Once installed, use AgentVibes for TTS:
-
-```bash
-npx agentvibes speak "Hello from Clawdbot"
-```
-
-## Features
-
-- **Automatic Detection**: Clawdbot automatically uses AgentVibes when available
-- **Voice Selection**: 50+ voices across 30+ languages
-- **SSH Tunneling**: Audio plays on local machine from remote servers
-- **Zero Config**: Works out of the box once AgentVibes is installed
-
-## Remote SSH Audio
-
-When running Clawdbot on a remote server, set up PulseAudio tunneling so audio plays on your local machine:
-
-**Quick Setup:**
-
-1. **Remote server** (`~/.bashrc`):
-```bash
-export PULSE_SERVER=tcp:localhost:14713
-```
-
-2. **Local machine** (`~/.ssh/config`):
-```
-Host your-server
-    RemoteForward 14713 localhost:14713
-```
-
-3. **Connect and test**:
-```bash
-ssh your-server
-agentvibes speak "Testing remote audio"
-```
-
-**Full guide**: https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md
-
-## Documentation
-
-- **Skill Documentation**: [skill/SKILL.md](skill/SKILL.md)
-- **AgentVibes Docs**: https://agentvibes.org
-- **Clawdbot Docs**: https://docs.clawd.bot
-
-## Architecture
-
-```
-Clawdbot Request
-    ↓
-AgentVibes Skill (this)
-    ↓
-AgentVibes CLI (agentvibes speak)
-    ↓
-Piper TTS Engine
-    ↓
-PulseAudio → SSH Tunnel → Local Speakers
-```
-
-## Development
-
-The skill is automatically packaged with AgentVibes npm releases. To update:
-
-1. Edit `skill/SKILL.md`
-2. Test with Clawdbot
-3. Commit to AgentVibes repo
-4. Publish new AgentVibes version
-
-## Support
-
-- **AgentVibes Issues**: https://github.com/paulpreibisch/AgentVibes/issues
-- **Clawdbot Issues**: https://github.com/clawdbot/clawdbot/issues
-
-## License
-
-Apache 2.0 - Same as AgentVibes
+# Clawdbot Integration
+
+AgentVibes TTS integration for Clawdbot - the AI assistant framework.
+
+## What is Clawdbot?
+
+Clawdbot is a powerful AI assistant framework that connects Claude AI to messaging platforms (WhatsApp, Telegram, Discord, etc.) and provides extensible skills.
+
+**Website**: https://clawd.bot
+**GitHub**: https://github.com/clawdbot/clawdbot
+
+## AgentVibes + Clawdbot
+
+This integration provides Clawdbot with professional TTS capabilities using AgentVibes:
+
+- **Free & Offline**: No API costs, works without internet
+- **50+ Voices**: Professional AI voices in 30+ languages
+- **Remote SSH Support**: Audio tunnels from server to local machine
+- **Zero Setup**: Automatic when AgentVibes is installed
+
+## Installation
+
+```bash
+npx agentvibes install
+```
+
+That's it! AgentVibes is ready to use.
+
+## Usage from Clawdbot
+
+Once installed, use AgentVibes for TTS:
+
+```bash
+npx agentvibes speak "Hello from Clawdbot"
+```
+
+## Features
+
+- **Automatic Detection**: Clawdbot automatically uses AgentVibes when available
+- **Voice Selection**: 50+ voices across 30+ languages
+- **SSH Tunneling**: Audio plays on local machine from remote servers
+- **Zero Config**: Works out of the box once AgentVibes is installed
+
+## Remote SSH Audio
+
+When running Clawdbot on a remote server, set up PulseAudio tunneling so audio plays on your local machine:
+
+**Quick Setup:**
+
+1. **Remote server** (`~/.bashrc`):
+```bash
+export PULSE_SERVER=tcp:localhost:14713
+```
+
+2. **Local machine** (`~/.ssh/config`):
+```
+Host your-server
+    RemoteForward 14713 localhost:14713
+```
+
+3. **Connect and test**:
+```bash
+ssh your-server
+agentvibes speak "Testing remote audio"
+```
+
+**Full guide**: https://github.com/paulpreibisch/AgentVibes/blob/master/docs/remote-audio-setup.md
+
+## Documentation
+
+- **Skill Documentation**: [skill/SKILL.md](skill/SKILL.md)
+- **AgentVibes Docs**: https://agentvibes.org
+- **Clawdbot Docs**: https://docs.clawd.bot
+
+## Architecture
+
+```
+Clawdbot Request
+    ↓
+AgentVibes Skill (this)
+    ↓
+AgentVibes CLI (agentvibes speak)
+    ↓
+Piper TTS Engine
+    ↓
+PulseAudio → SSH Tunnel → Local Speakers
+```
+
+## Development
+
+The skill is automatically packaged with AgentVibes npm releases. To update:
+
+1. Edit `skill/SKILL.md`
+2. Test with Clawdbot
+3. Commit to AgentVibes repo
+4. Publish new AgentVibes version
+
+## Support
+
+- **AgentVibes Issues**: https://github.com/paulpreibisch/AgentVibes/issues
+- **Clawdbot Issues**: https://github.com/clawdbot/clawdbot/issues
+
+## License
+
+Apache 2.0 - Same as AgentVibes

package/.clawdbot/skill/SKILL.md

@@ -1,237 +1,241 @@
 ---
 name: agentvibes
-description: 🎤 AgentVibes TTS for Claude Code & OpenClaw — Switch voices, set personality, control speed, background music, language learning mode, reverb/effects, and more. Free offline TTS with 914+ Piper voices across 30+ languages. Works on Windows (SAPI/Piper), macOS (Say/Piper), Linux, and Android/Termux. No account or API key required.
+description: 🎤 AgentVibes Voice Management - Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say). Switch voices, preview audio, manage providers, add custom voices, and control TTS output.
 ---
 
 # 🎤 AgentVibes Voice Management
 
-Professional text-to-speech for Claude Code and OpenClaw. Free, offline, no account required.
-
-**Providers:** Piper TTS (914+ voices, all platforms) · macOS Say (built-in) · Windows SAPI (zero setup) · Soprano (neural)
+Manage your text-to-speech voices across multiple providers (Piper TTS, Piper, macOS Say).
 
 ---
 
-## Voice Commands
+## Available Commands
 
-### /agent-vibes:switch \<voice_name\>
-Switch to a different voice.
+### Voice Control
 
-```bash
-/agent-vibes:switch en_US-amy-medium
-/agent-vibes:switch en_GB-alan-medium
-/agent-vibes:switch fr_FR-siwis-medium
-```
+#### /agent-vibes:mute
+Mute all TTS output (persists across sessions)
 
-### /agent-vibes:list [first|last] [N]
-List available voices.
+- Creates a mute flag that silences all voice output
+- Shows 🔇 indicator when TTS would have played
 
 ```bash
-/agent-vibes:list                    # Show all voices
-/agent-vibes:list first 5            # Show first 5
-/agent-vibes:list last 3             # Show last 3
+/agent-vibes:mute
 ```
 
-### /agent-vibes:preview [first|last] [N]
-Preview voices with audio samples.
+#### /agent-vibes:unmute
+Unmute TTS output
 
-```bash
-/agent-vibes:preview                 # Preview first 3 voices
-/agent-vibes:preview 5               # Preview first 5
-/agent-vibes:preview last 5          # Preview last 5
-```
-
-### /agent-vibes:sample \<voice_name\>
-Play a sample of a specific voice.
+- Removes mute flag and restores voice output
 
 ```bash
-/agent-vibes:sample en_US-ryan-high
+/agent-vibes:unmute
 ```
 
-### /agent-vibes:get
-Show the currently active voice.
-
-### /agent-vibes:set-favorite-voice
-Mark current voice as your favorite.
-
----
-
-## Personality & Style
-
-### /agent-vibes:personality [name|list|add|edit|get|reset]
-Set a personality style for TTS output.
+#### /agent-vibes:list [first|last] [N]
+List all available voices, with optional filtering
 
 ```bash
-/agent-vibes:personality list          # Show available personalities
-/agent-vibes:personality sarcastic     # Switch to sarcastic style
-/agent-vibes:personality dramatic      # Switch to dramatic style
-/agent-vibes:personality reset         # Back to default
+/agent-vibes:list                    # Show all voices
+/agent-vibes:list first 5            # Show first 5 voices
+/agent-vibes:list last 3             # Show last 3 voices
 ```
 
-### /agent-vibes:set-pretext \<phrase\>
-Add a spoken prefix before every TTS message.
+#### /agent-vibes:preview [first|last] [N]
+Preview voices by playing audio samples
 
 ```bash
-/agent-vibes:set-pretext "AgentVibes"   # Speaks "AgentVibes: ..." before each message
-/agent-vibes:set-pretext ""              # Clear pretext
+/agent-vibes:preview                 # Preview first 3 voices
+/agent-vibes:preview 5               # Preview first 5 voices
+/agent-vibes:preview last 5          # Preview last 5 voices
 ```
 
----
-
-## Speed & Effects
-
-### /agent-vibes:set-speed \<speed\>
-Control speech rate (0.5x – 3.0x).
+#### /agent-vibes:switch <voice_name>
+Switch to a different default voice
 
 ```bash
-/agent-vibes:set-speed 1.0             # Normal speed
-/agent-vibes:set-speed 1.5             # 50% faster
-/agent-vibes:set-speed 0.8             # Slower
+/agent-vibes:switch en_US-amy-medium
+/agent-vibes:switch en_GB-alan-medium
+/agent-vibes:switch fr_FR-siwis-medium
 ```
 
-### /agent-vibes:effects [reverb|echo|pitch|eq|reset]
-Configure voice effects.
+#### /agent-vibes:get
+Display the currently selected voice
 
 ```bash
-/agent-vibes:effects reverb hall       # Hall reverb
-/agent-vibes:effects reverb none       # No reverb
-/agent-vibes:effects reset             # Clear all effects
+/agent-vibes:get
 ```
 
----
-
-## Background Music
-
-### /agent-vibes:background-music [on|off|status|list|switch]
-Toggle or change background music played under TTS.
+#### /agent-vibes:add <name> <voice_id>
+Add a new custom voice from your Piper TTS account
 
 ```bash
-/agent-vibes:background-music on       # Enable background music
-/agent-vibes:background-music off      # Disable
-/agent-vibes:background-music list     # Show available tracks
-/agent-vibes:background-music switch jazz  # Switch to jazz track
+/agent-vibes:add "My Voice" abc123xyz456
 ```
 
----
-
-## Verbosity
+See [Getting Voice IDs](#getting-voice-ids-piper-tts) section below.
 
-### /agent-vibes:verbosity [low|medium|high]
-Control how much Claude speaks while working.
+#### /agent-vibes:replay [N]
+Replay recently played TTS audio
 
 ```bash
-/agent-vibes:verbosity low             # Brief acknowledgments only
-/agent-vibes:verbosity medium          # Key decisions (default)
-/agent-vibes:verbosity high            # Full reasoning
+/agent-vibes:replay                  # Replay last audio
+/agent-vibes:replay 1                # Replay most recent
+/agent-vibes:replay 2                # Replay second-to-last
+/agent-vibes:replay 3                # Replay third-to-last
 ```
 
----
-
-## Mute / Replay
+Keeps last 10 audio files in history.
 
-### /agent-vibes:mute / /agent-vibes:unmute
-Silence or restore TTS output (persists across sessions).
-
-### /agent-vibes:replay [N]
-Replay recent audio (last 10 kept).
+#### /agent-vibes:set-pretext <word>
+Set a prefix word/phrase for all TTS messages
 
 ```bash
-/agent-vibes:replay                    # Replay last audio
-/agent-vibes:replay 2                  # Replay second-to-last
+/agent-vibes:set-pretext AgentVibes  # All TTS starts with "AgentVibes:"
+/agent-vibes:set-pretext "Project Alpha" # Custom phrase
+/agent-vibes:set-pretext ""          # Clear pretext
 ```
 
+Saved locally in `.agentvibes/config/agentvibes.json`
+
 ---
 
-## Language & Learning
+## Provider Management
 
-### /agent-vibes:language \<lang\>
-Set your native language.
+#### /agent-vibes:provider list
+Show all available TTS providers
 
 ```bash
-/agent-vibes:language english
-/agent-vibes:language japanese
+/agent-vibes:provider list
 ```
 
-### /agent-vibes:learn [on|off]
-Enable language learning mode — Claude speaks in both your native and target language.
+#### /agent-vibes:provider switch <name>
+Switch between providers
 
 ```bash
-/agent-vibes:learn on
-/agent-vibes:learn off
+/agent-vibes:provider switch piper    # Piper TTS - Free, offline, 50+ voices
+/agent-vibes:provider switch macos    # macOS Say - Native macOS voices (Mac only)
 ```
 
-### /agent-vibes:translate \<text\>
-Translate and speak text in the target language.
-
----
-
-## Provider Management
-
-### /agent-vibes:provider [list|switch|info]
+#### /agent-vibes:provider info <name>
+Get details about a specific provider
 
 ```bash
-/agent-vibes:provider list
-/agent-vibes:provider switch piper     # Piper TTS (free, offline, 914+ voices)
-/agent-vibes:provider switch macos     # macOS Say (Mac only)
-/agent-vibes:provider switch sapi      # Windows SAPI (Windows only, zero setup)
-/agent-vibes:provider switch soprano   # Soprano (neural)
+/agent-vibes:provider info piper
+/agent-vibes:provider info macos
 ```
 
 ---
 
 ## Providers
 
-| Provider | Platform | Cost | Voices |
-|----------|----------|------|--------|
-| **Piper TTS** | All platforms | Free, offline | 914+ in 30+ languages |
-| **macOS Say** | macOS only | Free (built-in) | 100+ system voices |
-| **Windows SAPI** | Windows only | Free (built-in) | System voices, zero setup |
-| **Soprano** | All platforms | Free | Neural voices |
-
----
+| Provider | Platform | Cost | Voices | Quality |
+|----------|----------|------|--------|---------|
+| **Piper TTS** | All platforms (Linux, macOS, WSL) | Free | 50+ in 30+ languages | ⭐⭐⭐⭐ |
+| **macOS Say** | macOS only | Free (built-in) | 100+ system voices | ⭐⭐⭐⭐ |
 
-## Miscellaneous
+**On macOS**, the native `say` provider is automatically detected and recommended!
 
-### /agent-vibes:whoami
-Show current AgentVibes configuration.
+---
 
-### /agent-vibes:version
-Show installed version.
+## Getting Voice IDs (Piper TTS)
 
-### /agent-vibes:update
-Update AgentVibes to the latest version.
+To add your own custom Piper TTS voices:
 
-### /agent-vibes:show / /agent-vibes:hide
-Show or hide the AgentVibes status indicator.
+1. Go to https://piper.io/app/voice-library
+2. Select or create a voice
+3. Copy the voice ID (15-30 character alphanumeric string)
+4. Use `/agent-vibes:add` to add it:
 
-### /agent-vibes:cleanup / /agent-vibes:clean
-Remove cached audio files.
+```bash
+/agent-vibes:add "My Custom Voice" xyz789abc123def456
+```
 
 ---
 
-## Default Voices (Piper TTS — Free & Offline)
+## Default Voices
+
+### Piper TTS (Free & Offline)
+
+**English (US):**
+- en_US-lessac-medium (default male voice)
+- en_US-amy-medium (friendly female)
+- en_US-ryan-high (high quality male)
+- en_US-libritts-high (multiple speakers)
+
+**English (UK):**
+- en_GB-alan-medium (British male)
+- en_GB-jenny_dioco-medium (British female)
+
+**Romance Languages:**
+- es_ES-davefx-medium (Spanish - Spain)
+- es_MX-claude-high (Spanish - Mexico)
+- fr_FR-siwis-medium (French female)
+- fr_FR-gilles-low (French male)
+- it_IT-riccardo-x_low (Italian male)
+- pt_BR-faber-medium (Portuguese - Brazilian)
+
+**Germanic Languages:**
+- de_DE-thorsten-medium (German male)
+- de_DE-eva_k-x_low (German female)
+
+**Asian Languages:**
+- ja_JP-ayanami-medium (Japanese female)
+- zh_CN-huayan-x_low (Chinese female)
+- ko_KR-kss-medium (Korean female)
+
+### macOS Say (100+ Built-in)
+- Samantha
+- Alex
+- Daniel
+- Victoria
+- Karen
+- Moira
+- And 100+ more system voices
 
-**English (US):** en_US-lessac-medium · en_US-amy-medium · en_US-ryan-high · en_US-libritts-high (914 speakers)
+---
 
-**English (UK):** en_GB-alan-medium · en_GB-jenny_dioco-medium
+## Quick Examples
 
-**French:** fr_FR-siwis-medium · fr_FR-gilles-low
+### Switch to a different voice
+```bash
+/agent-vibes:switch en_US-lessac-medium    # Clear male voice
+/agent-vibes:switch en_US-ryan-high        # High quality male
+/agent-vibes:switch en_GB-alan-medium      # British male
+```
 
-**German:** de_DE-thorsten-medium · de_DE-eva_k-x_low
+### Preview before choosing
+```bash
+/agent-vibes:preview 5                     # Preview first 5 voices
+/agent-vibes:preview last 3                # Preview last 3 voices
+```
 
-**Spanish:** es_ES-davefx-medium · es_MX-claude-high
+### Add your custom Piper voice
+```bash
+/agent-vibes:add "My Voice" abc123xyz456
+/agent-vibes:switch My Voice
+```
 
-**Japanese:** ja_JP-ayanami-medium · **Chinese:** zh_CN-huayan-x_low · **Korean:** ko_KR-kss-medium
+### Switch providers
+```bash
+/agent-vibes:provider switch macos    # Use native macOS voices
+/agent-vibes:provider switch piper    # Switch back to Piper
+```
 
-**+ 900 more** across 30+ languages. All voices are downloaded from [HuggingFace](https://huggingface.co/rhasspy/piper-voices) — no account required.
+### Mute/Unmute
+```bash
+/agent-vibes:mute                     # Silent mode
+/agent-vibes:unmute                   # Restore voice
+```
 
 ---
 
-## Tips
+## Tips & Tricks
 
-- **Preview first**: Use `/agent-vibes:preview` before committing to a voice
-- **Verbosity**: Set to `low` for focused work, `high` for full narration
-- **BMAD party mode**: Each agent gets their own voice, music, and personality
-- **Replay**: Use `/agent-vibes:replay` to re-hear the last 10 responses
-- **Speed**: Combine with personality for a fully custom TTS character
+- **Preview first**: Always use `/agent-vibes:preview` before switching to a new voice
+- **Provider switching**: Some voices are only available on specific providers
+- **Voice history**: Use `/agent-vibes:replay` to hear the last 10 TTS messages
+- **Custom pretext**: Set a pretext to brand all your responses (e.g., "AgentVibes:")
+- **Mute for focus**: Use `/agent-vibes:mute` during intensive work sessions
 
 Enjoy your TTS experience! 🎵