mcp-voice-hooks 1.0.6 → 1.0.12

package/.claude/hooks/pre-speak-hook.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-speak || echo '{"decision": "approve", "reason": "voice-hooks unavailable"}'

package/.claude/hooks/pre-tool-hook.sh

@@ -1,33 +1,3 @@
 #!/bin/bash
-
-# Pre-Tool Hook - Checks for pending utterances before allowing tool execution
-# Forces Claude to use dequeue_utterances tool if there are pending utterances
-
-# Get port from environment variable or use default
 PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
-
-# Check has-pending-utterances endpoint
-response=$(curl -s http://localhost:${PORT}/api/has-pending-utterances 2>/dev/null)
-
-if [ $? -ne 0 ]; then
-    # Server not available, allow tool execution
-    echo '{"decision": "approve"}'
-    exit 0
-fi
-
-# Extract pending status
-hasPending=$(echo "$response" | jq -r '.hasPending')
-pendingCount=$(echo "$response" | jq -r '.pendingCount')
-
-if [ "$hasPending" = "true" ]; then
-    # There are pending utterances, block tool execution
-    cat <<EOF
-{
-  "decision": "block",
-  "reason": "There are $pendingCount pending voice utterances. Please use dequeue_utterances to process them first."
-}
-EOF
-else
-    # No pending utterances, allow tool execution
-    echo '{"decision": "approve"}'
-fi
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-tool || echo '{"decision": "approve", "reason": "voice-hooks unavailable"}'

package/.claude/hooks/pre-wait-hook.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
+curl -s -X POST http://localhost:${PORT}/api/hooks/pre-wait || echo '{"decision": "approve", "reason": "voice-hooks unavailable"}'

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

@@ -1,32 +1,3 @@
 #!/bin/bash
-
-# Stop Hook - Intelligently decides whether to wait for voice input
-# Checks if there have been any utterances since the last timeout
-
-# Get port from environment variable or use default
 PORT="${MCP_VOICE_HOOKS_PORT:-5111}"
-
-# Check should-wait endpoint
-response=$(curl -s http://localhost:${PORT}/api/should-wait 2>/dev/null)
-
-if [ $? -ne 0 ]; then
-    # Server not available, allow stop
-    echo '{"decision": "approve"}'
-    exit 0
-fi
-
-# Extract shouldWait boolean
-shouldWait=$(echo "$response" | jq -r '.shouldWait')
-
-if [ "$shouldWait" = "true" ]; then
-    # There have been utterances since last timeout, block and ask to wait
-    cat <<EOF
-{
-  "decision": "block",
-  "reason": "Assistant tried to end its response. Stopping is not allowed without first checking for voice input. Assistant should now use wait_for_utterance to check for voice input"
-}
-EOF
-else
-    # No utterances since last timeout, allow stop
-    echo '{"decision": "approve", "reason": "No utterances since last timeout"}'
-fi
+curl -s -X POST http://localhost:${PORT}/api/hooks/stop || echo '{"decision": "approve", "reason": "voice-hooks unavailable"}'

package/CLAUDE.local.md

@@ -4,17 +4,10 @@
 # 1. Build the project first
 npm run build
 
-# 2. Update roadmap.md with version info and stage it
-git add roadmap.md
+# 2. Bump version (patch, minor, or major) - creates a commit and tag
+HUSKY=0 npm version patch --registry https://registry.npmjs.org/
 
-# 3. Bump version (patch, minor, or major) - creates a commit and tag
-npm version patch --registry https://registry.npmjs.org/
-
-# Alternative: Bump version without creating a commit/tag
-# npm version patch --no-git-tag-version
-# Then manually commit the changes
-
-# 4. Publish to npm (this creates the .tgz file automatically)
+# 3. Publish to npm (this creates the .tgz file automatically)
 npm publish --registry https://registry.npmjs.org/
 
 # Note: It can take 1-5 minutes for the package to be available globally

package/README.md

@@ -2,6 +2,10 @@
 
 Real-time voice interaction for Claude Code. Speak naturally while Claude works - interrupt, redirect, or provide continuous feedback without stopping.
 
+Optionally enable text-to-speech to have Claude speak back to you.
+
+Mac only for now.
+
 ## Demo
 
 [![Voice Hooks Demo](https://img.youtube.com/vi/KpkxvJ65gbM/0.jpg)](https://youtu.be/KpkxvJ65gbM)
@@ -15,11 +19,11 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
 - Using hooks to ensure Claude checks for voice input before tool use and before stopping
 - Allowing natural interruptions like "No, stop that" or "Wait, try something else"
 
-## Features
+## Browser Compatibility
 
-- 🎤 **Real-time Voice Capture**: Browser-based speech recognition with automatic segmentation
-- 🔄 **Continuous Interaction**: Keep talking while Claude works - no need to stop between commands
-- 🪝 **Smart Hook System**: Pre-tool and stop hooks ensure Claude always checks for your input
+- ✅ **Chrome**: Full support for speech recognition and text-to-speech
+- ✅ **Safari**: Full support for speech recognition and text-to-speech
+- ❌ **Edge**: Speech recognition not working on Apple Silicon (language-not-supported error)
 
 ## Installation in Your Own Project
 
@@ -52,21 +56,41 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
    claude
    ```
 
-3. **Open the voice interface** at <http://localhost:5111> and start speaking! 
+   **Important**: After the first-time installation, you will need to restart Claude for the hooks to take effect. This is because the hooks are automatically installed when the MCP server starts for the first time.
 
-   The hooks are automatically installed when the MCP server starts. You need to send one text message to Claude to trigger the voice hooks.
+3. **Open the voice interface** at <http://localhost:5111> and start speaking!
 
-   **Note**: After the first-time installation, you may need to restart Claude for the hooks to take effect.
+  You need to send one text message to Claude to trigger the voice hooks.
 
-   The default port is 5111. To use a different port, add to your project's `.claude/settings.json`:
+## Voice responses
 
-   ```json
-   {
-     "env": {
-       "MCP_VOICE_HOOKS_PORT": "8080"
-     }
-   }
-   ```
+There are two options for voice responses:
+
+1. Browser Text-to-Speech (Cloud)
+2. Browser Text-to-Speech (Local)
+3. Mac System Voice
+
+### Selecting and downloading high quality System Voices (Mac only)
+
+When "Mac System Voice" is selected, the system uses macOS's built-in `say` command.
+
+Configure the system voice in `System Settings > Accessibility > Spoken Content > System Voice`
+
+I recommend using a Siri voice, as they are much higher quality.
+
+Click the info icon next to the system voice dropdown. Search for "Siri" to find the highest quality voices. You'll have to trigger a download of the voice.
+
+It may take a while to download.
+
+Once it's downloaded, you can select it in the system voice dropdown.
+
+Test it with the bash command:
+
+```bash
+say "Hi, this is your mac system voice"
+```
+
+You can also download other high quality voices in the same way. Other voices will show up in the browser voice dropdown, but for Siri voices you need to set the system voice and select Mac System Voice in the browser voice dropdown.
 
 ## Manual Hook Installation
 
@@ -100,6 +124,10 @@ This will:
 - Clean up voice hooks from your project's `.claude/settings.json`
 - Preserve any custom hooks you've added
 
+## Known Limitations
+
+- **Intermittent Stop Hook Execution**: Claude Code's Stop hooks are not triggered consistently. Sometimes the assistant can end responses without the Stop hook being executed. I believe this is an issue with Claude Code's hook system, not with mcp-voice-hooks. When working correctly, the Stop hook should prevent the assistant from stopping without first checking for voice input.
+
 ## Development Mode
 
 If you're developing mcp-voice-hooks itself:
@@ -152,65 +180,14 @@ and then configure claude to use the mcp proxy like so:
 }
 ```
 
-## Voice responses (Mac only)
+### Port Configuration
 
-Add the post tool hook to your claude settings:
+The default port is 5111. To use a different port, add to your project's `.claude/settings.json`:
 
-```json
-{
+   ```json
    {
-     "hooks": {
-        "PostToolUse": [
-            {
-                "matcher": "^mcp__voice-hooks__",
-                "hooks": [
-                    {
-                        "type": "command",
-                        "command": "./.claude/hooks/post-tool-voice-hook.sh"
-                    }
-                ]
-            }
-        ]
-     },
      "env": {
-       "VOICE_RESPONSES_ENABLED": "true"
+       "MCP_VOICE_HOOKS_PORT": "8080"
      }
    }
-}
-```
-
-### Configuration
-
-Voice responses are disabled by default. To enable them:
-
-Add to your Claude Code settings JSON:
-
-```json
-{
-  "env": {
-    "VOICE_RESPONSES_ENABLED": "true"
-  }
-}
-```
-
-To disable voice responses, set the value to `false` or remove the setting entirely.
-
-### High quality voice responses
-
-These voice responses are spoken by your Mac's system voice.
-
-Configure in `System Settings > Accessibility > Spoken Content > System Voice`
-
-I recommend using a Siri voice, as they are much higher quality.
-
-Click the info icon next to the system voice dropdown. Search for "Siri" to find the highest quality voices. You'll have to trigger a download of the voice.
-
-It may take a while to download.
-
-Once it's downloaded, you can select it in the system voice dropdown.
-
-Test it with the bash command:
-
-```bash
-say "Hi, this is your mac system voice"
-```
+   ```

package/bin/cli.js

@@ -163,15 +163,22 @@ async function configureClaudeCodeSettings() {
             "command": "sh ~/.mcp-voice-hooks/hooks/pre-tool-hook.sh"
           }
         ]
-      }
-    ],
-    "PostToolUse": [
+      },
+      {
+        "matcher": "^mcp__voice-hooks__speak$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "sh ~/.mcp-voice-hooks/hooks/pre-speak-hook.sh"
+          }
+        ]
+      },
       {
-        "matcher": "^mcp__voice-hooks__",
+        "matcher": "^mcp__voice-hooks__wait_for_utterance$",
         "hooks": [
           {
             "type": "command",
-            "command": "sh ~/.mcp-voice-hooks/hooks/post-tool-voice-hook.sh"
+            "command": "sh ~/.mcp-voice-hooks/hooks/pre-wait-hook.sh"
           }
         ]
       }
