agentvibes 2.0.20 → 2.0.22

package/docs/extra-voices-implementation-summary.md

@@ -0,0 +1,235 @@
+# Extra Piper Voices - Implementation Summary
+
+## Problem Statement
+
+Users encountered difficulties when trying to download and use extra custom Piper voices (jenny, kristin, 16Speakers):
+
+1. **Download Issue**: `tracy.onnx` file was incorrectly named (should be `16Speakers.onnx`)
+2. **Voice Registration Issue**: Custom voices couldn't be switched to because they didn't match the Piper voice pattern detection (`*_*-*`)
+3. **Multi-Speaker Support**: The 16Speakers model contains 16 individual voices that couldn't be accessed individually
+
+## Solution Implemented
+
+### 1. Fixed Download Script ✅
+
+**File**: `.claude/hooks/download-extra-voices.sh`
+
+**Changes**:
+- Already uses correct filename `16Speakers.onnx` (not `tracy.onnx`)
+- Downloads three custom voices:
+  - `kristin.onnx` (64MB) - US English female
+  - `jenny.onnx` (64MB) - UK English female with Irish accent
+  - `16Speakers.onnx` (77MB) - Multi-speaker with 12 US + 4 UK voices
+
+### 2. Enhanced Voice Manager ✅
+
+**File**: `.claude/hooks/voice-manager.sh`
+
+**Changes**:
+- **Before**: Only detected Piper voices matching pattern `*_*-*` (e.g., `en_US-lessac-medium`)
+- **After**: Scans voice directory for ALL `.onnx` files, including custom voices
+
+**New Logic**:
+```bash
+# For Piper provider:
+# 1. Check standard voice directory for .onnx files (jenny, kristin, 16Speakers)
+# 2. If not found, check multi-speaker registry (Cori_Samuel, Rose_Ibex, etc.)
+# 3. If multi-speaker found, store model + speaker ID separately
+```
+
+**Result**: Users can now switch to custom voices:
+- `/agent-vibes:switch jenny` ✅
+- `/agent-vibes:switch kristin` ✅
+- `/agent-vibes:switch 16Speakers` ✅
+
+### 3. Multi-Speaker Registry ✅
+
+**File**: `.claude/hooks/piper-multispeaker-registry.sh` (NEW)
+
+**Purpose**: Maps individual speaker names to model files and speaker IDs
+
+**Features**:
+- Registry of all 16 speakers in the 16Speakers model
+- Functions to lookup model and speaker ID by name
+- Function to list all multi-speaker voices with descriptions
+
+**Example Registry Entry**:
+```bash
+"Cori_Samuel:16Speakers:0:US English Female"
+"Rose_Ibex:16Speakers:8:US English Female"
+"Paul_Hampton:16Speakers:12:UK English Male"
+```
+
+**Usage**:
+```bash
+/agent-vibes:switch Cori_Samuel  # Uses 16Speakers.onnx with speaker ID 0
+/agent-vibes:switch Rose_Ibex    # Uses 16Speakers.onnx with speaker ID 8
+```
+
+### 4. Multi-Speaker TTS Support ✅
+
+**File**: `.claude/hooks/play-tts-piper.sh`
+
+**Changes**:
+
+**Voice Resolution**:
+```bash
+# Check for multi-speaker voice configuration
+if [[ -f "tts-piper-model.txt" ]] && [[ -f "tts-piper-speaker-id.txt" ]]; then
+  VOICE_MODEL=$(cat tts-piper-model.txt)      # e.g., "16Speakers"
+  SPEAKER_ID=$(cat tts-piper-speaker-id.txt)  # e.g., "8"
+fi
+```
+
+**TTS Synthesis**:
+```bash
+if [[ -n "$SPEAKER_ID" ]]; then
+  # Multi-speaker: Pass speaker ID to Piper
+  echo "$TEXT" | piper --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --output_file "$OUTPUT"
+else
+  # Single-speaker: Standard synthesis
+  echo "$TEXT" | piper --model "$VOICE_PATH" --output_file "$OUTPUT"
+fi
+```
+
+## File Changes Summary
+
+| File | Status | Changes |
+|------|--------|---------|
+| `download-extra-voices.sh` | ✅ Already Correct | Uses `16Speakers.onnx` (not tracy) |
+| `voice-manager.sh` | ✅ Updated | Added Piper voice directory scanning, multi-speaker support |
+| `piper-multispeaker-registry.sh` | ✅ Created | New registry for 16 speaker mappings |
+| `play-tts-piper.sh` | ✅ Updated | Added multi-speaker voice resolution and speaker ID support |
+| `docs/voice-registration-fix.md` | ✅ Created | Detailed problem analysis and solution design |
+| `docs/extra-voices-implementation-summary.md` | ✅ Created | This file |
+
+## Available Voices After Implementation
+
+### Standard Custom Voices
+- `jenny` - UK English female with Irish accent (CC BY)
+- `kristin` - US English female (Public Domain)
+- `16Speakers` - Access all 16 speakers at once (uses first speaker by default)
+
+### Individual Multi-Speaker Voices (16Speakers Model)
+
+**US English Speakers (12)**:
+- `Cori_Samuel` (Female, ID: 0)
+- `Kara_Shallenberg` (Female, ID: 1)
+- `Kristin_Hughes` (Female, ID: 2)
+- `Maria_Kasper` (Female, ID: 3)
+- `Mike_Pelton` (Male, ID: 4)
+- `Mark_Nelson` (Male, ID: 5)
+- `Michael_Scherer` (Male, ID: 6)
+- `James_K_White` (Male, ID: 7)
+- `Rose_Ibex` (Female, ID: 8)
+- `progressingamerica` (Male, ID: 9)
+- `Steve_C` (Male, ID: 10)
+- `Owlivia` (Female, ID: 11)
+
+**UK English Speakers (4)**:
+- `Paul_Hampton` (Male, ID: 12)
+- `Jennifer_Dorr` (Female, ID: 13)
+- `Emily_Cripps` (Female, ID: 14)
+- `Martin_Clifton` (Male, ID: 15)
+
+## Usage Examples
+
+### Download Extra Voices
+```bash
+# Via MCP
+mcp__agentvibes__download_extra_voices()
+
+# Via slash command (when implemented)
+/agent-vibes:provider download
+```
+
+### Switch to Custom Voice
+```bash
+# UK English female with Irish accent
+/agent-vibes:switch jenny
+
+# US English female
+/agent-vibes:switch kristin
+```
+
+### Switch to Multi-Speaker Voice
+```bash
+# Use a specific speaker from 16Speakers model
+/agent-vibes:switch Cori_Samuel    # US Female speaker
+/agent-vibes:switch Rose_Ibex      # US Female speaker
+/agent-vibes:switch Paul_Hampton   # UK Male speaker
+```
+
+### List Available Voices
+```bash
+/agent-vibes:list
+```
+
+Output will show:
+- Standard Piper voices (en_US-lessac-medium, etc.)
+- Custom voices (jenny, kristin, 16Speakers)
+- Multi-speaker voices (Cori_Samuel, Rose_Ibex, etc.)
+
+## Technical Details
+
+### State Files for Multi-Speaker Voices
+
+When you switch to a multi-speaker voice, three files are created:
+
+1. `.claude/tts-voice.txt` - Stores speaker name (e.g., "Cori_Samuel")
+2. `.claude/tts-piper-model.txt` - Stores model file (e.g., "16Speakers")
+3. `.claude/tts-piper-speaker-id.txt` - Stores speaker ID (e.g., "0")
+
+### Voice Lookup Priority (Piper Provider)
+
+1. **Standard voice files**: Check voice directory for `<name>.onnx`
+2. **Multi-speaker registry**: Check registry for speaker name
+3. **Error**: Show available voices if not found
+
+### Piper TTS Command Format
+
+**Single-speaker voice**:
+```bash
+piper --model /path/to/jenny.onnx --output_file output.wav
+```
+
+**Multi-speaker voice**:
+```bash
+piper --model /path/to/16Speakers.onnx --speaker 8 --output_file output.wav
+```
+
+## Testing Checklist
+
+- [x] Download script uses correct filename (16Speakers.onnx)
+- [x] Voice manager scans directory for custom voices
+- [x] Multi-speaker registry created with all 16 speakers
+- [x] Voice manager checks multi-speaker registry
+- [x] play-tts-piper.sh reads speaker ID from config
+- [x] play-tts-piper.sh passes --speaker flag to Piper
+- [ ] Test: Download extra voices via MCP
+- [ ] Test: Switch to jenny voice
+- [ ] Test: Switch to kristin voice
+- [ ] Test: Switch to Cori_Samuel (multi-speaker)
+- [ ] Test: Play TTS with each voice
+- [ ] Test: List voices shows all custom + multi-speaker
+
+## Next Steps
+
+1. **Test the implementation** with actual voice downloads and switching
+2. **Update voice listing** to show custom and multi-speaker voices in organized sections
+3. **Add MCP methods** for listing multi-speaker voices
+4. **Create user documentation** with voice preview samples
+
+## Benefits
+
+✅ **Users can now**:
+- Download high-quality custom voices with one command
+- Switch to custom voices (jenny, kristin) just like standard voices
+- Access individual speakers from multi-speaker models
+- Choose from 19 total custom voices (3 models + 16 individual speakers)
+
+✅ **System improvements**:
+- Consistent voice switching experience across all voice types
+- Automatic multi-speaker detection and configuration
+- Clear error messages with available voice listings
+- Support for future multi-speaker models

