agentvibes 5.1.3 → 5.2.0

package/.claude/hooks/play-tts.sh

@@ -126,6 +126,16 @@ TEXT="${TEXT//\\?/?}"        # Remove \?
 TEXT="${TEXT//\\,/,}"        # Remove \,
 TEXT="${TEXT//\\./.}"        # Remove \. (keep the period)
 
+# When no --llm is supplied, route through the "default" pseudo-LLM so the
+# user-managed `llm:default` row in audio-effects.cfg becomes the global
+# fallback for voice / pretext / music / effects.  This is configured via
+# Setup → Default → Configure in the TUI.  If `llm:default` doesn't exist,
+# the lookup returns empty and the script falls through to the legacy
+# global config chain (project / user .agentvibes/config.json).
+if [[ -z "$LLM_PROVIDER" ]]; then
+  LLM_PROVIDER="default"
+fi
+
 # Per-LLM config lookup: if --llm is passed, look up llm:<name> in audio-effects.cfg
 # Format: llm:<name>|REVERB_PRESET|BACKGROUND_FILE|BACKGROUND_VOLUME|VOICE|PRETEXT
 _LLM_VOICE=""
@@ -198,7 +208,7 @@ else
 fi
 
 # Show GitHub star reminder (once per day)
-"$SCRIPT_DIR/github-star-reminder.sh" 2>/dev/null || true
+bash "$SCRIPT_DIR/github-star-reminder.sh" 2>/dev/null || true
 
 # @function detect_voice_provider
 # @intent Auto-detect provider from voice name (for mixed-provider support)
@@ -237,16 +247,22 @@ speak_text() {
 
   case "$provider" in
     piper)
-      "$SCRIPT_DIR/play-tts-piper.sh" "$text" "$voice" "$profile_file"
+      bash "$SCRIPT_DIR/play-tts-piper.sh" "$text" "$voice" "$profile_file"
       ;;
     soprano)
-      "$SCRIPT_DIR/play-tts-soprano.sh" "$text" "$voice"
+      bash "$SCRIPT_DIR/play-tts-soprano.sh" "$text" "$voice"
       ;;
     macos)
-      "$SCRIPT_DIR/play-tts-macos.sh" "$text" "$voice"
+      bash "$SCRIPT_DIR/play-tts-macos.sh" "$text" "$voice"
       ;;
     termux-ssh)
-      "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$text" "$voice"
+      bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$text" "$voice"
+      ;;
+    ssh-remote)
+      bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$text" "$voice"
+      ;;
+    agentvibes-receiver)
+      bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$text" "$voice"
       ;;
     *)
       echo "❌ Unknown provider: $provider" >&2
@@ -361,16 +377,22 @@ fi
 # Normal single-language mode - route to appropriate provider implementation
 case "$ACTIVE_PROVIDER" in
   piper)
-    exec "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE" "$AGENT_PROFILE_FILE"
+    exec bash "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE" "$AGENT_PROFILE_FILE"
     ;;
   soprano)
-    exec "$SCRIPT_DIR/play-tts-soprano.sh" "$TEXT" "$VOICE_OVERRIDE"
+    exec bash "$SCRIPT_DIR/play-tts-soprano.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   macos)
-    exec "$SCRIPT_DIR/play-tts-macos.sh" "$TEXT" "$VOICE_OVERRIDE"
+    exec bash "$SCRIPT_DIR/play-tts-macos.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   termux-ssh)
-    exec "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$TEXT" "$VOICE_OVERRIDE"
+    exec bash "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$TEXT" "$VOICE_OVERRIDE"
+    ;;
+  ssh-remote)
+    exec bash "$SCRIPT_DIR/play-tts-ssh-remote.sh" "$TEXT" "$VOICE_OVERRIDE"
+    ;;
+  agentvibes-receiver)
+    exec bash "$SCRIPT_DIR/play-tts-agentvibes-receiver-for-voiceless-connections.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   *)
     echo "❌ Unknown provider: $ACTIVE_PROVIDER" >&2

package/.claude/hooks/session-start-tts.sh

