agentvibes 2.4.3 → 2.5.0

package/.claude/commands/agent-vibes/verbosity.md

@@ -0,0 +1,89 @@
+---
+description: Get or set AgentVibes verbosity level (low/medium/high)
+tags: [user]
+---
+
+Get or set the AgentVibes verbosity level to control how much Claude speaks while working.
+
+## Usage
+
+- `/agent-vibes:verbosity` - Show current verbosity level
+- `/agent-vibes:verbosity low` - Set to LOW (minimal)
+- `/agent-vibes:verbosity medium` - Set to MEDIUM (balanced)
+- `/agent-vibes:verbosity high` - Set to HIGH (maximum transparency)
+
+## Verbosity Levels
+
+### LOW (Minimal)
+- ✅ Acknowledgments only (start of task)
+- ✅ Completions only (end of task)
+- 🔇 No reasoning spoken during work
+- Perfect for: Quiet work sessions, minimal distraction
+
+### MEDIUM (Balanced)
+- ✅ Acknowledgments
+- 🤔 Major decisions ("I'll use grep to search")
+- ✓ Key findings ("Found 12 instances")
+- ✅ Completions
+- Perfect for: Understanding major decisions without full narration
+
+### HIGH (Maximum Transparency)
+- ✅ Acknowledgments
+- 💭 All reasoning ("Let me search for all instances")
+- 🤔 All decisions ("I'll use grep for this")
+- ✓ All findings ("Found it at line 1323")
+- ✅ Completions
+- Perfect for: Full transparency, learning mode, debugging complex tasks
+
+## How It Works
+
+Claude uses **emoji markers** in its reasoning text:
+- 💭 = Reasoning/thinking
+- 🤔 = Decisions
+- ✓ = Findings/results
+
+Based on your verbosity level, AgentVibes automatically detects these markers and speaks them aloud.
+
+## Examples
+
+### LOW Verbosity
+```
+User: "Find all TODO comments"
+[TTS: "I'll search for those"]
+[Work happens silently...]
+[TTS: "Found 12 TODO comments"]
+```
+
+### MEDIUM Verbosity
+```
+User: "Find all TODO comments"
+[TTS: "I'll search for those"]
+🤔 I'll use grep to search all files
+[Work happens...]
+✓ Found 12 TODO comments across 5 files
+[TTS: "Found 12 TODO comments"]
+```
+
+### HIGH Verbosity
+```
+User: "Find all TODO comments"
+[TTS: "I'll search for those"]
+💭 Let me search through the codebase for TODO comments
+🤔 I'll use the Grep tool with pattern "TODO"
+[Grep runs...]
+✓ Found 12 TODO comments across 5 files
+💭 Let me organize these by file
+[TTS: "Found 12 TODO comments in 5 files"]
+```
+
+## Notes
+
+- Changes take effect on next Claude Code session restart
+- Verbosity is saved per-project (if `.claude/` exists) or globally
+- You can also control verbosity via MCP: `mcp__agentvibes__set_verbosity(level="high")`
+
+## Related Commands
+
+- `/agent-vibes:personality` - Set voice personality style
+- `/agent-vibes:switch` - Change voice
+- `/agent-vibes:provider` - Switch TTS provider

package/.claude/github-star-reminder.txt

@@ -0,0 +1 @@
+20251116

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

@@ -33,6 +33,9 @@ else
   STYLE_NAME="$PERSONALITY"
 fi
 