package/docs/voice-registration-fix.md

@@ -0,0 +1,254 @@
+# Voice Registration Fix - Extra Piper Voices
+
+## Problems Identified
+
+### 1. **Download Issues**
+- The `tracy.onnx` download only got 15 bytes (redirect/error page)
+- **Root Cause**: The HuggingFace file is actually named `16Speakers.onnx`, not `tracy.onnx`
+- **Fix**: Updated download script to use correct filename `16Speakers.onnx`
+
+### 2. **Voice Registration Issues**
+When users download custom Piper voices (jenny, kristin, 16Speakers), they cannot switch to them because:
+
+**Problem**: The voice-manager.sh uses two different lookup methods:
+1. **ElevenLabs voices**: Uses `voices-config.sh` associative array
+2. **Piper voices**: Scans `.onnx` files in the voice storage directory
+
+**Current voice-manager.sh logic (line 265-269)**:
+```bash
+# If using Piper and voice name looks like a Piper model (contains underscore and dash)
+# then skip ElevenLabs voice validation
+if [[ "$ACTIVE_PROVIDER" == "piper" ]] && [[ "$VOICE_NAME" == *"_"*"-"* ]]; then
+  # This is a Piper model name, use it directly
+  FOUND="$VOICE_NAME"
+```
+
+**Issue**: Custom voice names like `jenny`, `kristin`, and `16Speakers` DON'T contain underscore and dash, so they fail the Piper detection and fall through to ElevenLabs lookup, which fails.
+
+**Why it fails**:
+- `jenny` → No underscore/dash → Falls to ElevenLabs lookup → Not found → Error
+- `kristin` → No underscore/dash → Falls to ElevenLabs lookup → Not found → Error
+- `16Speakers` → No underscore/dash → Falls to ElevenLabs lookup → Not found → Error
+
+**Why standard Piper voices work**:
+- `en_US-lessac-medium` → Contains `_` and `-` → Passes Piper check → Works!
+- `en_GB-alan-medium` → Contains `_` and `-` → Passes Piper check → Works!
+
+### 3. **Multi-Speaker Voice Support (16Speakers)**
+
+The `16Speakers.onnx` is a special multi-speaker model containing 16 different voices:
+
+```json
+{
+  "speaker_id_map": {
+    "Cori_Samuel": 0,
+    "Kara_Shallenberg": 1,
+    "Kristin_Hughes": 2,
+    "Maria_Kasper": 3,
+    "Mike_Pelton": 4,
+    "Mark_Nelson": 5,
+    "Michael_Scherer": 6,
+    "James_K_White": 7,
+    "Rose_Ibex": 8,
+    "progressingamerica": 9,
+    "Steve_C": 10,
+    "Owlivia": 11,
+    "Paul_Hampton": 12,
+    "Jennifer_Dorr": 13,
+    "Emily_Cripps": 14,
+    "Martin_Clifton": 15
+  }
+}
+```
+
+**Usage**: Users should be able to say:
+- `/agent-vibes:switch Cori_Samuel` → Uses `16Speakers.onnx` with speaker ID 0
+- `/agent-vibes:switch Rose_Ibex` → Uses `16Speakers.onnx` with speaker ID 8
+
+**Problem**: Currently no system to:
+1. Parse multi-speaker voice names
+2. Pass speaker ID to Piper TTS
+3. Register individual speaker names from multi-speaker models
+
+## Solution Design
+
+### Phase 1: Fix Basic Custom Voice Registration
+
+**Approach**: Enhance `voice-manager.sh` to check for custom Piper voices by scanning the voice directory.
+
+**Modified logic**:
+```bash
+# 1. Check if it's a number (for ElevenLabs numbered selection)
+if [[ "$VOICE_NAME" =~ ^[0-9]+$ ]]; then
+  # ... existing numbered selection code ...
+
+# 2. NEW: Check if it's a Piper voice (scan voice directory)
+elif [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+  source "$SCRIPT_DIR/piper-voice-manager.sh"
+  VOICE_DIR=$(get_voice_storage_dir)
+
+  # Check if voice file exists (case-insensitive)
+  FOUND=""
+  for onnx_file in "$VOICE_DIR"/*.onnx; do
+    if [[ -f "$onnx_file" ]]; then
+      voice=$(basename "$onnx_file" .onnx)
+      if [[ "${voice,,}" == "${VOICE_NAME,,}" ]]; then
+        FOUND="$voice"
+        break
+      fi
+    fi
+  done
+
+  if [[ -z "$FOUND" ]]; then
+    echo "❌ Piper voice not found: $VOICE_NAME"
+    echo ""
+    echo "Available Piper voices:"
+    for onnx_file in "$VOICE_DIR"/*.onnx; do
+      [[ -f "$onnx_file" ]] && echo "  - $(basename "$onnx_file" .onnx)"
+    done | sort
+    exit 1
+  fi
+
+# 3. Fall back to ElevenLabs lookup
+else
+  # ... existing ElevenLabs lookup code ...
+fi
+```
+
+### Phase 2: Multi-Speaker Support
+
+**1. Create Multi-Speaker Registry**
+
+New file: `.claude/hooks/piper-multispeaker-registry.sh`
+
+```bash
+# Registry of multi-speaker models and their speaker names
+# Format: "SpeakerName:model_file:speaker_id"
+MULTISPEAKER_VOICES=(
+  "Cori_Samuel:16Speakers:0"
+  "Kara_Shallenberg:16Speakers:1"
+  "Kristin_Hughes:16Speakers:2"
+  "Maria_Kasper:16Speakers:3"
+  "Mike_Pelton:16Speakers:4"
+  "Mark_Nelson:16Speakers:5"
+  "Michael_Scherer:16Speakers:6"
+  "James_K_White:16Speakers:7"
+  "Rose_Ibex:16Speakers:8"
+  "progressingamerica:16Speakers:9"
+  "Steve_C:16Speakers:10"
+  "Owlivia:16Speakers:11"
+  "Paul_Hampton:16Speakers:12"
+  "Jennifer_Dorr:16Speakers:13"
+  "Emily_Cripps:16Speakers:14"
+  "Martin_Clifton:16Speakers:15"
+)
+
+# Get model and speaker ID for a speaker name
+get_multispeaker_info() {
+  local speaker_name="$1"
+  for entry in "${MULTISPEAKER_VOICES[@]}"; do
+    name="${entry%%:*}"
+    rest="${entry#*:}"
+    model="${rest%%:*}"
+    speaker_id="${rest#*:}"
+
+    if [[ "${name,,}" == "${speaker_name,,}" ]]; then
+      echo "$model:$speaker_id"
+      return 0
+    fi
+  done
+  return 1
+}
+```
+
+**2. Update voice-manager.sh**
+
+```bash
+# After checking standard Piper voices, check multi-speaker registry
+if [[ -z "$FOUND" ]] && [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+  source "$SCRIPT_DIR/piper-multispeaker-registry.sh"
+
+  MULTISPEAKER_INFO=$(get_multispeaker_info "$VOICE_NAME")
+  if [[ -n "$MULTISPEAKER_INFO" ]]; then
+    MODEL="${MULTISPEAKER_INFO%%:*}"
+    SPEAKER_ID="${MULTISPEAKER_INFO#*:}"
+
+    # Store as "SpeakerName" in tts-voice.txt
+    # Store model and speaker ID separately for play-tts-piper.sh to use
+    echo "$VOICE_NAME" > "$VOICE_FILE"
+    echo "$MODEL" > "$CLAUDE_DIR/tts-piper-model.txt"
+    echo "$SPEAKER_ID" > "$CLAUDE_DIR/tts-piper-speaker-id.txt"
+
+    echo "✅ Multi-speaker voice switched to: $VOICE_NAME"
+    echo "🎤 Model: $MODEL (Speaker ID: $SPEAKER_ID)"
+    exit 0
+  fi
+fi
+```
+
+**3. Update play-tts-piper.sh**
+
+```bash
+# Check if this is a multi-speaker voice
+SPEAKER_ID_FILE="$CLAUDE_DIR/tts-piper-speaker-id.txt"
+MODEL_FILE="$CLAUDE_DIR/tts-piper-model.txt"
+
+if [[ -f "$SPEAKER_ID_FILE" ]] && [[ -f "$MODEL_FILE" ]]; then
+  # Use multi-speaker model
+  PIPER_MODEL=$(cat "$MODEL_FILE")
+  SPEAKER_ID=$(cat "$SPEAKER_ID_FILE")
+
+  # Get model path
+  VOICE_PATH=$(get_voice_path "$PIPER_MODEL")
+
+  # Pass speaker ID to Piper
+  echo "$TEXT" | piper \
+    --model "$VOICE_PATH" \
+    --speaker "$SPEAKER_ID" \
+    --output_file "$OUTPUT_FILE" 2>&1
+else
+  # Standard single-speaker voice
+  # ... existing code ...
+fi
+```
+
+## Implementation Plan
+
+### Step 1: Fix download script filename ✅
+- [x] Change `tracy.onnx` to `16Speakers.onnx` in download-extra-voices.sh
+
+### Step 2: Fix basic custom voice switching
+- [ ] Update `voice-manager.sh` switch logic to scan voice directory for Piper voices
+- [ ] Test switching to `jenny`, `kristin`, `16Speakers`
+
+### Step 3: Implement multi-speaker support
+- [ ] Create `piper-multispeaker-registry.sh`
+- [ ] Update `voice-manager.sh` to handle multi-speaker lookups
+- [ ] Update `play-tts-piper.sh` to pass speaker ID to Piper
+- [ ] Test switching to individual speakers (e.g., `Cori_Samuel`, `Rose_Ibex`)
+
+### Step 4: Update voice listing
+- [ ] Make `/agent-vibes:list` show all custom voices (jenny, kristin, 16 speaker names)
+- [ ] Organize output: "Standard Voices", "Custom Voices", "Multi-Speaker Voices"
+
+### Step 5: MCP Integration
+- [ ] Update MCP server to expose multi-speaker voice info
+- [ ] Add `list_multispeaker_voices()` method to show available speakers
+
+## Testing Checklist
+
+- [ ] Download extra voices: `mcp__agentvibes__download_extra_voices()`
+- [ ] Switch to jenny: `/agent-vibes:switch jenny`
+- [ ] Switch to kristin: `/agent-vibes:switch kristin`
+- [ ] Switch to 16Speakers: `/agent-vibes:switch 16Speakers`
+- [ ] Switch to Cori_Samuel: `/agent-vibes:switch Cori_Samuel`
+- [ ] Switch to Rose_Ibex: `/agent-vibes:switch Rose_Ibex`
+- [ ] List all voices: `/agent-vibes:list` (should show all custom + multi-speaker)
+- [ ] Play TTS with each voice to verify audio works
+
+## Future Enhancements
+
+1. **Auto-registration**: When downloading 16Speakers, auto-register all 16 speaker names
+2. **Voice preview**: Add preview support for multi-speaker voices
+3. **Voice metadata**: Store speaker descriptions (gender, accent, etc.) in registry
+4. **Dynamic discovery**: Auto-scan .onnx.json files for speaker_id_map and register dynamically

