mcp-voice-hooks 1.0.2 → 1.0.6

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

@@ -3,8 +3,11 @@
 # 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:3000/api/has-pending-utterances 2>/dev/null)
+response=$(curl -s http://localhost:${PORT}/api/has-pending-utterances 2>/dev/null)
 
 if [ $? -ne 0 ]; then
     # Server not available, allow tool execution

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

@@ -3,8 +3,11 @@
 # 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:3000/api/should-wait 2>/dev/null)
+response=$(curl -s http://localhost:${PORT}/api/should-wait 2>/dev/null)
 
 if [ $? -ne 0 ]; then
     # Server not available, allow stop

package/README.md

@@ -23,17 +23,7 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
 
 ## Installation in Your Own Project
 
-1. **Install the hooks** (first time only):
-
-   ```bash
-   npx mcp-voice-hooks install-hooks
-   ```
-
-   This will:
-   - Install hook scripts to `~/.mcp-voice-hooks/hooks/`
-   - Configure your project's `.claude/settings.json`
-
-2. **Add the MCP server**:
+1. **Add the MCP server**:
 
    Run the following command to automatically add the MCP server to your current project in `~/.claude.json`:
 
@@ -56,13 +46,17 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
    }
    ```
 
-3. **Start Claude Code**:
+2. **Start Claude Code**:
 
    ```bash
    claude
    ```
 
-4. **Open the voice interface** at <http://localhost:5111> and start speaking! Note: 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! 
+
+   The hooks are automatically installed when the MCP server starts. You need to send one text message to Claude to trigger the voice hooks.
+
+   **Note**: After the first-time installation, you may need to restart Claude for the hooks to take effect.
 
    The default port is 5111. To use a different port, add to your project's `.claude/settings.json`:
 
@@ -74,13 +68,45 @@ mcp-voice-hooks enables continuous voice conversations with AI assistants by:
    }
    ```
 
+## Manual Hook Installation
+
+The hooks are automatically installed/updated when the MCP server starts. However, if you need to manually install or reconfigure the hooks:
+
+```bash
+npx mcp-voice-hooks install-hooks
+```
+
+This will:
+
+- Clean up any existing `~/.mcp-voice-hooks` directory contents
+- Install/update hook scripts to `~/.mcp-voice-hooks/hooks/`
+- Configure your project's `.claude/settings.json`
+
+## Uninstallation
+
+To completely remove MCP Voice Hooks:
+
+```bash
+# Remove hooks and settings
+npx mcp-voice-hooks uninstall
+
+# Also remove from Claude MCP servers
+claude mcp remove voice-hooks
+```
+
+This will:
+
+- Remove the `~/.mcp-voice-hooks` directory
+- Clean up voice hooks from your project's `.claude/settings.json`
+- Preserve any custom hooks you've added
+
 ## Development Mode
 
 If you're developing mcp-voice-hooks itself:
 
 ```bash
 # 1. Clone the repository
-git clone https://github.com/yourusername/mcp-voice-hooks.git
+git clone https://github.com/johnmatthewtennant/mcp-voice-hooks.git
 cd mcp-voice-hooks
 
 # 2. Install dependencies
@@ -99,8 +125,9 @@ claude
 **Important**: When developing with `npm link`:
 
 - Claude runs the compiled JavaScript from the `dist` folder, not your TypeScript source
-- After making changes to the TypeScript code, you must run `npm run build`
-- Then restart Claude Code to use the updated compiled code
+- After making changes to **TypeScript files** (`src/*.ts`), you must run `npm run build`
+- For changes to **browser files** (`public/*`), just restart Claude Code
+- Then restart Claude Code to use the updated code
 
 ### Hot Reload
 

package/bin/cli.js

@@ -5,6 +5,7 @@ import path from 'path';
 import os from 'os';
 import { spawn } from 'child_process';
 import { fileURLToPath } from 'url';
+import { replaceVoiceHooks, areHooksEqual } from '../dist/hook-merger.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -26,10 +27,16 @@ async function main() {
       
       console.log('\n✅ Installation complete!');
       console.log('📝 To start the server, run: npx mcp-voice-hooks');
+    } else if (command === 'uninstall') {
+      console.log('🗑️  Uninstalling MCP Voice Hooks...');
+      await uninstall();
     } else {
-      // Default behavior: just run the MCP server
+      // Default behavior: ensure hooks are installed/updated, then run the MCP server
       console.log('🎤 MCP Voice Hooks - Starting server...');
-      console.log('💡 Note: If hooks are not installed, run: npx mcp-voice-hooks install-hooks');
+      
+      // Auto-install/update hooks on every startup
+      await ensureHooksInstalled();
+      
       console.log('');
       await runMCPServer();
     }
@@ -46,7 +53,30 @@ async function ensureUserDirectorySetup() {
   
   console.log('📁 Setting up user directory:', userDir);
   
-  // Create directories if they don't exist
+  // Clean up existing directory contents (except README.md if it exists)
+  if (fs.existsSync(userDir)) {
+    console.log('🧹 Cleaning up existing directory...');
+    
+    // Remove hooks directory if it exists
+    if (fs.existsSync(hooksDir)) {
+      fs.rmSync(hooksDir, { recursive: true, force: true });
+      console.log('✅ Cleaned up old hooks');
+    }
+    
+    // Remove any other files
+    const files = fs.readdirSync(userDir);
+    for (const file of files) {
+      const filePath = path.join(userDir, file);
+      const stat = fs.statSync(filePath);
+      if (stat.isDirectory()) {
+        fs.rmSync(filePath, { recursive: true, force: true });
+      } else {
+        fs.unlinkSync(filePath);
+      }
+    }
+  }
+  
+  // Create directories
   if (!fs.existsSync(userDir)) {
     fs.mkdirSync(userDir, { recursive: true });
     console.log('✅ Created user directory');
@@ -74,6 +104,15 @@ async function ensureUserDirectorySetup() {
   } else {
     console.log('⚠️  Package hooks directory not found, skipping hook installation');
   }
+  
+  // Copy README.md from project root to user directory
+  const projectReadmePath = path.join(__dirname, '..', 'README.md');
+  const userReadmePath = path.join(userDir, 'README.md');
+  
+  if (fs.existsSync(projectReadmePath)) {
+    fs.copyFileSync(projectReadmePath, userReadmePath);
+    console.log('✅ Copied README.md');
+  }
 }
 
 // Automatically configure Claude Code settings
@@ -139,14 +178,76 @@ async function configureClaudeCodeSettings() {
     ]
   };
   
-  // Update settings
-  settings.hooks = hookConfig;
+  // Replace voice hooks intelligently
+  const updatedHooks = replaceVoiceHooks(settings.hooks || {}, hookConfig);
+  
+  // Check if hooks actually changed (ignoring order)
+  if (areHooksEqual(settings.hooks || {}, updatedHooks)) {
+    console.log('✅ Claude settings already up to date');
+    return;
+  }
+  
+  // Update settings with new hooks
+  settings.hooks = updatedHooks;
   
   // Write settings back
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
   console.log('✅ Updated project Claude Code settings');
 }
 
+// Silent hook installation check - runs on every startup
+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...');
+    }
+    
+    // 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;
+        }
+      }
+    }
+    
+    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();
+    }
+  } catch (error) {
+    // Silently continue if hooks can't be updated
+    console.warn('⚠️  Could not auto-update hooks:', error.message);
+  }
+}
+
 // Run the MCP server
 async function runMCPServer() {
   const serverPath = path.join(__dirname, '..', 'dist', 'unified-server.js');
@@ -179,6 +280,56 @@ async function runMCPServer() {
   });
 }
 
+// Uninstall MCP Voice Hooks
+async function uninstall() {
+  const userDir = path.join(os.homedir(), '.mcp-voice-hooks');
+  const claudeSettingsPath = path.join(process.cwd(), '.claude', 'settings.json');
+  
+  // Step 1: Remove ~/.mcp-voice-hooks directory
+  if (fs.existsSync(userDir)) {
+    console.log('📁 Removing user directory:', userDir);
+    fs.rmSync(userDir, { recursive: true, force: true });
+    console.log('✅ Removed ~/.mcp-voice-hooks');
+  } else {
+    console.log('ℹ️  ~/.mcp-voice-hooks directory not found');
+  }
+  
+  // Step 2: Remove voice hooks from Claude settings
+  if (fs.existsSync(claudeSettingsPath)) {
+    try {
+      console.log('⚙️  Removing voice hooks from Claude settings...');
+      
+      const settingsContent = fs.readFileSync(claudeSettingsPath, 'utf8');
+      const settings = JSON.parse(settingsContent);
+      
+      if (settings.hooks) {
+        // Remove voice hooks
+        const cleanedHooks = removeVoiceHooks(settings.hooks);
+        
+        if (Object.keys(cleanedHooks).length === 0) {
+          // If no hooks remain, remove the hooks property entirely
+          delete settings.hooks;
+        } else {
+          settings.hooks = cleanedHooks;
+        }
+        
+        // Write updated settings
+        fs.writeFileSync(claudeSettingsPath, JSON.stringify(settings, null, 2));
+        console.log('✅ Removed voice hooks from Claude settings');
+      } else {
+        console.log('ℹ️  No hooks found in Claude settings');
+      }
+    } catch (error) {
+      console.log('⚠️  Could not update Claude settings:', error.message);
+    }
+  } else {
+    console.log('ℹ️  No Claude settings file found in current project');
+  }
+  
+  console.log('\n✅ Uninstallation complete!');
+  console.log('👋 MCP Voice Hooks has been removed.');
+}
+
 // Run the main function
 main().catch(error => {
   console.error('❌ Unexpected error:', error);

package/dist/hook-merger.d.ts

@@ -0,0 +1,33 @@
+interface Hook {
+    type: string;
+    command: string;
+}
+interface HookConfig {
+    matcher: string;
+    hooks: Hook[];
+}
+interface HookSettings {
+    [hookType: string]: HookConfig[];
+}
+/**
+ * Removes any existing voice hooks that reference our directory
+ * @param hooks - The current hooks configuration
+ * @returns The hooks with voice hooks removed
+ */
+declare function removeVoiceHooks(hooks?: HookSettings): HookSettings;
+/**
+ * Replaces voice hooks - removes any existing ones and adds new ones
+ * @param existingHooks - The current hooks configuration
+ * @param voiceHooks - The voice hooks to add
+ * @returns The updated hooks configuration
+ */
+declare function replaceVoiceHooks(existingHooks: HookSettings | undefined, voiceHooks: HookSettings): HookSettings;
+/**
+ * Checks if two hook settings are semantically equal (ignoring order)
+ * @param hooks1 - First hooks configuration
+ * @param hooks2 - Second hooks configuration
+ * @returns True if they contain the same hooks regardless of order
+ */
+declare function areHooksEqual(hooks1?: HookSettings, hooks2?: HookSettings): boolean;
+
+export { type HookSettings, areHooksEqual, removeVoiceHooks, replaceVoiceHooks };

package/dist/hook-merger.js

@@ -0,0 +1,54 @@
+// src/hook-merger.ts
+function removeVoiceHooks(hooks = {}) {
+  const cleaned = {};
+  const voiceHookPattern = /\.mcp-voice-hooks/;
+  for (const [hookType, hookArray] of Object.entries(hooks)) {
+    cleaned[hookType] = hookArray.filter((hookConfig) => {
+      return !hookConfig.hooks.some((hook) => voiceHookPattern.test(hook.command));
+    });
+    if (cleaned[hookType].length === 0) {
+      delete cleaned[hookType];
+    }
+  }
+  return cleaned;
+}
+function replaceVoiceHooks(existingHooks = {}, voiceHooks) {
+  const cleaned = removeVoiceHooks(existingHooks);
+  const result = JSON.parse(JSON.stringify(cleaned));
+  for (const [hookType, hookArray] of Object.entries(voiceHooks)) {
+    if (!result[hookType]) {
+      result[hookType] = hookArray;
+    } else {
+      result[hookType].push(...hookArray);
+    }
+  }
+  return result;
+}
+function areHooksEqual(hooks1 = {}, hooks2 = {}) {
+  const types1 = Object.keys(hooks1).sort();
+  const types2 = Object.keys(hooks2).sort();
+  if (types1.join(",") !== types2.join(",")) {
+    return false;
+  }
+  for (const hookType of types1) {
+    const configs1 = hooks1[hookType];
+    const configs2 = hooks2[hookType];
+    if (configs1.length !== configs2.length) {
+      return false;
+    }
+    const normalized1 = configs1.map((config) => JSON.stringify(config)).sort();
+    const normalized2 = configs2.map((config) => JSON.stringify(config)).sort();
+    for (let i = 0; i < normalized1.length; i++) {
+      if (normalized1[i] !== normalized2[i]) {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+export {
+  areHooksEqual,
+  removeVoiceHooks,
+  replaceVoiceHooks
+};
+//# sourceMappingURL=hook-merger.js.map

package/dist/hook-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hook-merger.ts"],"sourcesContent":["interface Hook {\n  type: string;\n  command: string;\n}\n\ninterface HookConfig {\n  matcher: string;\n  hooks: Hook[];\n}\n\nexport interface HookSettings {\n  [hookType: string]: HookConfig[];\n}\n\n/**\n * Removes any existing voice hooks that reference our directory\n * @param hooks - The current hooks configuration\n * @returns The hooks with voice hooks removed\n */\nexport function removeVoiceHooks(hooks: HookSettings = {}): HookSettings {\n  const cleaned: HookSettings = {};\n  const voiceHookPattern = /\\.mcp-voice-hooks/;\n  \n  for (const [hookType, hookArray] of Object.entries(hooks)) {\n    cleaned[hookType] = hookArray.filter(hookConfig => {\n      // Keep this hook config only if none of its commands reference our directory\n      return !hookConfig.hooks.some(hook => voiceHookPattern.test(hook.command));\n    });\n    \n    // Remove empty arrays\n    if (cleaned[hookType].length === 0) {\n      delete cleaned[hookType];\n    }\n  }\n  \n  return cleaned;\n}\n\n/**\n * Replaces voice hooks - removes any existing ones and adds new ones\n * @param existingHooks - The current hooks configuration\n * @param voiceHooks - The voice hooks to add\n * @returns The updated hooks configuration\n */\nexport function replaceVoiceHooks(existingHooks: HookSettings = {}, voiceHooks: HookSettings): HookSettings {\n  // First, remove any existing voice hooks\n  const cleaned = removeVoiceHooks(existingHooks);\n  \n  // Then merge in the new voice hooks\n  const result: HookSettings = JSON.parse(JSON.stringify(cleaned)); // Deep clone\n  \n  for (const [hookType, hookArray] of Object.entries(voiceHooks)) {\n    if (!result[hookType]) {\n      result[hookType] = hookArray;\n    } else {\n      result[hookType].push(...hookArray);\n    }\n  }\n  \n  return result;\n}\n\n/**\n * Checks if two hook settings are semantically equal (ignoring order)\n * @param hooks1 - First hooks configuration\n * @param hooks2 - Second hooks configuration\n * @returns True if they contain the same hooks regardless of order\n */\nexport function areHooksEqual(hooks1: HookSettings = {}, hooks2: HookSettings = {}): boolean {\n  const types1 = Object.keys(hooks1).sort();\n  const types2 = Object.keys(hooks2).sort();\n  \n  // Different hook types\n  if (types1.join(',') !== types2.join(',')) {\n    return false;\n  }\n  \n  // Check each hook type\n  for (const hookType of types1) {\n    const configs1 = hooks1[hookType];\n    const configs2 = hooks2[hookType];\n    \n    if (configs1.length !== configs2.length) {\n      return false;\n    }\n    \n    // Create normalized strings for comparison\n    const normalized1 = configs1\n      .map(config => JSON.stringify(config))\n      .sort();\n    const normalized2 = configs2\n      .map(config => JSON.stringify(config))\n      .sort();\n    \n    // Compare sorted arrays\n    for (let i = 0; i < normalized1.length; i++) {\n      if (normalized1[i] !== normalized2[i]) {\n        return false;\n      }\n    }\n  }\n  \n  return true;\n}"],"mappings":";AAmBO,SAAS,iBAAiB,QAAsB,CAAC,GAAiB;AACvE,QAAM,UAAwB,CAAC;AAC/B,QAAM,mBAAmB;AAEzB,aAAW,CAAC,UAAU,SAAS,KAAK,OAAO,QAAQ,KAAK,GAAG;AACzD,YAAQ,QAAQ,IAAI,UAAU,OAAO,gBAAc;AAEjD,aAAO,CAAC,WAAW,MAAM,KAAK,UAAQ,iBAAiB,KAAK,KAAK,OAAO,CAAC;AAAA,IAC3E,CAAC;AAGD,QAAI,QAAQ,QAAQ,EAAE,WAAW,GAAG;AAClC,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,kBAAkB,gBAA8B,CAAC,GAAG,YAAwC;AAE1G,QAAM,UAAU,iBAAiB,aAAa;AAG9C,QAAM,SAAuB,KAAK,MAAM,KAAK,UAAU,OAAO,CAAC;AAE/D,aAAW,CAAC,UAAU,SAAS,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC9D,QAAI,CAAC,OAAO,QAAQ,GAAG;AACrB,aAAO,QAAQ,IAAI;AAAA,IACrB,OAAO;AACL,aAAO,QAAQ,EAAE,KAAK,GAAG,SAAS;AAAA,IACpC;AAAA,EACF;AAEA,SAAO;AACT;AAQO,SAAS,cAAc,SAAuB,CAAC,GAAG,SAAuB,CAAC,GAAY;AAC3F,QAAM,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK;AACxC,QAAM,SAAS,OAAO,KAAK,MAAM,EAAE,KAAK;AAGxC,MAAI,OAAO,KAAK,GAAG,MAAM,OAAO,KAAK,GAAG,GAAG;AACzC,WAAO;AAAA,EACT;AAGA,aAAW,YAAY,QAAQ;AAC7B,UAAM,WAAW,OAAO,QAAQ;AAChC,UAAM,WAAW,OAAO,QAAQ;AAEhC,QAAI,SAAS,WAAW,SAAS,QAAQ;AACvC,aAAO;AAAA,IACT;AAGA,UAAM,cAAc,SACjB,IAAI,YAAU,KAAK,UAAU,MAAM,CAAC,EACpC,KAAK;AACR,UAAM,cAAc,SACjB,IAAI,YAAU,KAAK,UAAU,MAAM,CAAC,EACpC,KAAK;AAGR,aAAS,IAAI,GAAG,IAAI,YAAY,QAAQ,KAAK;AAC3C,UAAI,YAAY,CAAC,MAAM,YAAY,CAAC,GAAG;AACrC,eAAO;AAAA,MACT;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-voice-hooks",
-  "version": "1.0.2",
+  "version": "1.0.6",
   "main": "dist/index.js",
   "type": "module",
   "bin": {

package/public/app.js

@@ -276,9 +276,6 @@ class VoiceHooksClient {
     }
     
     async clearAllUtterances() {
-        if (!confirm('Are you sure you want to clear all utterances?')) {
-            return;
-        }
         
         this.clearAllBtn.disabled = true;
         this.clearAllBtn.textContent = 'Clearing...';