+# Get verbosity level (Issue #32)
+VERBOSITY=$(cat .claude/tts-verbosity.txt 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+
 # Output TTS protocol instructions to stdout
 # Claude Code will add this to the conversation context
 cat <<'EOF'
@@ -69,6 +72,70 @@ User: "check git status"
 
 EOF
 
-# Add current style info
+# Add verbosity-specific protocol (Issue #32)
+case "$VERBOSITY" in
+  low)
+    cat <<'EOF'
+## Verbosity: LOW (Minimal)
+- Speak only at acknowledgment (start) and completion (end)
+- Do NOT speak reasoning, decisions, or findings during work
+- Keep it quiet and focused
+
+EOF
+    ;;
+
+  medium)
+    cat <<'EOF'
+## Verbosity: MEDIUM (Balanced)
+- Speak at acknowledgment and completion (always)
+- Also speak major decisions and key findings during work
+- Use emoji markers for automatic TTS:
+  🤔 [decision text] - Major decisions (e.g., "🤔 I'll use grep to search all files")
+  ✓ [finding text] - Key findings (e.g., "✓ Found 12 instances at line 1323")
+
+Example:
+```
+User: "Find all TODO comments"
+[TTS: Acknowledgment]
+🤔 I'll use grep to search for TODO comments
+[Work happens...]
+✓ Found 12 TODO comments across 5 files
+[TTS: Completion]
+```
+
+EOF
+    ;;
+
+  high)
+    cat <<'EOF'
+## Verbosity: HIGH (Maximum Transparency)
+- Speak acknowledgment and completion (always)
+- Speak ALL reasoning, decisions, and findings as you work
+- Use emoji markers for automatic TTS:
+  💭 [reasoning text] - Thought process (e.g., "💭 Let me search for all instances")
+  🤔 [decision text] - Decisions (e.g., "🤔 I'll use grep for this")
+  ✓ [finding text] - Findings (e.g., "✓ Found it at line 1323")
+
+Example:
+```
+User: "Find all TODO comments"
+[TTS: Acknowledgment]
+💭 Let me search through the codebase for TODO comments
+🤔 I'll use the Grep tool with pattern "TODO"
+[Grep runs...]
+✓ Found 12 TODO comments across 5 files
+💭 Let me organize these results by file
+[Processing...]
+[TTS: Completion]
+```
+
+IMPORTANT: Use emoji markers naturally in your reasoning text. They trigger automatic TTS.
+
+EOF
+    ;;
+esac
+
+# Add current style and verbosity info
 echo "Current Style: ${STYLE_NAME} (${STYLE_MODE})"
+echo "Current Verbosity: ${VERBOSITY}"
 echo ""

package/.claude/hooks/user-prompt-output.sh