package/fix-vscode-colors.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+#
+# Fix VS Code Workspace Colors
+# Sets the status bar and activity bar to purple for this workspace
+#
+
+set -e
+
+WORKSPACE_FILE=".vscode/settings.json"
+
+echo "🎨 Fixing VS Code workspace colors to purple..."
+
+# Create .vscode directory if it doesn't exist
+mkdir -p .vscode
+
+# Check if settings.json exists
+if [[ ! -f "$WORKSPACE_FILE" ]]; then
+    echo "Creating new workspace settings file..."
+    cat > "$WORKSPACE_FILE" <<'EOF'
+{
+    "workbench.colorCustomizations": {
+        "statusBar.background": "#7b2cbf",
+        "statusBar.foreground": "#ffffff",
+        "statusBarItem.hoverBackground": "#9d4edd",
+        "activityBar.background": "#7b2cbf",
+        "activityBar.foreground": "#ffffff",
+        "activityBar.inactiveForeground": "#c9c9c9",
+        "titleBar.activeBackground": "#7b2cbf",
+        "titleBar.activeForeground": "#ffffff",
+        "titleBar.inactiveBackground": "#6a24a8",
+        "titleBar.inactiveForeground": "#c9c9c9"
+    }
+}
+EOF
+else
+    echo "Updating existing workspace settings file..."
+
+    # Use jq if available, otherwise use simple append
+    if command -v jq &> /dev/null; then
+        # Backup original
+        cp "$WORKSPACE_FILE" "${WORKSPACE_FILE}.backup"
+
+        # Merge with jq
+        jq '. + {
+            "workbench.colorCustomizations": {
+                "statusBar.background": "#7b2cbf",
+                "statusBar.foreground": "#ffffff",
+                "statusBarItem.hoverBackground": "#9d4edd",
+                "activityBar.background": "#7b2cbf",
+                "activityBar.foreground": "#ffffff",
+                "activityBar.inactiveForeground": "#c9c9c9",
+                "titleBar.activeBackground": "#7b2cbf",
+                "titleBar.activeForeground": "#ffffff",
+                "titleBar.inactiveBackground": "#6a24a8",
+                "titleBar.inactiveForeground": "#c9c9c9"
+            }
+        }' "${WORKSPACE_FILE}.backup" > "$WORKSPACE_FILE"
+
+        rm "${WORKSPACE_FILE}.backup"
+        echo "✅ Updated using jq"
+    else
+        echo "⚠️  jq not found - manual update required"
+        echo "Please add the following to $WORKSPACE_FILE:"
+        echo ""
+        cat <<'EOF'
+{
+    "workbench.colorCustomizations": {
+        "statusBar.background": "#7b2cbf",
+        "statusBar.foreground": "#ffffff",
+        "statusBarItem.hoverBackground": "#9d4edd",
+        "activityBar.background": "#7b2cbf",
+        "activityBar.foreground": "#ffffff",
+        "activityBar.inactiveForeground": "#c9c9c9",
+        "titleBar.activeBackground": "#7b2cbf",
+        "titleBar.activeForeground": "#ffffff",
+        "titleBar.inactiveBackground": "#6a24a8",
+        "titleBar.inactiveForeground": "#c9c9c9"
+    }
+}
+EOF
+    fi
+fi
+
+echo ""
+echo "✅ Workspace colors set to purple!"
+echo "📁 Settings file: $WORKSPACE_FILE"
+echo ""
+echo "Restart VS Code or reload the window for changes to take effect."