@@ -52,6 +52,9 @@ case "$VERBOSITY" in
   high)
     CONTEXT+="## Verbosity: HIGH\n- Acknowledgment: Action + approach + why\n- Completion: Result + decisions + trade-offs\n- Include: Full reasoning, alternatives\n\n"
     ;;
+  caveman)
+    CONTEXT+="## Verbosity: CAVEMAN\n- Respond terse. All technical substance stays. Only fluff dies.\n- Drop: articles (a/an/the), filler (just/really/basically), pleasantries, hedging\n- Abbreviate: DB/auth/config/req/res/fn/impl. Use arrows (X -> Y). Strip conjunctions.\n- Fragments OK. Short synonyms. Technical terms exact. Code unchanged.\n- Pattern: [thing] [action] [reason]. [next step].\n- TTS: Ultra-short. Max 60 chars.\n\n"
+    ;;
 esac
 
 # Add style info and rules
@@ -62,7 +65,7 @@ CONTEXT+="2. Never skip completion TTS\n"
 CONTEXT+="3. Match verbosity level\n"
 CONTEXT+="4. Keep under 150 chars\n"
 CONTEXT+="5. Always include errors\n\n"
-CONTEXT+="Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning"
+CONTEXT+="Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning | caveman=ultra-terse fragments"
 
 # Add BMAD agent voice routing instructions
 CONTEXT+="\n\n## BMAD Agent Voice Routing\n"

package/.claude/hooks/stop-tts.sh

@@ -79,6 +79,6 @@ if [[ -f "$BMAD_CONTEXT" ]] && [[ -f "$BMAD_SPEAK" ]]; then
 fi
 
 # Default: speak with global voice (run in background so we don't block Claude)
-"$SCRIPT_DIR/play-tts.sh" "$MESSAGE" &
+bash "$SCRIPT_DIR/play-tts.sh" "$MESSAGE" &
 
 exit 0

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

