agentvibes 4.6.7 → 5.0.0

package/.claude/hooks-windows/play-tts.ps1

@@ -10,21 +10,25 @@ param(
     [string]$Text,
 
     [Parameter(Mandatory = $false, Position = 1)]
-    [string]$VoiceOverride
+    [string]$VoiceOverride,
+
+    [Parameter(Mandatory = $false)]
+    [string]$llm = ""
 )
 
 # Configuration paths
 # Priority: CLAUDE_PROJECT_DIR env var → script's parent project → user profile
+# Local project settings ALWAYS override global (~/.claude)
 $ScriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
 
 if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
     $ClaudeDir = "$env:CLAUDE_PROJECT_DIR\.claude"
 } else {
     $PackageClaudeDir = Join-Path (Split-Path -Parent (Split-Path -Parent $ScriptPath)) ".claude"
-    if (Test-Path "$env:USERPROFILE\.claude\tts-provider.txt") {
-        $ClaudeDir = "$env:USERPROFILE\.claude"
-    } elseif (Test-Path $PackageClaudeDir) {
+    if (Test-Path $PackageClaudeDir) {
         $ClaudeDir = $PackageClaudeDir
+    } elseif (Test-Path "$env:USERPROFILE\.claude\tts-provider.txt") {
+        $ClaudeDir = "$env:USERPROFILE\.claude"
     } else {
         $ClaudeDir = "$env:USERPROFILE\.claude"
     }
@@ -42,6 +46,78 @@ if (Test-Path $MuteFile) {
     }
 }
 
+# Per-LLM config lookup: if --llm is passed, look up llm:<name> in audio-effects.cfg
+# Format: llm:<name>|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME|VOICE|PRETEXT
+$LlmVoice = ""
+$LlmPretext = ""
+$LlmReverb = ""
+$ProjectRoot = Split-Path -Parent $ClaudeDir
+$ConfigDir = "$ClaudeDir\config"
+
+if ($llm) {
+    $llmKey = "llm:$llm"
+    # Check project-local audio-effects.cfg first, then global
+    $cfgPaths = @(
+        "$ConfigDir\audio-effects.cfg",
+        "$env:USERPROFILE\.claude\config\audio-effects.cfg"
+    )
+    foreach ($cfgPath in $cfgPaths) {
+        if (-not $LlmVoice -and -not $LlmPretext -and (Test-Path $cfgPath)) {
+            foreach ($line in (Get-Content $cfgPath)) {
+                if ($line -match "^$([regex]::Escape($llmKey))\|") {
+                    $parts = $line -split '\|'
+                    # parts: [0]=key [1]=reverb_preset [2]=bg_file [3]=bg_vol [4]=voice [5]=pretext
+                    if ($parts.Length -ge 2 -and $parts[1].Trim()) {
+                        $LlmReverb = $parts[1].Trim()
+                    }
+                    if ($parts.Length -ge 5 -and $parts[4].Trim()) {
+                        $LlmVoice = $parts[4].Trim()
+                    }
+                    if ($parts.Length -ge 6 -and $parts[5].Trim()) {
+                        $LlmPretext = $parts[5].Trim()
+                    }
+                    break
+                }
+            }
+        }
+    }
+    # Apply LLM voice override (only if no explicit VoiceOverride was passed)
+    if ($LlmVoice -and -not $VoiceOverride) {
+        $VoiceOverride = $LlmVoice
+    }
+    # Export LLM key for child scripts (process-local, not system-wide)
+    $env:AGENTVIBES_LLM_KEY = "llm:$llm"
+}
+
+# Prepend pretext if configured
+# Priority: LLM-specific pretext → project .agentvibes/config.json → project .claude/config/tts-pretext.txt
+#           → global ~/.agentvibes/config.json → global ~/.claude/config/tts-pretext.txt
+$Pretext = $LlmPretext
+if (-not $Pretext) {
+    $PretextSources = @(
+        (Join-Path $ProjectRoot ".agentvibes\config.json"),
+        "$ClaudeDir\config\tts-pretext.txt",
+        "$env:USERPROFILE\.agentvibes\config.json",
+        "$env:USERPROFILE\.claude\config\tts-pretext.txt"
+    )
+    foreach ($src in $PretextSources) {
+        if (-not $Pretext -and (Test-Path $src)) {
+            if ($src -match '\.json$') {
+                try {
+                    $avCfg = Get-Content $src -Raw | ConvertFrom-Json
+                    if ($avCfg.pretext) { $Pretext = $avCfg.pretext.Trim() }
+                } catch { }
+            } else {
+                $val = (Get-Content $src -Raw).Trim()
+                if ($val) { $Pretext = $val }
+            }
+        }
+    }
+}
+if ($Pretext) {
+    $Text = "$Pretext, $Text"
+}
+
 # Determine active provider
 $ActiveProvider = "sapi"
 if (Test-Path $ProviderFile) {
@@ -101,12 +177,17 @@ if (Test-Path $AgentVibesConfig) {
 }
 
 # Check if reverb is enabled (allowlist validation)
+# LLM-specific reverb overrides global setting
 $ReverbLevel = "off"
-$ReverbFile = "$ConfigDir\reverb-level.txt"
-if (Test-Path $ReverbFile) {
-    $reverbVal = (Get-Content $ReverbFile -Raw).Trim()
-    if ($reverbVal -in @("off", "light", "medium", "heavy", "cathedral")) {
-        $ReverbLevel = $reverbVal
+if ($LlmReverb -and $LlmReverb -in @("off", "light", "medium", "heavy", "cathedral")) {
+    $ReverbLevel = $LlmReverb
+} else {
+    $ReverbFile = "$ConfigDir\reverb-level.txt"
+    if (Test-Path $ReverbFile) {
+        $reverbVal = (Get-Content $ReverbFile -Raw).Trim()
+        if ($reverbVal -in @("off", "light", "medium", "heavy", "cathedral")) {
+            $ReverbLevel = $reverbVal
+        }
     }
 }
 $HasReverb = $ReverbLevel -ne "off"
@@ -241,6 +322,7 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
             if (Test-Path $AudioEffectsCfg) {
                 # Try agent-specific config first, then fall back to default
                 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
+                # Lookup order: agent name → llm:<name> → default
                 $agentName = $env:AGENTVIBES_AGENT_NAME
                 $configLine = $null
 
@@ -253,6 +335,16 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                         }
                     }
                 }
+                # Try LLM-specific config (--llm parameter)
+                if (-not $configLine -and $llm) {
+                    $llmBgKey = "llm:$llm"
+                    foreach ($line in $cfgLines) {
+                        if ($line -match "^$([regex]::Escape($llmBgKey))\|") {
+                            $configLine = $line
+                            break
+                        }
+                    }
+                }
                 # Fall back to default
                 if (-not $configLine) {
                     foreach ($line in $cfgLines) {

package/.claude/hooks-windows/session-start-tts.ps1

@@ -1,114 +1,114 @@
-#
-# File: .claude/hooks-windows/session-start-tts.ps1
-#
-# AgentVibes SessionStart Hook for Windows
-# Outputs JSON with hookSpecificOutput.additionalContext for reliable context injection.
-# Mirrors session-start-tts.sh — keep both in sync.
-#
-
-$ErrorActionPreference = "Stop"
-
-# Get script directory
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-# Check if AgentVibes is installed
-if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
-    exit 0
-}
-
-# Resolve project .claude dir from script location (avoids CWD-relative path issues)
-$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
-$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
-
-# Check for sentiment (priority) or personality (fallback)
-$Sentiment = ""
-$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
-foreach ($p in $sentimentPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Sentiment = $val; break }
-    }
-}
-
-$Personality = "normal"
-$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
-foreach ($p in $personalityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Personality = $val; break }
-    }
-}
-
-$Style = if ($Sentiment) { $Sentiment } else { $Personality }
-
-# Get verbosity level
-$Verbosity = "low"
-$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
-foreach ($p in $verbosityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Verbosity = $val; break }
-    }
-}
-
-# Build verbosity section
-$VerbositySection = switch ($Verbosity) {
-    "low"    { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only`n- Skip: Reasoning, decisions" }
-    "medium" { "## Verbosity: MEDIUM`n- Acknowledgment: Action + key approach`n- Completion: Result + important decisions`n- Include: Major choices only" }
-    "high"   { "## Verbosity: HIGH`n- Acknowledgment: Action + approach + why`n- Completion: Result + decisions + trade-offs`n- Include: Full reasoning, alternatives" }
-    default  { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only" }
-}
-
-# Build full context string
-$Context = @"
-# AgentVibes TTS Protocol
-
-**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
-
-1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]"``
-2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]"``
-
-**Example:**
-``````
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status"]
-[work...]
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes"]
-``````
-
-$VerbositySection
-
-## Style: $Style
-
-## Rules
-1. Never skip acknowledgment TTS
-2. Never skip completion TTS
-3. Match verbosity level
-4. Keep under 150 chars
-5. Always include errors
-
-Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
-
-## BMAD Agent Voice Routing
-If ``.bmad-agent-context`` exists, check its content:
-
-**Single agent mode** (content is an agent ID like "analyst"):
-Use ``bmad-speak.ps1`` instead of ``play-tts.ps1``:
-
-
-**Party mode** (content is "party-mode"):
-Each agent speaks via ``bmad-speak.ps1`` with their display name. The queue system ensures sequential playback — agents speak one at a time, not overlapping:
-
-IMPORTANT: In party mode, do NOT use ``play-tts.ps1``. Always use ``bmad-speak.ps1`` with the agent's display name. Do NOT call multiple bmad-speak.ps1 in parallel — call them sequentially so the queue processes them in order.
-
-If ``.bmad-agent-context`` does NOT exist, use ``play-tts.ps1`` as normal.
-"@
-
-# Build JSON via hashtable so ConvertTo-Json handles all escaping (Unicode, backslashes, quotes)
-$Output = @{
-    hookSpecificOutput = @{
-        hookEventName   = "SessionStart"
-        additionalContext = $Context
-    }
-}
-[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
-Write-Output ($Output | ConvertTo-Json -Compress -Depth 5)
+#
+# File: .claude/hooks-windows/session-start-tts.ps1
+#
+# AgentVibes SessionStart Hook for Windows
+# Outputs JSON with hookSpecificOutput.additionalContext for reliable context injection.
+# Mirrors session-start-tts.sh — keep both in sync.
+#
+
+$ErrorActionPreference = "Stop"
+
+# Get script directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Check if AgentVibes is installed
+if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
+    exit 0
+}
+
+# Resolve project .claude dir from script location (avoids CWD-relative path issues)
+$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
+$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
+
+# Check for sentiment (priority) or personality (fallback)
+$Sentiment = ""
+$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
+foreach ($p in $sentimentPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Sentiment = $val; break }
+    }
+}
+
+$Personality = "normal"
+$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
+foreach ($p in $personalityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Personality = $val; break }
+    }
+}
+
+$Style = if ($Sentiment) { $Sentiment } else { $Personality }
+
+# Get verbosity level
+$Verbosity = "low"
+$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
+foreach ($p in $verbosityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Verbosity = $val; break }
+    }
+}
+
+# Build verbosity section
+$VerbositySection = switch ($Verbosity) {
+    "low"    { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only`n- Skip: Reasoning, decisions" }
+    "medium" { "## Verbosity: MEDIUM`n- Acknowledgment: Action + key approach`n- Completion: Result + important decisions`n- Include: Major choices only" }
+    "high"   { "## Verbosity: HIGH`n- Acknowledgment: Action + approach + why`n- Completion: Result + decisions + trade-offs`n- Include: Full reasoning, alternatives" }
+    default  { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only" }
+}
+
+# Build full context string
+$Context = @"
+# AgentVibes TTS Protocol
+
+**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
+
+1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]" -llm claude-code``
+2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]" -llm claude-code``
+
+**Example:**
+``````
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status" -llm claude-code]
+[work...]
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes" -llm claude-code]
+``````
+
+$VerbositySection
+
+## Style: $Style
+
+## Rules
+1. Never skip acknowledgment TTS
+2. Never skip completion TTS
+3. Match verbosity level
+4. Keep under 150 chars
+5. Always include errors
+
+Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
+
+## BMAD Agent Voice Routing
+If ``.bmad-agent-context`` exists, check its content:
+
+**Single agent mode** (content is an agent ID like "analyst"):
+Use ``bmad-speak.ps1`` instead of ``play-tts.ps1``:
+
+
+**Party mode** (content is "party-mode"):
+Each agent speaks via ``bmad-speak.ps1`` with their display name. The queue system ensures sequential playback — agents speak one at a time, not overlapping:
+
+IMPORTANT: In party mode, do NOT use ``play-tts.ps1``. Always use ``bmad-speak.ps1`` with the agent's display name. Do NOT call multiple bmad-speak.ps1 in parallel — call them sequentially so the queue processes them in order.
+
+If ``.bmad-agent-context`` does NOT exist, use ``play-tts.ps1`` as normal.
+"@
+
+# Build JSON via hashtable so ConvertTo-Json handles all escaping (Unicode, backslashes, quotes)
+$Output = @{
+    hookSpecificOutput = @{
+        hookEventName   = "SessionStart"
+        additionalContext = $Context
+    }
+}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+Write-Output ($Output | ConvertTo-Json -Compress -Depth 5)