package/fixcolors

@@ -0,0 +1,88 @@
+#!/bin/bash
+#
+# fixcolors - Apply vibrant purple color scheme to AgentVibes VS Code workspace
+# Usage: ./fixcolors
+
+set -e
+
+PURPLE_ACTIVE="#7b2cbf"
+PURPLE_INACTIVE="#5a189a"
+PURPLE_DEBUG="#9d4edd"
+WHITE="#ffffff"
+LIGHT_GRAY="#e0e0e0"
+
+echo "🎨 Applying vibrant purple color scheme to AgentVibes workspace..."
+echo ""
+
+# Function to update JSON files with purple colors
+update_colors() {
+  local file="$1"
+  local temp_file="${file}.tmp"
+
+  if [[ ! -f "$file" ]]; then
+    echo "⚠️  File not found: $file"
+    return 1
+  fi
+
+  echo "📝 Updating: $file"
+
+  # Use Python to safely update JSON
+  python3 << EOF
+import json
+import sys
+
+try:
+    with open('$file', 'r') as f:
+        data = json.load(f)
+
+    # Ensure settings exists
+    if 'settings' in data:
+        settings = data['settings']
+    else:
+        settings = data
+
+    # Ensure workbench.colorCustomizations exists
+    if 'workbench.colorCustomizations' not in settings:
+        settings['workbench.colorCustomizations'] = {}
+
+    colors = settings['workbench.colorCustomizations']
+
+    # Apply purple theme
+    colors['titleBar.activeBackground'] = '$PURPLE_ACTIVE'
+    colors['titleBar.activeForeground'] = '$WHITE'
+    colors['titleBar.inactiveBackground'] = '$PURPLE_INACTIVE'
+    colors['titleBar.inactiveForeground'] = '$LIGHT_GRAY'
+    colors['statusBar.background'] = '$PURPLE_ACTIVE'
+    colors['statusBar.foreground'] = '$WHITE'
+    colors['statusBar.noFolderBackground'] = '$PURPLE_INACTIVE'
+    colors['statusBar.debuggingBackground'] = '$PURPLE_DEBUG'
+
+    # Write back
+    with open('$temp_file', 'w') as f:
+        json.dump(data, f, indent=2)
+
+    print("   ✓ Colors updated")
+
+except Exception as e:
+    print(f"   ✗ Error: {e}", file=sys.stderr)
+    sys.exit(1)
+EOF
+
+  if [[ $? -eq 0 ]]; then
+    mv "$temp_file" "$file"
+    echo "   ✓ File saved"
+  else
+    rm -f "$temp_file"
+    echo "   ✗ Failed to update"
+    return 1
+  fi
+}
+
+# Update AgentVibes workspace
+echo "🔧 AgentVibes workspace:"
+update_colors "/home/fire/claude/AgentVibes/AgentVibes.code-workspace"
+echo ""
+
+echo "✅ All done! Reload VS Code window to see the purple theme."
+echo ""
+echo "💡 To reload: Press Ctrl+Shift+P → 'Developer: Reload Window'"