@@ -1,178 +1,185 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/verbosity-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, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview Manages AgentVibes verbosity level (low/medium/high)
-# @context Controls how much Claude speaks while working - acknowledgments only vs full reasoning
-# @architecture Simple config file reader/writer with project-local and global fallback
-# @dependencies tts-verbosity.txt config file
-# @entrypoints Called by slash commands, MCP tools, and session-start hook
-# @patterns Config file management, validation, graceful defaults
-# @related .claude/hooks/session-start-tts.sh, mcp-server/server.py, Issue #32
-
-# Fix locale warnings
-export LC_ALL=C
-
-# Get script directory for accessing other scripts
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-# Respect CLAUDE_PROJECT_DIR when set by MCP (project context vs global installation)
-if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
-  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
-else
-  CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
-fi
-
-# Config file locations
-VERBOSITY_FILE="$CLAUDE_DIR/tts-verbosity.txt"
-GLOBAL_VERBOSITY_FILE="$HOME/.claude/tts-verbosity.txt"
-
-#
-# @function get_verbosity
-# @context Returns the current verbosity level (low/medium/high)
-# @architecture Checks project-local first, then global, then defaults to "high"
-# @dependencies tts-verbosity.txt config file
-# @entrypoints Called by session-start hook, MCP tools, slash commands
-# @aiNotes Default to "high" to match installer default for new installations
-#
-get_verbosity() {
-  if [[ -f "$VERBOSITY_FILE" ]]; then
-    cat "$VERBOSITY_FILE"
-  elif [[ -f "$GLOBAL_VERBOSITY_FILE" ]]; then
-    cat "$GLOBAL_VERBOSITY_FILE"
-  else
-    echo "high"
-  fi
-}
-
-#
-# @function set_verbosity
-# @context Sets the verbosity level to low/medium/high
-# @architecture Validates input, saves to project-local if .claude exists, otherwise global
-# @dependencies None
-# @entrypoints Called by MCP tools and slash commands
-# @aiNotes Saves to project-local (.claude/) when available for per-project settings
-#
-set_verbosity() {
-  local level="$1"
-
-  # Validate input
-  if [[ ! "$level" =~ ^(low|medium|high)$ ]]; then
-    echo "❌ Invalid verbosity level: $level"
-    echo "Valid options: low, medium, high"
-    return 1
-  fi
-
-  # Save to project-local or global
-  if [[ -d "$CLAUDE_DIR" ]]; then
-    echo "$level" > "$VERBOSITY_FILE"
-    echo "✅ Verbosity set to: $level (project-local)"
-  else
-    mkdir -p "$(dirname "$GLOBAL_VERBOSITY_FILE")"
-    echo "$level" > "$GLOBAL_VERBOSITY_FILE"
-    echo "✅ Verbosity set to: $level (global)"
-  fi
-
-  echo ""
-  echo "💡 Verbosity levels:"
-  echo "   • LOW: Acknowledgments + Completions only"
-  echo "   • MEDIUM: + Major decisions and findings"
-  echo "   • HIGH: All reasoning (maximum transparency)"
-  echo ""
-  echo "⚠️  Restart Claude Code for changes to take effect"
-
-  return 0
-}
-
-#
-# @function show_info
-# @context Displays current verbosity level with detailed explanation
-# @architecture Reads current level and provides contextual help
-# @dependencies get_verbosity()
-# @entrypoints Called when no arguments provided
-# @aiNotes Helps users understand what each verbosity level does
-#
-show_info() {
-  local current_level
-  current_level=$(get_verbosity)
-
-  echo "🎙️  AgentVibes Verbosity Control"
-  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-  echo "Current level: $current_level"
-  echo ""
-  echo "Available levels:"
-  echo ""
-  echo "LOW (Minimal)"
-  echo "  ✅ Acknowledgments only"
-  echo "  ✅ Completions only"
-  echo "  🔇 No reasoning spoken"
-  echo ""
-  echo "MEDIUM (Balanced)"
-  echo "  ✅ Acknowledgments"
-  echo "  🤔 Major decisions"
-  echo "  ✓ Key findings"
-  echo "  ✅ Completions"
-  echo ""
-  echo "HIGH (Maximum Transparency)"
-  echo "  ✅ Acknowledgments"
-  echo "  💭 All reasoning"
-  echo "  🤔 All decisions"
-  echo "  ✓ All findings"
-  echo "  ✅ Completions"
-  echo ""
-  echo "Usage:"
-  echo "  $0 get                # Show current level"
-  echo "  $0 set low|medium|high # Change level"
-}
-
-# Main execution
-case "$1" in
-  get)
-    get_verbosity
-    ;;
-  set)
-    if [[ -z "$2" ]]; then
-      echo "❌ Error: Missing verbosity level"
-      echo "Usage: $0 set low|medium|high"
-      exit 1
-    fi
-    set_verbosity "$2"
-    ;;
-  info|"")
-    show_info
-    ;;
-  *)
-    echo "❌ Unknown command: $1"
-    echo "Usage: $0 {get|set|info} [level]"
-    exit 1
-    ;;
-esac
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/verbosity-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, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview Manages AgentVibes verbosity level (low/medium/high)
+# @context Controls how much Claude speaks while working - acknowledgments only vs full reasoning
+# @architecture Simple config file reader/writer with project-local and global fallback
+# @dependencies tts-verbosity.txt config file
+# @entrypoints Called by slash commands, MCP tools, and session-start hook
+# @patterns Config file management, validation, graceful defaults
+# @related .claude/hooks/session-start-tts.sh, mcp-server/server.py, Issue #32
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory for accessing other scripts
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Respect CLAUDE_PROJECT_DIR when set by MCP (project context vs global installation)
+if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
+else
+  CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+fi
+
+# Config file locations
+VERBOSITY_FILE="$CLAUDE_DIR/tts-verbosity.txt"
+GLOBAL_VERBOSITY_FILE="$HOME/.claude/tts-verbosity.txt"
+
+#
+# @function get_verbosity
+# @context Returns the current verbosity level (low/medium/high)
+# @architecture Checks project-local first, then global, then defaults to "high"
+# @dependencies tts-verbosity.txt config file
+# @entrypoints Called by session-start hook, MCP tools, slash commands
+# @aiNotes Default to "high" to match installer default for new installations
+#
+get_verbosity() {
+  if [[ -f "$VERBOSITY_FILE" ]]; then
+    cat "$VERBOSITY_FILE"
+  elif [[ -f "$GLOBAL_VERBOSITY_FILE" ]]; then
+    cat "$GLOBAL_VERBOSITY_FILE"
+  else
+    echo "high"
+  fi
+}
+
+#
+# @function set_verbosity
+# @context Sets the verbosity level to low/medium/high
+# @architecture Validates input, saves to project-local if .claude exists, otherwise global
+# @dependencies None
+# @entrypoints Called by MCP tools and slash commands
+# @aiNotes Saves to project-local (.claude/) when available for per-project settings
+#
+set_verbosity() {
+  local level="$1"
+
+  # Validate input
+  if [[ ! "$level" =~ ^(low|medium|high|caveman)$ ]]; then
+    echo "❌ Invalid verbosity level: $level"
+    echo "Valid options: low, medium, high, caveman"
+    return 1
+  fi
+
+  # Save to project-local or global
+  if [[ -d "$CLAUDE_DIR" ]]; then
+    echo "$level" > "$VERBOSITY_FILE"
+    echo "✅ Verbosity set to: $level (project-local)"
+  else
+    mkdir -p "$(dirname "$GLOBAL_VERBOSITY_FILE")"
+    echo "$level" > "$GLOBAL_VERBOSITY_FILE"
+    echo "✅ Verbosity set to: $level (global)"
+  fi
+
+  echo ""
+  echo "💡 Verbosity levels:"
+  echo "   • LOW: Acknowledgments + Completions only"
+  echo "   • MEDIUM: + Major decisions and findings"
+  echo "   • HIGH: All reasoning (maximum transparency)"
+  echo "   • CAVEMAN: Ultra-terse fragments, max token savings"
+  echo ""
+  echo "⚠️  Restart Claude Code for changes to take effect"
+
+  return 0
+}
+
+#
+# @function show_info
+# @context Displays current verbosity level with detailed explanation
+# @architecture Reads current level and provides contextual help
+# @dependencies get_verbosity()
+# @entrypoints Called when no arguments provided
+# @aiNotes Helps users understand what each verbosity level does
+#
+show_info() {
+  local current_level
+  current_level=$(get_verbosity)
+
+  echo "🎙️  AgentVibes Verbosity Control"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "Current level: $current_level"
+  echo ""
+  echo "Available levels:"
+  echo ""
+  echo "LOW (Minimal)"
+  echo "  ✅ Acknowledgments only"
+  echo "  ✅ Completions only"
+  echo "  🔇 No reasoning spoken"
+  echo ""
+  echo "MEDIUM (Balanced)"
+  echo "  ✅ Acknowledgments"
+  echo "  🤔 Major decisions"
+  echo "  ✓ Key findings"
+  echo "  ✅ Completions"
+  echo ""
+  echo "HIGH (Maximum Transparency)"
+  echo "  ✅ Acknowledgments"
+  echo "  💭 All reasoning"
+  echo "  🤔 All decisions"
+  echo "  ✓ All findings"
+  echo "  ✅ Completions"
+  echo ""
+  echo "CAVEMAN (Ultra-Terse)"
+  echo "  ⚡ Fragments only, no filler"
+  echo "  📉 65-75% fewer output tokens"
+  echo "  🔤 Abbreviations (DB/auth/config/fn/impl)"
+  echo "  ➡️  Arrows instead of prose (X -> Y)"
+  echo ""
+  echo "Usage:"
+  echo "  $0 get                # Show current level"
+  echo "  $0 set low|medium|high|caveman # Change level"
+}
+
+# Main execution
+case "$1" in
+  get)
+    get_verbosity
+    ;;
+  set)
+    if [[ -z "$2" ]]; then
+      echo "❌ Error: Missing verbosity level"
+      echo "Usage: $0 set low|medium|high|caveman"
+      exit 1
+    fi
+    set_verbosity "$2"
+    ;;
+  info|"")
+    show_info
+    ;;
+  *)
+    echo "❌ Unknown command: $1"
+    echo "Usage: $0 {get|set|info} [level]"
+    exit 1
+    ;;
+esac