@@ -0,0 +1,111 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/user-prompt-output.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 Auto-detects emoji markers in Claude's output and triggers TTS
+# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and speaking them
+# @architecture Stdin reader, regex matcher, async TTS trigger
+# @dependencies play-tts.sh, tts-verbosity.txt
+# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
+# @patterns Text stream processing, background job execution, marker-based triggers
+# @related session-start-tts.sh, verbosity-manager.sh, Issue #32
+# @aiNotes This hook enables natural emoji-based TTS without Claude needing manual Bash calls
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
+
+# Get verbosity level
+VERBOSITY=$(cat .claude/tts-verbosity.txt 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+
+# Read stdin (Claude's output) - preserve it for display
+OUTPUT=$(cat)
+
+# Always output the original text first (so user sees it)
+echo "$OUTPUT"
+
+# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
+[[ ! -f "$PLAY_TTS" ]] && exit 0
+
+#
+# @function extract_and_speak
+# @context Extracts text after emoji markers and triggers TTS asynchronously
+# @architecture Uses grep to find markers, extracts text, launches TTS in background
+# @dependencies play-tts.sh
+# @entrypoints Called based on verbosity level
+# @aiNotes Background execution (&) prevents blocking Claude's output
+#
+extract_and_speak() {
+  local pattern="$1"
+
+  # Extract lines matching the pattern
+  # Pattern format: "emoji text" or "emoji [text]"
+  while IFS= read -r line; do
+    # Try to extract text after emoji
+    # Handles formats: "💭 text", "💭 [text]", "💭text"
+    if echo "$line" | grep -qE "$pattern"; then
+      # Extract everything after the emoji (and optional space/bracket)
+      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
+
+      # Skip if text is empty or too short
+      [[ -z "$text" || ${#text} -lt 3 ]] && continue
+
+      # Speak it in background (don't block)
+      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
+    fi
+  done <<< "$OUTPUT"
+}
+
+# Process based on verbosity level
+case "$VERBOSITY" in
+  high)
+    # HIGH: Speak ALL markers (💭 🤔 ✓)
+    # Don't speak ✅ here - that's handled by manual TTS completion call
+    extract_and_speak "💭|🤔|✓"
+    ;;
+
+  medium)
+    # MEDIUM: Speak decisions and findings (🤔 ✓)
+    extract_and_speak "🤔|✓"
+    ;;
+
+  low)
+    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
+    # Don't process any markers
+    ;;
+esac
+
+# Exit successfully
+exit 0

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

@@ -0,0 +1,172 @@
+#!/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)"
+CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+
+# 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 "low"
+# @dependencies tts-verbosity.txt config file
+# @entrypoints Called by session-start hook, MCP tools, slash commands
+# @aiNotes Default to "low" for backward compatibility with existing installations
+#
+get_verbosity() {
+  if [[ -f "$VERBOSITY_FILE" ]]; then
+    cat "$VERBOSITY_FILE"
+  elif [[ -f "$GLOBAL_VERBOSITY_FILE" ]]; then
+    cat "$GLOBAL_VERBOSITY_FILE"
+  else
+    echo "low"
+  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

package/.claude/piper-voices-dir.txt

@@ -0,0 +1 @@
+/home/fire/.claude/piper-voices

package/.mcp.json

@@ -0,0 +1,88 @@
+{
+  "mcpServers": {
+    "sentry": {
+      "command": "npx",
+      "args": [
+        "@sentry/mcp-server@latest",
+        "--host=sentry.io"
+      ],
+      "env": {
+        "SENTRY_ACCESS_TOKEN": "${SENTRY_ACCESS_TOKEN}",
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
+      }
+    },
+     "whatsapp": {
+      "command": "/home/fire/.local/bin/uv",
+      "args": [
+        "--directory",
+        "/home/fire/claude/whatsapp-mcp/whatsapp-mcp-server",
+        "run",
+        "main.py"
+      ]
+    },
+     "chrome-devtools": {
+      "command": "/home/fire/.nvm/versions/node/v22.20.0/bin/npx",
+      "args": [
+        "chrome-devtools-mcp@latest",
+        "--browserUrl=http://localhost:9222"
+      ],
+      "env": {
+        "PATH": "/home/fire/.nvm/versions/node/v22.20.0/bin:${PATH}",
+        "NODE_PATH": "/home/fire/.nvm/versions/node/v22.20.0/lib/node_modules"
+      }
+    },
+    "obsidian": {
+      "command": "/home/fire/.local/bin/uv",
+      "args": [
+        "--directory",
+        "/home/fire/claude/mcp_obsidian",
+        "run",
+        "mcp-obsidian"
+      ],
+      "env": {
+        "OBSIDIAN_API_KEY": "${MAIN_VAULT_OBSIDIAN_KEY}",
+        "OBSIDIAN_HOST": "${OBSIDIAN_HOST:-127.0.0.1}",
+        "OBSIDIAN_PORT": "27124",
+        "OBSIDIAN_HTTPS": "true",
+        "OBSIDIAN_VERIFY_SSL": "false"
+      }
+    },
+    "elevenlabs": {
+      "command": "npx",
+      "args": ["@microagents/mcp-server-elevenlabs"],
+      "env": {
+        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}",
+        "ELEVENLABS_MCP_BASE_PATH": "/home/fire/claude/SoraSage/teams/team-10/dev__globify__production/.claude/audio"
+      }
+    },
+    "spaceship": {
+      "command": "node",
+      "args": [
+        "/home/fire/claude/spaceship-mcp/dist/index.js"
+      ],
+      "env": {
+        "SPACESHIP_API_KEY": "${SPACESHIP_API_KEY}",
+        "SPACESHIP_API_SECRET": "${SPACESHIP_API_SECRET}"
+      }
+    },
+    "sonarqube": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--name",
+        "sonarqube-mcp-server-agentvibes",
+        "--rm",
+        "-e",
+        "SONARQUBE_TOKEN",
+        "-e",
+        "SONARQUBE_ORG",
+        "mcp/sonarqube"
+      ],
+      "env": {
+        "SONARQUBE_TOKEN": "${AGENTVIBES_SONARQUBE_TOKEN}",
+        "SONARQUBE_ORG": "${AGENTVIBES_SONARQUBE_ORG}"
+      }
+    }
+  }
+}

package/README.md