@@ -199,49 +206,19 @@ async function configureClaudeCodeSettings() {
 async function ensureHooksInstalled() {
   const userDir = path.join(os.homedir(), '.mcp-voice-hooks');
   const hooksDir = path.join(userDir, 'hooks');
-  const packageHooksDir = path.join(__dirname, '..', '.claude', 'hooks');
   
   try {
-    // Only create directories if they don't exist
-    if (!fs.existsSync(hooksDir)) {
-      fs.mkdirSync(hooksDir, { recursive: true });
-      console.log('🔧 Installing hooks for first time...');
-    }
+    console.log('🔄 Updating hooks to latest version...');
     
-    // Check if hooks need updating
-    let needsUpdate = false;
-    if (fs.existsSync(packageHooksDir)) {
-      const hookFiles = fs.readdirSync(packageHooksDir).filter(file => file.endsWith('.sh'));
-      
-      for (const hookFile of hookFiles) {
-        const sourcePath = path.join(packageHooksDir, hookFile);
-        const destPath = path.join(hooksDir, hookFile);
-        
-        // Check if hook doesn't exist or is different
-        if (!fs.existsSync(destPath)) {
-          needsUpdate = true;
-          break;
-        }
-        
-        const sourceContent = fs.readFileSync(sourcePath, 'utf8');
-        const destContent = fs.readFileSync(destPath, 'utf8');
-        
-        if (sourceContent !== destContent) {
-          needsUpdate = true;
-          break;
-        }
-      }
+    // Always remove and recreate the hooks directory to ensure clean state
+    if (fs.existsSync(hooksDir)) {
+      fs.rmSync(hooksDir, { recursive: true, force: true });
     }
     
-    if (needsUpdate) {
-      console.log('🔄 Updating hooks to latest version...');
-      await ensureUserDirectorySetup();
-      await configureClaudeCodeSettings();
-      console.log('✅ Hooks and settings updated');
-    } else {
-      // Even if hooks are up to date, ensure settings are correct
-      await configureClaudeCodeSettings();
-    }
+    // Recreate with latest hooks
+    await ensureUserDirectorySetup();
+    await configureClaudeCodeSettings();
+    console.log('✅ Hooks and settings updated');
   } catch (error) {
     // Silently continue if hooks can't be updated
     console.warn('⚠️  Could not auto-update hooks:', error.message);