diff --git a/src/core-skills/bmad-install-agentvibes/SKILL.md b/src/core-skills/bmad-install-agentvibes/SKILL.md new file mode 100644 index 000000000..e0ce71858 --- /dev/null +++ b/src/core-skills/bmad-install-agentvibes/SKILL.md @@ -0,0 +1,65 @@ +--- +name: bmad-install-agentvibes +description: 'Install AgentVibes TTS voice system for BMAD agents. Gives each agent a unique voice, personality, and audio effects. Use when user wants to add voice/TTS to their BMAD setup, or when bmad-party-mode is active and agents are silent.' +--- + +# Install AgentVibes + +AgentVibes is an open-source Text-to-Speech system that gives BMAD agents unique voices, personalities, and audio effects. Once installed, party mode agents speak aloud — each with their own voice. + +## What AgentVibes Provides + +- **Per-agent voices** — each BMAD agent gets a distinct voice via `bmad-voice-map.json` +- **Cross-platform** — Windows (SAPI + Piper), macOS, Linux, WSL +- **Personalities & effects** — reverb, background music, speed, sentiment +- **Party mode integration** — agents introduce themselves and speak sequentially + +## Installation + +Run the installer in the terminal: + +```bash +npx agentvibes install +``` + +Or if you prefer a global install first: + +```bash +npm install -g agentvibes +agentvibes install +``` + +**The installer will:** +1. Detect your platform (Windows/Mac/Linux/WSL) +2. Install the appropriate TTS provider (Piper recommended for best quality, SAPI as zero-dependency fallback on Windows) +3. Configure Claude Code hooks so agents speak automatically +4. Set up `bmad-speak.sh` / `bmad-speak.ps1` integration for party mode + +## Post-Install: Configure Agent Voices + +After installing, configure per-agent voices for party mode: + +``` +/agent-vibes:bmad +``` + +This opens the BMAD voice configuration where you can assign each agent a distinct voice, personality, and effects profile. + +## Verify Installation + +```bash +agentvibes whoami +``` + +Should display the active voice and provider. If party mode is active, agents will now speak when you run `/bmad-party-mode`. + +## Troubleshooting + +- **Agents still silent after install**: Run `agentvibes install` again — it is idempotent +- **Windows users**: Ensure PowerShell execution policy allows scripts: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` +- **Voice quality**: Install Piper for neural TTS — `agentvibes install` will prompt you + +## More Info + +- GitHub: https://github.com/paulpreibisch/AgentVibes +- Docs: `agentvibes --help` diff --git a/src/core-skills/module-help.csv b/src/core-skills/module-help.csv index 4a70c1bad..0999e1f91 100644 --- a/src/core-skills/module-help.csv +++ b/src/core-skills/module-help.csv @@ -1,6 +1,7 @@ module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs Core,bmad-brainstorming,Brainstorming,BSP,Use early in ideation or when stuck generating ideas.,,anytime,,,false,{output_folder}/brainstorming,brainstorming session Core,bmad-party-mode,Party Mode,PM,Orchestrate multi-agent discussions when you need multiple perspectives or want agents to collaborate.,,anytime,,,false,, +Core,bmad-install-agentvibes,Install AgentVibes,AV,Install AgentVibes TTS so party mode agents speak with unique voices. Run once after BMAD setup.,,anytime,,,false,, Core,bmad-help,BMad Help,BH,,,anytime,,,false,, Core,bmad-index-docs,Index Docs,ID,Use when LLM needs to understand available docs without loading everything.,,anytime,,,false,, Core,bmad-shard-doc,Shard Document,SD,Use when doc becomes too large (>500 lines) to manage effectively.,[path],anytime,,,false,, diff --git a/tools/installer/core/installer.js b/tools/installer/core/installer.js index a0ea9a66e..df6cb8f31 100644 --- a/tools/installer/core/installer.js +++ b/tools/installer/core/installer.js @@ -1121,7 +1121,58 @@ class Installer { lines.push(` Invoke the ${color.cyan('bmad-help')} skill in your IDE Agent to get started`); } + // AgentVibes TTS suggestion + lines.push( + '', + ` ${color.cyan('🎙 Want your BMAD agents to speak?')}`, + ` Install AgentVibes TTS: ${color.dim('npx agentvibes install')}`, + ` Gives each agent a unique voice in party mode and beyond.`, + ); + await prompts.note(lines.join('\n'), 'BMAD is ready to use!'); + + // Optional AgentVibes install prompt + if (!this._silentConfig) { + try { + const agentVibesChoice = await prompts.select({ + message: '🎙 Give your BMAD agents a voice? (AgentVibes TTS)', + choices: [ + { + name: 'Yes — install AgentVibes now', + value: 'install', + hint: 'runs npx agentvibes install', + }, + { + name: 'No — I\'ll do it later', + value: 'skip', + hint: 'npx agentvibes install', + }, + { + name: 'Tell me more', + value: 'info', + hint: 'github.com/paulpreibisch/AgentVibes', + }, + ], + default: 'skip', + }); + + if (agentVibesChoice === 'install') { + const { execSync } = require('node:child_process'); + await prompts.log.step('Running npx agentvibes install...'); + execSync('npx agentvibes install', { stdio: 'inherit' }); + } else if (agentVibesChoice === 'info') { + await prompts.log.info( + 'AgentVibes gives each BMAD agent a unique TTS voice, personality, and audio effects.\n' + + ' Works on Windows (SAPI + Piper), macOS, Linux, and WSL.\n' + + ' Party mode agents speak with their own voice — no more silent roundtables.\n\n' + + ' GitHub: https://github.com/paulpreibisch/AgentVibes\n' + + ' Install: npx agentvibes install' + ); + } + } catch { + // Prompt cancelled or AgentVibes install failed — non-fatal + } + } } /**