@@ -11,7 +11,7 @@
 [![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**: v2.4.3
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.5.0
 
 ---
 
@@ -36,6 +36,7 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ### 🎯 Key Features
 
+- 🎙️ **Verbosity Control** - **NEW!** Control how much Claude speaks (LOW: minimal, MEDIUM: balanced, HIGH: full transparency)
 - 🎙️ **AgentVibes MCP** - **NEW!** Natural language control for Claude Code, Claude Desktop & Warp (no slash commands!)
 - 📚 **Language Learning Mode** - **NEW!** Learn a second language while you program (e.g., Learn Spanish as you code!)
 - 🔊 **SSH Audio Optimization** - **NEW!** Auto-detects remote sessions and eliminates static (VS Code Remote SSH, cloud dev)
@@ -68,6 +69,7 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ### Core Features
 - [🎤 Commands Reference](#-commands-reference) - All available commands
+- [🎙️ Verbosity Control](#%EF%B8%8F-verbosity-control) - **NEW!** Control how much Claude speaks (low/medium/high)
 - [📚 Language Learning Mode](#-language-learning-mode) - **NEW!** Learn Spanish while you program
 - [🎭 Personalities vs Sentiments](#-personalities-vs-sentiments) - Two systems explained
 - [🗣️ Voice Library](#%EF%B8%8F-voice-library) - 27+ professional voices
@@ -92,15 +94,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.4.3 - macOS Compatibility Fixes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.4.3)** 🎉
+**[v2.5.0 - Verbosity Control System](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.5.0)** 🎉
 
-This patch release resolves three critical macOS installation issues discovered during user testing, completing the macOS compatibility work started in v2.4.0.
+This minor release introduces intelligent verbosity control - giving you precise control over how much Claude speaks while working.
 
 **Key highlights:**
-- 🍎 **ElevenLabs Audio Playback** - Uses native afplay on macOS
-- 🐚 **Shell Environment Detection** - Detects zsh vs bash correctly
-- 🎤 **Piper Version Check** - Uses full path to avoid false errors
-- 📦 **Plugin Manifest Handling** - Gracefully handles optional files
+- 🎙️ **Verbosity Control** - Three levels: LOW (minimal), MEDIUM (balanced), HIGH (full transparency)
+- 💭 **Emoji Markers** - Uses 💭 🤔 ✓ for automatic TTS detection
+- ⚙️ **Slash Command** - `/agent-vibes:verbosity [low|medium|high]`
+- 🔌 **MCP Integration** - Control via natural language
+- 🎯 **Smart Detection** - No manual Bash calls needed
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 
@@ -190,6 +193,51 @@ AgentVibes provides **50+ slash commands** and **natural language MCP equivalent
 
 ---
 
+## 🎙️ Verbosity Control
+
+**Control how much Claude speaks while working!** 🔊
+
+Choose from three verbosity levels:
+
+### LOW (Minimal) 🔇
+- Acknowledgments only (start of task)
+- Completions only (end of task)
+- Perfect for quiet work sessions
+
+### MEDIUM (Balanced) 🤔
+- Acknowledgments + completions
+- Major decisions ("I'll use grep to search")
+- Key findings ("Found 12 instances")
+- Perfect for understanding decisions without full narration
+
+### HIGH (Maximum Transparency) 💭
+- All reasoning ("Let me search for all instances")
+- All decisions ("I'll use grep for this")
+- All findings ("Found it at line 1323")
+- Perfect for learning mode, debugging complex tasks
+
+**Quick Commands:**
+```bash
+/agent-vibes:verbosity           # Show current level
+/agent-vibes:verbosity high      # Maximum transparency
+/agent-vibes:verbosity medium    # Balanced
+/agent-vibes:verbosity low       # Minimal (default)
+```
+
+**MCP Equivalent:**
+```
+"Set verbosity to high"
+"What's my current verbosity level?"
+```
+
+💡 **How it works:** Claude uses emoji markers (💭 🤔 ✓) in its text, and AgentVibes automatically detects and speaks them based on your verbosity level. No manual TTS calls needed!
+
+⚠️ **Note:** Changes take effect on next Claude Code session restart.
+
+[↑ Back to top](#-table-of-contents)
+
+---
+
 ## 📚 Language Learning Mode
 
 **🎯 Learn Spanish (or 30+ languages) while you program!** 🌍