agentvibes 4.2.0 → 4.4.0

package/.claude/hooks/learn-manager.sh

@@ -1,492 +1,492 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/learn-manager.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied. Use at your own risk. See the Apache License for details.
-#
-# ---
-#
-# @fileoverview Language Learning Mode Manager - Enables dual-language TTS for immersive learning
-# @context Speaks responses in both main language (English) and target language (Spanish, French, etc.) for language practice
-# @architecture Manages main/target language pairs with voice mappings, auto-configures recommended voices per language
-# @dependencies play-tts.sh (dual invocation), language-manager.sh (voice recommendations), .claude/tts-*.txt state files
-# @entrypoints Called by /agent-vibes:learn commands to enable/disable learning mode
-# @patterns Dual-voice orchestration, auto-configuration, greeting on activation, provider-aware voice selection
-# @related language-manager.sh, play-tts.sh, .claude/tts-learn-mode.txt, .claude/tts-target-language.txt
-
-# Only set strict mode when executed directly, not when sourced
-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
-    set -e
-fi
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Bash 3.2 compatible lowercase function (macOS ships with bash 3.2)
-# ${var,,} syntax requires bash 4.0+
-_to_lower() {
-  echo "$1" | tr '[:upper:]' '[:lower:]'
-}
-
-# Use PWD for project dir when called from project context, fall back to script-relative
-if [[ -d "$PWD/.claude" ]]; then
-    PROJECT_DIR="$PWD"
-else
-    PROJECT_DIR="$SCRIPT_DIR/../.."
-fi
-
-# Configuration files (project-local first, then global fallback)
-MAIN_LANG_FILE="$PROJECT_DIR/.claude/tts-main-language.txt"
-TARGET_LANG_FILE="$PROJECT_DIR/.claude/tts-target-language.txt"
-TARGET_VOICE_FILE="$PROJECT_DIR/.claude/tts-target-voice.txt"
-LEARN_MODE_FILE="$PROJECT_DIR/.claude/tts-learn-mode.txt"
-
-GLOBAL_MAIN_LANG_FILE="$HOME/.claude/tts-main-language.txt"
-GLOBAL_TARGET_LANG_FILE="$HOME/.claude/tts-target-language.txt"
-GLOBAL_TARGET_VOICE_FILE="$HOME/.claude/tts-target-voice.txt"
-GLOBAL_LEARN_MODE_FILE="$HOME/.claude/tts-learn-mode.txt"
-
-# Colors
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-# Get main language
-get_main_language() {
-    if [[ -f "$MAIN_LANG_FILE" ]]; then
-        cat "$MAIN_LANG_FILE"
-    elif [[ -f "$GLOBAL_MAIN_LANG_FILE" ]]; then
-        cat "$GLOBAL_MAIN_LANG_FILE"
-    else
-        echo "english"
-    fi
-}
-
-# Set main language
-set_main_language() {
-    local language="$1"
-    if [[ -z "$language" ]]; then
-        echo -e "${YELLOW}Usage: learn-manager.sh set-main-language <language>${NC}"
-        exit 1
-    fi
-
-    mkdir -p "$PROJECT_DIR/.claude"
-    echo "$language" > "$MAIN_LANG_FILE"
-    echo -e "${GREEN}✓${NC} Main language set to: $language"
-}
-
-# Get target language
-get_target_language() {
-    if [[ -f "$TARGET_LANG_FILE" ]]; then
-        cat "$TARGET_LANG_FILE"
-    elif [[ -f "$GLOBAL_TARGET_LANG_FILE" ]]; then
-        cat "$GLOBAL_TARGET_LANG_FILE"
-    else
-        echo ""
-    fi
-}
-
-# Get greeting message for a language
-get_greeting_for_language() {
-    local language="$1"
-
-    case "$(_to_lower "$language")" in
-        spanish|español)
-            echo "¡Hola! Soy tu profesor de español. ¡Vamos a aprender juntos!"
-            ;;
-        french|français)
-            echo "Bonjour! Je suis votre professeur de français. Apprenons ensemble!"
-            ;;
-        german|deutsch)
-            echo "Hallo! Ich bin dein Deutschlehrer. Lass uns zusammen lernen!"
-            ;;
-        italian|italiano)
-            echo "Ciao! Sono il tuo insegnante di italiano. Impariamo insieme!"
-            ;;
-        portuguese|português)
-            echo "Olá! Sou seu professor de português. Vamos aprender juntos!"
-            ;;
-        chinese|中文|mandarin)
-            echo "你好！我是你的中文老师。让我们一起学习吧！"
-            ;;
-        japanese|日本語)
-            echo "こんにちは！私はあなたの日本語の先生です。一緒に勉強しましょう！"
-            ;;
-        korean|한국어)
-            echo "안녕하세요! 저는 당신의 한국어 선생님입니다. 함께 배워봅시다!"
-            ;;
-        russian|русский)
-            echo "Здравствуйте! Я ваш учитель русского языка. Давайте учиться вместе!"
-            ;;
-        arabic|العربية)
-            echo "مرحبا! أنا معلمك للغة العربية. دعونا نتعلم معا!"
-            ;;
-        hindi|हिन्दी)
-            echo "नमस्ते! मैं आपका हिंदी शिक्षक हूं। आइए साथ में सीखें!"
-            ;;
-        dutch|nederlands)
-            echo "Hallo! Ik ben je Nederlandse leraar. Laten we samen leren!"
-            ;;
-        polish|polski)
-            echo "Cześć! Jestem twoim nauczycielem polskiego. Uczmy się razem!"
-            ;;
-        turkish|türkçe)
-            echo "Merhaba! Ben Türkçe öğretmeninizim. Birlikte öğrenelim!"
-            ;;
-        swedish|svenska)
-            echo "Hej! Jag är din svenskalärare. Låt oss lära tillsammans!"
-            ;;
-        *)
-            echo "Hello! I am your language teacher. Let's learn together!"
-            ;;
-    esac
-}
-
-# Set target language
-set_target_language() {
-    local language="$1"
-    if [[ -z "$language" ]]; then
-        echo -e "${YELLOW}Usage: learn-manager.sh set-target-language <language>${NC}"
-        exit 1
-    fi
-
-    mkdir -p "$PROJECT_DIR/.claude"
-    echo "$language" > "$TARGET_LANG_FILE"
-    echo -e "${GREEN}✓${NC} Target language set to: $language"
-
-    # Automatically set the recommended voice for this language
-    local recommended_voice=$(get_recommended_voice_for_language "$language")
-    if [[ -n "$recommended_voice" ]]; then
-        echo "$recommended_voice" > "$TARGET_VOICE_FILE"
-        echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
-
-        # Detect provider for display
-        local provider=""
-        if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
-            provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
-        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-            provider=$(cat "$HOME/.claude/tts-provider.txt")
-        else
-            provider="piper"
-        fi
-        echo -e "   (for ${GREEN}$provider${NC} TTS)"
-        echo ""
-
-        # Greet user in the target language with the target voice
-        local greeting=$(get_greeting_for_language "$language")
-        echo -e "${BLUE}🎓${NC} Your language teacher says:"
-
-        # Check if we're using Piper and if the voice is available
-        if [[ "$provider" == "piper" ]]; then
-            # Quick check: does the voice file exist?
-            local voice_dir="${HOME}/.claude/piper-voices"
-            if [[ -f "${voice_dir}/${recommended_voice}.onnx" ]]; then
-                # Voice exists, play greeting in background
-                nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
-            else
-                echo -e "${YELLOW}   (Voice not yet downloaded - greeting will play after first download)${NC}"
-            fi
-        else
-            # macOS or other provider - just play it in background
-            nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
-        fi
-    else
-        # Fallback to suggestion if auto-set failed
-        suggest_voice_for_language "$language"
-    fi
-}
-
-# Get recommended voice for a language (returns voice string, no output)
-get_recommended_voice_for_language() {
-    local language="$1"
-    local recommended_voice=""
-    local provider=""
-
-    # Detect active provider
-    if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
-        provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
-    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-        provider=$(cat "$HOME/.claude/tts-provider.txt")
-    else
-        provider="piper"  # Default
-    fi
-
-    # Source language manager and get provider-specific voice
-    if [[ -f "$SCRIPT_DIR/language-manager.sh" ]]; then
-        source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null
-        recommended_voice=$(get_voice_for_language "$language" "$provider" 2>/dev/null)
-    fi
-
-    # Fallback to hardcoded suggestions if function failed
-    if [[ -z "$recommended_voice" ]]; then
-        case "$(_to_lower "$language")" in
-            spanish|español)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "es_ES-davefx-medium" || echo "Antoni")
-                ;;
-            french|français)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "fr_FR-siwis-medium" || echo "Rachel")
-                ;;
-            german|deutsch)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "de_DE-thorsten-medium" || echo "Domi")
-                ;;
-            italian|italiano)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "it_IT-riccardo-x_low" || echo "Bella")
-                ;;
-            portuguese|português)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "pt_BR-faber-medium" || echo "Matilda")
-                ;;
-            chinese|中文|mandarin)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "zh_CN-huayan-medium" || echo "Amy")
-                ;;
-            *)
-                recommended_voice=$([ "$provider" = "piper" ] && echo "en_US-lessac-medium" || echo "Antoni")
-                ;;
-        esac
-    fi
-
-    echo "$recommended_voice"
-}
-
-# Suggest voice based on target language (displays suggestion message)
-suggest_voice_for_language() {
-    local language="$1"
-    local suggested_voice=$(get_recommended_voice_for_language "$language")
-
-    # Detect provider for display
-    local provider=""
-    if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
-        provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
-    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-        provider=$(cat "$HOME/.claude/tts-provider.txt")
-    else
-        provider="piper"
-    fi
-
-    echo ""
-    echo -e "${BLUE}💡 Tip:${NC} For $language (using ${GREEN}$provider${NC} TTS), we recommend: ${YELLOW}$suggested_voice${NC}"
-    echo -e "   Set it with: ${YELLOW}/agent-vibes:target-voice $suggested_voice${NC}"
-}
-
-# Get target voice
-get_target_voice() {
-    if [[ -f "$TARGET_VOICE_FILE" ]]; then
-        cat "$TARGET_VOICE_FILE"
-    elif [[ -f "$GLOBAL_TARGET_VOICE_FILE" ]]; then
-        cat "$GLOBAL_TARGET_VOICE_FILE"
-    else
-        echo ""
-    fi
-}
-
-# Set target voice
-set_target_voice() {
-    local voice="$1"
-    if [[ -z "$voice" ]]; then
-        echo -e "${YELLOW}Usage: learn-manager.sh set-target-voice <voice>${NC}"
-        exit 1
-    fi
-
-    mkdir -p "$PROJECT_DIR/.claude"
-    echo "$voice" > "$TARGET_VOICE_FILE"
-    echo -e "${GREEN}✓${NC} Target voice set to: $voice"
-}
-
-# Check if learning mode is enabled
-is_learn_mode_enabled() {
-    if [[ -f "$LEARN_MODE_FILE" ]]; then
-        local mode=$(cat "$LEARN_MODE_FILE")
-        [[ "$mode" == "ON" ]]
-    elif [[ -f "$GLOBAL_LEARN_MODE_FILE" ]]; then
-        local mode=$(cat "$GLOBAL_LEARN_MODE_FILE")
-        [[ "$mode" == "ON" ]]
-    else
-        return 1
-    fi
-}
-
-# Enable learning mode
-enable_learn_mode() {
-    mkdir -p "$PROJECT_DIR/.claude"
-    echo "ON" > "$LEARN_MODE_FILE"
-    echo -e "${GREEN}✓${NC} Language learning mode: ${GREEN}ENABLED${NC}"
-    echo ""
-
-    # Auto-set target voice if target language is set but voice is not
-    local target_lang=$(get_target_language)
-    local target_voice=$(get_target_voice)
-    local voice_was_set=false
-
-    if [[ -n "$target_lang" ]] && [[ -z "$target_voice" ]]; then
-        echo -e "${BLUE}ℹ${NC}  Auto-configuring voice for $target_lang..."
-        local recommended_voice=$(get_recommended_voice_for_language "$target_lang")
-        if [[ -n "$recommended_voice" ]]; then
-            echo "$recommended_voice" > "$TARGET_VOICE_FILE"
-            target_voice="$recommended_voice"
-            echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
-
-            # Detect provider for display
-            local provider=""
-            if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
-                provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
-            elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-                provider=$(cat "$HOME/.claude/tts-provider.txt")
-            else
-                provider="piper"
-            fi
-            echo -e "   (for ${GREEN}$provider${NC} TTS)"
-            echo ""
-            voice_was_set=true
-        fi
-    fi
-
-    show_status
-
-    # Greet user with language teacher if everything is configured
-    if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
-        echo ""
-        local greeting=$(get_greeting_for_language "$target_lang")
-        echo -e "${BLUE}🎓${NC} Your language teacher says:"
-
-        # Detect provider
-        local provider=""
-        if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
-            provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
-        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
-            provider=$(cat "$HOME/.claude/tts-provider.txt")
-        else
-            provider="piper"
-        fi
-
-        # Check if we're using Piper and if the voice is available
-        if [[ "$provider" == "piper" ]]; then
-            # Quick check: does the voice file exist?
-            local voice_dir="${HOME}/.claude/piper-voices"
-            if [[ -f "${voice_dir}/${target_voice}.onnx" ]]; then
-                # Voice exists, play greeting in background
-                nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
-            else
-                echo -e "${YELLOW}   (Voice not yet downloaded - greeting will play after first download)${NC}"
-            fi
-        else
-            # macOS or other provider - just play it in background
-            nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
-        fi
-    fi
-}
-
-# Disable learning mode
-disable_learn_mode() {
-    mkdir -p "$PROJECT_DIR/.claude"
-    echo "OFF" > "$LEARN_MODE_FILE"
-    echo -e "${GREEN}✓${NC} Language learning mode: ${YELLOW}DISABLED${NC}"
-}
-
-# Show learning mode status
-show_status() {
-    local main_lang=$(get_main_language)
-    local target_lang=$(get_target_language)
-    local target_voice=$(get_target_voice)
-    local learn_mode="OFF"
-
-    if is_learn_mode_enabled; then
-        learn_mode="ON"
-    fi
-
-    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-    echo -e "${BLUE}   Language Learning Mode Status${NC}"
-    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-    echo ""
-    echo -e "  ${BLUE}Learning Mode:${NC}    $(if [[ "$learn_mode" == "ON" ]]; then echo -e "${GREEN}ENABLED${NC}"; else echo -e "${YELLOW}DISABLED${NC}"; fi)"
-    echo -e "  ${BLUE}Main Language:${NC}    $main_lang"
-    echo -e "  ${BLUE}Target Language:${NC}  ${target_lang:-"(not set)"}"
-    echo -e "  ${BLUE}Target Voice:${NC}     ${target_voice:-"(not set)"}"
-    echo ""
-
-    if [[ "$learn_mode" == "ON" ]]; then
-        if [[ -z "$target_lang" ]]; then
-            echo -e "  ${YELLOW}⚠${NC}  Please set a target language: ${YELLOW}/agent-vibes:target <language>${NC}"
-        fi
-        if [[ -z "$target_voice" ]]; then
-            echo -e "  ${YELLOW}⚠${NC}  Please set a target voice: ${YELLOW}/agent-vibes:target-voice <voice>${NC}"
-        fi
-
-        if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
-            echo -e "  ${GREEN}✓${NC}  All set! TTS will speak in both languages."
-            echo ""
-            echo -e "  ${BLUE}How it works:${NC}"
-            echo -e "    1. First: Speak in ${BLUE}$main_lang${NC} (your current voice)"
-            echo -e "    2. Then: Speak in ${BLUE}$target_lang${NC} ($target_voice voice)"
-        fi
-    else
-        echo -e "  ${BLUE}💡 Tip:${NC} Enable learning mode with: ${YELLOW}/agent-vibes:learn${NC}"
-    fi
-
-    echo ""
-    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
-}
-
-# Main command handler - only run if script is executed directly, not sourced
-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
-case "${1:-}" in
-    get-main-language)
-        get_main_language
-        ;;
-    set-main-language)
-        set_main_language "$2"
-        ;;
-    get-target-language)
-        get_target_language
-        ;;
-    set-target-language)
-        set_target_language "$2"
-        ;;
-    get-target-voice)
-        get_target_voice
-        ;;
-    set-target-voice)
-        set_target_voice "$2"
-        ;;
-    is-enabled)
-        if is_learn_mode_enabled; then
-            echo "ON"
-            exit 0
-        else
-            echo "OFF"
-            exit 1
-        fi
-        ;;
-    enable)
-        enable_learn_mode
-        ;;
-    disable)
-        disable_learn_mode
-        ;;
-    status)
-        show_status
-        ;;
-    *)
-        echo "Usage: learn-manager.sh {get-main-language|set-main-language|get-target-language|set-target-language|get-target-voice|set-target-voice|is-enabled|enable|disable|status}"
-        exit 1
-        ;;
-esac
-fi
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/learn-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied. Use at your own risk. See the Apache License for details.
+#
+# ---
+#
+# @fileoverview Language Learning Mode Manager - Enables dual-language TTS for immersive learning
+# @context Speaks responses in both main language (English) and target language (Spanish, French, etc.) for language practice
+# @architecture Manages main/target language pairs with voice mappings, auto-configures recommended voices per language
+# @dependencies play-tts.sh (dual invocation), language-manager.sh (voice recommendations), .claude/tts-*.txt state files
+# @entrypoints Called by /agent-vibes:learn commands to enable/disable learning mode
+# @patterns Dual-voice orchestration, auto-configuration, greeting on activation, provider-aware voice selection
+# @related language-manager.sh, play-tts.sh, .claude/tts-learn-mode.txt, .claude/tts-target-language.txt
+
+# Only set strict mode when executed directly, not when sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    set -e
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Bash 3.2 compatible lowercase function (macOS ships with bash 3.2)
+# ${var,,} syntax requires bash 4.0+
+_to_lower() {
+  echo "$1" | tr '[:upper:]' '[:lower:]'
+}
+
+# Use PWD for project dir when called from project context, fall back to script-relative
+if [[ -d "$PWD/.claude" ]]; then
+    PROJECT_DIR="$PWD"
+else
+    PROJECT_DIR="$SCRIPT_DIR/../.."
+fi
+
+# Configuration files (project-local first, then global fallback)
+MAIN_LANG_FILE="$PROJECT_DIR/.claude/tts-main-language.txt"
+TARGET_LANG_FILE="$PROJECT_DIR/.claude/tts-target-language.txt"
+TARGET_VOICE_FILE="$PROJECT_DIR/.claude/tts-target-voice.txt"
+LEARN_MODE_FILE="$PROJECT_DIR/.claude/tts-learn-mode.txt"
+
+GLOBAL_MAIN_LANG_FILE="$HOME/.claude/tts-main-language.txt"
+GLOBAL_TARGET_LANG_FILE="$HOME/.claude/tts-target-language.txt"
+GLOBAL_TARGET_VOICE_FILE="$HOME/.claude/tts-target-voice.txt"
+GLOBAL_LEARN_MODE_FILE="$HOME/.claude/tts-learn-mode.txt"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Get main language
+get_main_language() {
+    if [[ -f "$MAIN_LANG_FILE" ]]; then
+        cat "$MAIN_LANG_FILE"
+    elif [[ -f "$GLOBAL_MAIN_LANG_FILE" ]]; then
+        cat "$GLOBAL_MAIN_LANG_FILE"
+    else
+        echo "english"
+    fi
+}
+
+# Set main language
+set_main_language() {
+    local language="$1"
+    if [[ -z "$language" ]]; then
+        echo -e "${YELLOW}Usage: learn-manager.sh set-main-language <language>${NC}"
+        exit 1
+    fi
+
+    mkdir -p "$PROJECT_DIR/.claude"
+    echo "$language" > "$MAIN_LANG_FILE"
+    echo -e "${GREEN}✓${NC} Main language set to: $language"
+}
+
+# Get target language
+get_target_language() {
+    if [[ -f "$TARGET_LANG_FILE" ]]; then
+        cat "$TARGET_LANG_FILE"
+    elif [[ -f "$GLOBAL_TARGET_LANG_FILE" ]]; then
+        cat "$GLOBAL_TARGET_LANG_FILE"
+    else
+        echo ""
+    fi
+}
+
+# Get greeting message for a language
+get_greeting_for_language() {
+    local language="$1"
+
+    case "$(_to_lower "$language")" in
+        spanish|español)
+            echo "¡Hola! Soy tu profesor de español. ¡Vamos a aprender juntos!"
+            ;;
+        french|français)
+            echo "Bonjour! Je suis votre professeur de français. Apprenons ensemble!"
+            ;;
+        german|deutsch)
+            echo "Hallo! Ich bin dein Deutschlehrer. Lass uns zusammen lernen!"
+            ;;
+        italian|italiano)
+            echo "Ciao! Sono il tuo insegnante di italiano. Impariamo insieme!"
+            ;;
+        portuguese|português)
+            echo "Olá! Sou seu professor de português. Vamos aprender juntos!"
+            ;;
+        chinese|中文|mandarin)
+            echo "你好！我是你的中文老师。让我们一起学习吧！"
+            ;;
+        japanese|日本語)
+            echo "こんにちは！私はあなたの日本語の先生です。一緒に勉強しましょう！"
+            ;;
+        korean|한국어)
+            echo "안녕하세요! 저는 당신의 한국어 선생님입니다. 함께 배워봅시다!"
+            ;;
+        russian|русский)
+            echo "Здравствуйте! Я ваш учитель русского языка. Давайте учиться вместе!"
+            ;;
+        arabic|العربية)
+            echo "مرحبا! أنا معلمك للغة العربية. دعونا نتعلم معا!"
+            ;;
+        hindi|हिन्दी)
+            echo "नमस्ते! मैं आपका हिंदी शिक्षक हूं। आइए साथ में सीखें!"
+            ;;
+        dutch|nederlands)
+            echo "Hallo! Ik ben je Nederlandse leraar. Laten we samen leren!"
+            ;;
+        polish|polski)
+            echo "Cześć! Jestem twoim nauczycielem polskiego. Uczmy się razem!"
+            ;;
+        turkish|türkçe)
+            echo "Merhaba! Ben Türkçe öğretmeninizim. Birlikte öğrenelim!"
+            ;;
+        swedish|svenska)
+            echo "Hej! Jag är din svenskalärare. Låt oss lära tillsammans!"
+            ;;
+        *)
+            echo "Hello! I am your language teacher. Let's learn together!"
+            ;;
+    esac
+}
+
+# Set target language
+set_target_language() {
+    local language="$1"
+    if [[ -z "$language" ]]; then
+        echo -e "${YELLOW}Usage: learn-manager.sh set-target-language <language>${NC}"
+        exit 1
+    fi
+
+    mkdir -p "$PROJECT_DIR/.claude"
+    echo "$language" > "$TARGET_LANG_FILE"
+    echo -e "${GREEN}✓${NC} Target language set to: $language"
+
+    # Automatically set the recommended voice for this language
+    local recommended_voice=$(get_recommended_voice_for_language "$language")
+    if [[ -n "$recommended_voice" ]]; then
+        echo "$recommended_voice" > "$TARGET_VOICE_FILE"
+        echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
+
+        # Detect provider for display
+        local provider=""
+        if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
+            provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
+        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+            provider=$(cat "$HOME/.claude/tts-provider.txt")
+        else
+            provider="piper"
+        fi
+        echo -e "   (for ${GREEN}$provider${NC} TTS)"
+        echo ""
+
+        # Greet user in the target language with the target voice
+        local greeting=$(get_greeting_for_language "$language")
+        echo -e "${BLUE}🎓${NC} Your language teacher says:"
+
+        # Check if we're using Piper and if the voice is available
+        if [[ "$provider" == "piper" ]]; then
+            # Quick check: does the voice file exist?
+            local voice_dir="${HOME}/.claude/piper-voices"
+            if [[ -f "${voice_dir}/${recommended_voice}.onnx" ]]; then
+                # Voice exists, play greeting in background
+                nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
+            else
+                echo -e "${YELLOW}   (Voice not yet downloaded - greeting will play after first download)${NC}"
+            fi
+        else
+            # macOS or other provider - just play it in background
+            nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
+        fi
+    else
+        # Fallback to suggestion if auto-set failed
+        suggest_voice_for_language "$language"
+    fi
+}
+
+# Get recommended voice for a language (returns voice string, no output)
+get_recommended_voice_for_language() {
+    local language="$1"
+    local recommended_voice=""
+    local provider=""
+
+    # Detect active provider
+    if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
+        provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
+    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+        provider=$(cat "$HOME/.claude/tts-provider.txt")
+    else
+        provider="piper"  # Default
+    fi
+
+    # Source language manager and get provider-specific voice
+    if [[ -f "$SCRIPT_DIR/language-manager.sh" ]]; then
+        source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null
+        recommended_voice=$(get_voice_for_language "$language" "$provider" 2>/dev/null)
+    fi
+
+    # Fallback to hardcoded suggestions if function failed
+    if [[ -z "$recommended_voice" ]]; then
+        case "$(_to_lower "$language")" in
+            spanish|español)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "es_ES-davefx-medium" || echo "Antoni")
+                ;;
+            french|français)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "fr_FR-siwis-medium" || echo "Rachel")
+                ;;
+            german|deutsch)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "de_DE-thorsten-medium" || echo "Domi")
+                ;;
+            italian|italiano)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "it_IT-riccardo-x_low" || echo "Bella")
+                ;;
+            portuguese|português)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "pt_BR-faber-medium" || echo "Matilda")
+                ;;
+            chinese|中文|mandarin)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "zh_CN-huayan-medium" || echo "Amy")
+                ;;
+            *)
+                recommended_voice=$([ "$provider" = "piper" ] && echo "en_US-lessac-medium" || echo "Antoni")
+                ;;
+        esac
+    fi
+
+    echo "$recommended_voice"
+}
+
+# Suggest voice based on target language (displays suggestion message)
+suggest_voice_for_language() {
+    local language="$1"
+    local suggested_voice=$(get_recommended_voice_for_language "$language")
+
+    # Detect provider for display
+    local provider=""
+    if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
+        provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
+    elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+        provider=$(cat "$HOME/.claude/tts-provider.txt")
+    else
+        provider="piper"
+    fi
+
+    echo ""
+    echo -e "${BLUE}💡 Tip:${NC} For $language (using ${GREEN}$provider${NC} TTS), we recommend: ${YELLOW}$suggested_voice${NC}"
+    echo -e "   Set it with: ${YELLOW}/agent-vibes:target-voice $suggested_voice${NC}"
+}
+
+# Get target voice
+get_target_voice() {
+    if [[ -f "$TARGET_VOICE_FILE" ]]; then
+        cat "$TARGET_VOICE_FILE"
+    elif [[ -f "$GLOBAL_TARGET_VOICE_FILE" ]]; then
+        cat "$GLOBAL_TARGET_VOICE_FILE"
+    else
+        echo ""
+    fi
+}
+
+# Set target voice
+set_target_voice() {
+    local voice="$1"
+    if [[ -z "$voice" ]]; then
+        echo -e "${YELLOW}Usage: learn-manager.sh set-target-voice <voice>${NC}"
+        exit 1
+    fi
+
+    mkdir -p "$PROJECT_DIR/.claude"
+    echo "$voice" > "$TARGET_VOICE_FILE"
+    echo -e "${GREEN}✓${NC} Target voice set to: $voice"
+}
+
+# Check if learning mode is enabled
+is_learn_mode_enabled() {
+    if [[ -f "$LEARN_MODE_FILE" ]]; then
+        local mode=$(cat "$LEARN_MODE_FILE")
+        [[ "$mode" == "ON" ]]
+    elif [[ -f "$GLOBAL_LEARN_MODE_FILE" ]]; then
+        local mode=$(cat "$GLOBAL_LEARN_MODE_FILE")
+        [[ "$mode" == "ON" ]]
+    else
+        return 1
+    fi
+}
+
+# Enable learning mode
+enable_learn_mode() {
+    mkdir -p "$PROJECT_DIR/.claude"
+    echo "ON" > "$LEARN_MODE_FILE"
+    echo -e "${GREEN}✓${NC} Language learning mode: ${GREEN}ENABLED${NC}"
+    echo ""
+
+    # Auto-set target voice if target language is set but voice is not
+    local target_lang=$(get_target_language)
+    local target_voice=$(get_target_voice)
+    local voice_was_set=false
+
+    if [[ -n "$target_lang" ]] && [[ -z "$target_voice" ]]; then
+        echo -e "${BLUE}ℹ${NC}  Auto-configuring voice for $target_lang..."
+        local recommended_voice=$(get_recommended_voice_for_language "$target_lang")
+        if [[ -n "$recommended_voice" ]]; then
+            echo "$recommended_voice" > "$TARGET_VOICE_FILE"
+            target_voice="$recommended_voice"
+            echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
+
+            # Detect provider for display
+            local provider=""
+            if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
+                provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
+            elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+                provider=$(cat "$HOME/.claude/tts-provider.txt")
+            else
+                provider="piper"
+            fi
+            echo -e "   (for ${GREEN}$provider${NC} TTS)"
+            echo ""
+            voice_was_set=true
+        fi
+    fi
+
+    show_status
+
+    # Greet user with language teacher if everything is configured
+    if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
+        echo ""
+        local greeting=$(get_greeting_for_language "$target_lang")
+        echo -e "${BLUE}🎓${NC} Your language teacher says:"
+
+        # Detect provider
+        local provider=""
+        if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
+            provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
+        elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
+            provider=$(cat "$HOME/.claude/tts-provider.txt")
+        else
+            provider="piper"
+        fi
+
+        # Check if we're using Piper and if the voice is available
+        if [[ "$provider" == "piper" ]]; then
+            # Quick check: does the voice file exist?
+            local voice_dir="${HOME}/.claude/piper-voices"
+            if [[ -f "${voice_dir}/${target_voice}.onnx" ]]; then
+                # Voice exists, play greeting in background
+                nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
+            else
+                echo -e "${YELLOW}   (Voice not yet downloaded - greeting will play after first download)${NC}"
+            fi
+        else
+            # macOS or other provider - just play it in background
+            nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
+        fi
+    fi
+}
+
+# Disable learning mode
+disable_learn_mode() {
+    mkdir -p "$PROJECT_DIR/.claude"
+    echo "OFF" > "$LEARN_MODE_FILE"
+    echo -e "${GREEN}✓${NC} Language learning mode: ${YELLOW}DISABLED${NC}"
+}
+
+# Show learning mode status
+show_status() {
+    local main_lang=$(get_main_language)
+    local target_lang=$(get_target_language)
+    local target_voice=$(get_target_voice)
+    local learn_mode="OFF"
+
+    if is_learn_mode_enabled; then
+        learn_mode="ON"
+    fi
+
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}   Language Learning Mode Status${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+    echo -e "  ${BLUE}Learning Mode:${NC}    $(if [[ "$learn_mode" == "ON" ]]; then echo -e "${GREEN}ENABLED${NC}"; else echo -e "${YELLOW}DISABLED${NC}"; fi)"
+    echo -e "  ${BLUE}Main Language:${NC}    $main_lang"
+    echo -e "  ${BLUE}Target Language:${NC}  ${target_lang:-"(not set)"}"
+    echo -e "  ${BLUE}Target Voice:${NC}     ${target_voice:-"(not set)"}"
+    echo ""
+
+    if [[ "$learn_mode" == "ON" ]]; then
+        if [[ -z "$target_lang" ]]; then
+            echo -e "  ${YELLOW}⚠${NC}  Please set a target language: ${YELLOW}/agent-vibes:target <language>${NC}"
+        fi
+        if [[ -z "$target_voice" ]]; then
+            echo -e "  ${YELLOW}⚠${NC}  Please set a target voice: ${YELLOW}/agent-vibes:target-voice <voice>${NC}"
+        fi
+
+        if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
+            echo -e "  ${GREEN}✓${NC}  All set! TTS will speak in both languages."
+            echo ""
+            echo -e "  ${BLUE}How it works:${NC}"
+            echo -e "    1. First: Speak in ${BLUE}$main_lang${NC} (your current voice)"
+            echo -e "    2. Then: Speak in ${BLUE}$target_lang${NC} ($target_voice voice)"
+        fi
+    else
+        echo -e "  ${BLUE}💡 Tip:${NC} Enable learning mode with: ${YELLOW}/agent-vibes:learn${NC}"
+    fi
+
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+}
+
+# Main command handler - only run if script is executed directly, not sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+case "${1:-}" in
+    get-main-language)
+        get_main_language
+        ;;
+    set-main-language)
+        set_main_language "$2"
+        ;;
+    get-target-language)
+        get_target_language
+        ;;
+    set-target-language)
+        set_target_language "$2"
+        ;;
+    get-target-voice)
+        get_target_voice
+        ;;
+    set-target-voice)
+        set_target_voice "$2"
+        ;;
+    is-enabled)
+        if is_learn_mode_enabled; then
+            echo "ON"
+            exit 0
+        else
+            echo "OFF"
+            exit 1
+        fi
+        ;;
+    enable)
+        enable_learn_mode
+        ;;
+    disable)
+        disable_learn_mode
+        ;;
+    status)
+        show_status
+        ;;
+    *)
+        echo "Usage: learn-manager.sh {get-main-language|set-main-language|get-target-language|set-target-language|get-target-voice|set-target-voice|is-enabled|enable|disable|status}"
+        exit 1
+        ;;
+esac
+fi