package/README.md

@@ -4,14 +4,14 @@
 >
 > 🌐 **[agentvibes.org](https://agentvibes.org)**
 >
-> Professional text-to-speech for **Claude Code**, **Claude Desktop**, and **OpenClaw** - **Soprano** (Neural), **Piper TTS** (Free!), **macOS Say** (Built-in!), or **Windows SAPI** (Zero Setup!)
+> Professional text-to-speech for **Claude Code**, **GitHub Copilot**, **OpenAI Codex**, **Claude Desktop**, and **OpenClaw**. Using popular open-source TTS engines: **Soprano** (Neural), **Piper TTS** (Free!), **macOS Say** (Built-in!), or **Windows SAPI** (Zero Setup!)
 
 [![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**: v4.6.7
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.0.0
 
 ---
 
@@ -20,11 +20,13 @@
 | I want to... | Go here |
 |--------------|---------|
 | **Install AgentVibes** (just `npx`, no git!) | [Quick Start Guide](docs/quick-start.md) |
-| **Run Claude Code on Android** | [Android/Termux Setup](#-android--termux) |
+| **Play agent audio using your phone as remote speakers** | [Android/Termux Setup](#-android--termux) |
 | **Secure OpenClaw on Remote Server** | [Security Hardening Guide](docs/security-hardening-guide.md) ⚠️ |
 | **Understand what I need** | [Prerequisites](#-prerequisites) |
 | **Set up on Windows (Native)** | [Windows Native Setup](WINDOWS-SETUP.md) |
 | **Set up on Windows (Claude Desktop/WSL)** | [Windows WSL Guide](mcp-server/WINDOWS_SETUP.md) |
+| **Use with GitHub Copilot** | [Copilot Integration](#-github-copilot-integration) |
+| **Use with OpenAI Codex** | [Codex Integration](#-openai-codex-integration) |
 | **Use with OpenClaw** | [OpenClaw Integration](#-openclaw-integration) |
 | **Use natural language** | [MCP Setup](docs/mcp-setup.md) |
 | **Switch voices** | [Voice Library](docs/voice-library.md) |
@@ -35,13 +37,31 @@
 
 ## ✨ What is AgentVibes?
 
-**AgentVibes adds lively voice narration to your Claude AI sessions!**
+**AgentVibes adds lively voice narration to your AI coding sessions!**
 
-Whether you're coding in Claude Code, chatting in Claude Desktop, or running OpenClaw — AgentVibes brings AI to life with professional voices and personalities.
+Whether you're using Claude Code, GitHub Copilot, OpenAI Codex, Claude Desktop, or OpenClaw — AgentVibes brings AI to life with professional voices and personalities.
 
 ---
 
-## 🎙️ NEW IN v4.6.7 — Party Mode TTS Fixes
+## 🚀 NEW IN v5.0.0 — Multi-Provider Support: Claude Code + Copilot + Codex
+
+- **GitHub Copilot + OpenAI Codex in VS Code** — AgentVibes now supports all three major AI coding assistants. Install and configure each from the TUI.
+- **One Setup tab** — 4-step wizard (Language → Deps → TTS Engine → Providers) replaces old installer + LLM tabs. Returning users skip to Providers.
+- **Per-provider audio config** — Each LLM gets its own Voice, TTS Engine, Reverb, Music, and Pretext via Configure modal.
+- **Settings redesigned** — Clean flat list: Language, TTS Engine, Voice, Verbosity, Audio Destination, Config Storage, Re-run Wizard.
+- **Voice picker upgraded** — 3-column display, Space bar preview, scroll stays in place.
+
+---
+
+## 🐛 v4.6.8 — Fresh Install Crash Fix
+
+- **Settings tab crash fixed** — no longer crashes when navigating to Settings on a fresh install with no voice configured
+- **macOS test fix** — replay path assertion handles `/var` → `/private/var` symlink
+- **BMAD pretext parsing improved** — voices pretext extracted correctly from `bmad-voices.md`
+
+---
+
+## 🎙️ v4.6.7 — Party Mode TTS Fixes
 
 - **Agent pretexts now spoken in party mode** — "John, Product Manager here" was being silently dropped due to a pre-synthesis timing bug. Fixed.
 - **No more spoken asterisks** — markdown stripped before TTS in party mode
@@ -50,7 +70,7 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or running Ope
 
 ---
 
-## 🧭 NEW IN v4.6.6 — Natural TUI Navigation
+## 🧭 v4.6.6 — Natural TUI Navigation
 
 The Settings TUI now flows the way you'd expect. Down moves top-to-bottom through header → sub-tabs → content → footer. Left/Right switches sub-tabs and moves between footer buttons. Up from content returns to the active sub-tab — not always Voice. The Language tab has a proper scrollable list. Readme falls back to the AgentVibes package README when no local one exists. Escape from the installer no longer gets stuck.
 
@@ -485,6 +505,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 - [🎙️ AgentVibes Receiver - NEW!](#%EF%B8%8F-agentvibes-receiver-remote-audio-streaming-from-voiceless-servers) - Remote audio streaming from voiceless servers
 
 ### Integrations & Platforms
+- [🤝 GitHub Copilot Integration](#-github-copilot-integration) - Use AgentVibes TTS with GitHub Copilot CLI
 - [🤖 OpenClaw Integration](#-openclaw-integration) - Use AgentVibes with OpenClaw messaging platform
   - [🎙️ AgentVibes Skill for OpenClaw](#-agentvibes-skill-for-openclaw---what-you-get) - 50+ voices, effects, personalities for OpenClaw
   - [📱 AgentVibes Receiver](#-agentvibes-receiver-local-phone-) - Remote audio on phones/local machines
@@ -1240,6 +1261,85 @@ This design means **any TTS provider** can integrate with BMAD by replacing thes
 
 ---
 
+## 🤝 GitHub Copilot Integration
+
+**Use AgentVibes with GitHub Copilot in VS Code — same voices, same personalities, same MCP tools!**
+
+Copilot discovers AgentVibes through two mechanisms:
+
+1. **`.github/copilot-instructions.md`** — VS Code automatically reads this file and tells Copilot *how* to speak (acknowledge at start, summarize at end, match verbosity, stay under 150 chars)
+2. **`.vscode/mcp.json`** — registers the AgentVibes MCP server so Copilot can call `text_to_speech`, `set_voice`, and other tools
+
+### Setup
+
+**Step 1: Install AgentVibes** (if you haven't already)
+
+```bash
+npx agentvibes install
+```
+
+**Step 2: Configure VS Code MCP**
+
+Open the AgentVibes console and go to the **LLM** tab (press `L`):
+
+```bash
+npx agentvibes
+```
+
+Select **GitHub Copilot** and press Enter to install. This creates `.vscode/mcp.json` with the AgentVibes MCP server config and copies `.github/copilot-instructions.md` with the TTS protocol.
+
+You can also create `.vscode/mcp.json` manually in your project root:
+
+```json
+{
+  "servers": {
+    "agentvibes": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]
+    }
+  }
+}
+```
+
+VS Code starts the MCP server automatically when Copilot needs it — no manual server launch required.
+
+**Step 3: Verify**
+
+Open Copilot Chat in VS Code (Ctrl+Shift+I) and ask it to do something. You should hear an acknowledgment when Copilot starts working and a summary when it finishes.
+
+### What Copilot Can Do
+
+Through the MCP tools, Copilot has the same voice capabilities as Claude Code:
+
+| Tool | What it does |
+|------|-------------|
+| `text_to_speech` | Speak text aloud |
+| `set_voice` | Switch voices (e.g., "ryan", "katherine") |
+| `set_personality` | Change personality (sarcastic, pirate, zen) |
+| `set_speed` | Adjust speech rate |
+| `set_verbosity` | Control detail level (low/medium/high) |
+| `mute` / `unmute` | Toggle audio |
+| `get_config` | Read current settings |
+
+### BMAD Party Mode
+
+Copilot respects BMAD party mode. If `.bmad-agent-context` contains `party-mode`, each BMAD agent speaks with its own voice — the same per-agent routing that works in Claude Code.
+
+### Differences from Claude Code
+
+| Feature | Claude Code | Copilot in VS Code |
+|---------|------------|-------------|
+| TTS Protocol | Injected via session-start hook | Read from `.github/copilot-instructions.md` |
+| MCP config | `.mcp.json` (project root) | `.vscode/mcp.json` |
+| Server lifecycle | Managed by Claude Code | Managed by VS Code (auto-start) |
+| MCP tools | Same | Same |
+| BMAD party mode | Supported | Supported |
+
+[↑ Back to top](#-table-of-contents)
+
+---
+
 ## 🤖 OpenClaw Integration
 
 **Use AgentVibes TTS with OpenClaw - the revolutionary AI assistant you can access via any instant messenger!**

package/RELEASE_NOTES.md

@@ -1,5 +1,59 @@
 # AgentVibes Release Notes
 
+## 🚀 v5.0.0 — Multi-Provider Support: Claude Code + Copilot + Codex
+
+**Release Date:** April 2026
+
+### New Features
+
+- **GitHub Copilot Support in VS Code** — Install and configure AgentVibes for GitHub Copilot directly from the TUI. Creates `.vscode/mcp.json` and `.github/copilot-instructions.md`.
+
+- **OpenAI Codex Support in VS Code** — Full Codex integration with `.codex/config.toml`, `AGENTS.md` TTS protocol, and init hooks.
+
+- **Unified Setup Tab** — The old 5-screen Install wizard and separate LLM Providers tab are merged into a single Setup tab. First-run shows a 4-step wizard (Language → Dependencies → TTS Engine → Providers); returning users skip straight to the Providers screen.
+
+- **Per-Provider Audio Config** — Each LLM provider (Claude Code, Copilot, Codex) gets its own TTS Engine, Voice, Reverb, Background Music, and Pretext via a Configure modal.
+
+- **TTS Engine Selection Screen** — New wizard step shows OS-aware engine list (Piper, Soprano, Windows SAPI, macOS Say) with Install buttons for missing engines.
+
+- **Settings Tab Redesigned** — Replaced the 5-sub-tab layout with a clean flat list: Interface Language, Default TTS Engine, Default Voice, Verbosity, Audio Destination, Config Storage, and Re-run Setup Wizard.
+
+### Improvements
+
+- **Voice picker upgraded everywhere** — 3-column display (Name, Gender, Provider), Space bar preview with synthesis + playback, scroll position preserved during preview.
+
+- **Hint text artifacts fixed** — Moving between rows in Agents and Music tabs no longer leaves ghost text on previous rows.
+
+- **Codex voice routing corrected** — `AGENTS.md` now instructs Codex to use `play-tts` for normal speech and `bmad-speak` only during BMAD party mode.
+
+### User Impact
+
+- AgentVibes now works with Claude Code, GitHub Copilot, AND OpenAI Codex
+- Streamlined setup experience — one tab for all provider management
+- Per-provider voice customization without editing config files
+- Settings page is dramatically simpler and faster to navigate
+
+---
+
+## 🐛 v4.6.8 — Fresh Install Crash Fix
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Settings tab no longer crashes on fresh install** — `parseMultiSpeaker()` called `.includes()` on a null voice ID when no voice was configured yet. Added a null guard that returns a safe default object. Reported by a user hitting this immediately after the install wizard completed.
+
+- **macOS /var symlink in replay test** — Fixed test assertion that failed on macOS where `/var` is a symlink to `/private/var`, causing replay path comparisons to break.
+
+- **BMAD voices pretext parsing** — `bmad-voices.md` pretext lines are now correctly parsed and markdown is stripped more thoroughly before TTS synthesis.
+
+### User Impact
+
+- New users no longer crash when navigating to Settings after a fresh install
+- Test suite passes reliably on macOS
+
+---
+
 ## 🎙️ v4.6.7 — Party Mode TTS Fixes
 
 **Release Date:** April 2026

package/bin/bmad-speak.js

@@ -33,20 +33,28 @@ function resolveScript(relPath) {
   return null;
 }
 
+function hasProjectBmadManifest() {
+  return fs.existsSync(path.join(process.cwd(), '_bmad', '_config', 'agent-manifest.csv'));
+}
+
 let result;
 
 if (IS_WINDOWS) {
-  const script = resolveScript('.claude/hooks-windows/bmad-speak.ps1');
+  const script = hasProjectBmadManifest()
+    ? resolveScript('.claude/hooks-windows/bmad-speak.ps1')
+    : resolveScript('.claude/hooks-windows/play-tts.ps1');
   if (!script) process.exit(0);
-  result = spawnSync(
-    'powershell',
-    ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, agentName, dialogue],
-    { stdio: 'inherit' }
-  );
+  const args = hasProjectBmadManifest()
+    ? ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, agentName, dialogue]
+    : ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, dialogue];
+  result = spawnSync('powershell', args, { stdio: 'inherit' });
 } else {
-  const script = resolveScript('.claude/hooks/bmad-speak.sh');
+  const script = hasProjectBmadManifest()
+    ? resolveScript('.claude/hooks/bmad-speak.sh')
+    : resolveScript('.claude/hooks/play-tts.sh');
   if (!script) process.exit(0);
-  result = spawnSync('bash', [script, agentName, dialogue], { stdio: 'inherit' });
+  const args = hasProjectBmadManifest() ? [script, agentName, dialogue] : [script, dialogue];
+  result = spawnSync('bash', args, { stdio: 'inherit' });
 }
 
 process.exit(result.status ?? 0);