mcp-voice-hooks 1.0.30 → 1.0.31

package/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "mcp-voice-hooks-marketplace",
+  "owner": {
+    "name": "John Matthew Tennant"
+  },
+  "plugins": [
+    {
+      "name": "mcp-voice-hooks-plugin",
+      "source": "./plugin",
+      "description": "Real-time voice interaction for Claude Code. Speak naturally while Claude works - interrupt, redirect, or provide continuous feedback without stopping."
+    }
+  ]
+}

package/README.md

@@ -16,17 +16,28 @@ Voice recognition and text-to-speech are handled by the browser, so there is not
 
 ## Installation
 
-Installation is easy.
+There are two ways to install Voice Mode for Claude Code:
 
-### 1. Install Claude Code
+### Method 1: Plugin Installation (Recommended)
+
+The easiest way to install is using Claude Code's plugin system:
 
 ```bash
-npm install -g @anthropic-ai/claude-code
+# Add the marketplace
+claude plugin marketplace add johnmatthewtennant/mcp-voice-hooks
+
+# Install the plugin
+claude plugin install mcp-voice-hooks@mcp-voice-hooks
 ```
 
-### 2. Install Voice Mode
+That's it! The plugin automatically configures both the MCP server and hooks.
+
+### Method 2: Manual Installation (Legacy)
+
+If you prefer manual installation or need more control:
 
 ```bash
+# Install hooks and configure MCP server
 npx mcp-voice-hooks@latest install-hooks
 claude mcp add voice-hooks npx mcp-voice-hooks@latest
 ```
@@ -96,20 +107,23 @@ This will configure your project's `.claude/settings.local.json` with the necess
 
 ## Uninstallation
 
-To completely remove MCP Voice Hooks:
+### If installed via Plugin (Method 1)
 
 ```bash
-# Remove from Claude MCP servers
-claude mcp remove voice-hooks
+claude plugin uninstall mcp-voice-hooks@mcp-voice-hooks
 ```
 
+### If installed manually (Method 2)
+
 ```bash
+# Remove from Claude MCP servers
+claude mcp remove voice-hooks
+
 # Also remove hooks and settings
 npx mcp-voice-hooks uninstall
 ```
 
-This will:
-
+Both methods will:
 - Clean up voice hooks from your project's `.claude/settings.local.json`
 - Preserve any custom hooks you've added
 
@@ -142,6 +156,21 @@ claude
 - For changes to **browser files** (`public/*`), just restart Claude Code
 - Then restart Claude Code to use the updated code
 
+### Plugin Directory Structure
+
+```
+mcp-voice-hooks/
+├── .claude-plugin/
+│   └── marketplace.json          # Points to ./plugin
+├── .mcp.json                      # Local dev (no @latest, works with npm link)
+└── plugin/                        # Plugin distribution
+    ├── .claude-plugin/
+    │   └── plugin.json            # Plugin manifest
+    ├── hooks/
+    │   └── hooks.json             # Single source of truth for hooks
+    └── .mcp.json                  # Plugin users (with @latest)
+```
+
 ### Configuration
 
 #### Port Configuration

package/bin/cli.js

@@ -35,8 +35,14 @@ async function main() {
       // Default behavior: ensure hooks are installed/updated, then run the MCP server
       console.log('🎤 MCP Voice Hooks - Starting server...');
 
-      // Auto-install/update hooks on every startup
-      await ensureHooksInstalled();
+      // Skip hook installation if --skip-hooks flag is present (used by plugin mode)
+      const skipHooks = args.includes('--skip-hooks');
+      if (!skipHooks) {
+        // Auto-install/update hooks on every startup
+        await ensureHooksInstalled();
+      } else {
+        console.log('ℹ️  Skipping hook installation (plugin mode)');
+      }
 
       console.log('');
       await runMCPServer();
@@ -102,51 +108,10 @@ async function configureClaudeCodeSettings() {
     }
   }
 
-  // Add hook configuration with inline commands
-  const hookConfig = {
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/stop\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks unavailable\"}'"
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "^mcp__voice-hooks__speak$",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/pre-speak\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks unavailable\"}'"
-          }
-        ]
-      },
-      {
-        "matcher": "^mcp__voice-hooks__wait_for_utterance$",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/pre-wait\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks unavailable\"}'"
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "^(?!mcp__voice-hooks__).*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/post-tool\" || echo '{}'"
-          }
-        ]
-      }
-    ]
-  };
+  // Load hook configuration from plugin/hooks/hooks.json
+  const hooksJsonPath = path.join(__dirname, '..', 'plugin', 'hooks', 'hooks.json');
+  const hooksJson = JSON.parse(fs.readFileSync(hooksJsonPath, 'utf8'));
+  const hookConfig = hooksJson.hooks;
 
   // Replace voice hooks intelligently
   const updatedHooks = replaceVoiceHooks(settings.hooks || {}, hookConfig);

package/dev-marketplace/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "mcp-voice-hooks-dev-marketplace",
+  "owner": {
+    "name": "Local Dev"
+  },
+  "plugins": [
+    {
+      "name": "mcp-voice-hooks-dev-plugin",
+      "source": "./dev-plugin",
+      "description": "Development version of mcp-voice-hooks plugin (uses npm link)"
+    }
+  ]
+}

package/dev-marketplace/dev-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "mcp-voice-hooks-dev-plugin",
+  "version": "1.0.30",
+  "description": "Development version of mcp-voice-hooks (uses npm link)",
+  "author": {
+    "name": "John Matthew Tennant",
+    "url": "https://github.com/johnmatthewtennant"
+  }
+}

package/dev-marketplace/dev-plugin/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "voice-hooks": {
+      "command": "npx",
+      "args": [
+        "mcp-voice-hooks",
+        "--skip-hooks"
+      ],
+      "env": {}
+    }
+  }
+}

package/package.json

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

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "mcp-voice-hooks-plugin",
+  "version": "1.0.30",
+  "description": "Real-time voice interaction for Claude Code. Speak naturally while Claude works - interrupt, redirect, or provide continuous feedback without stopping.",
+  "author": {
+    "name": "John Matthew Tennant",
+    "url": "https://github.com/johnmatthewtennant"
+  },
+  "homepage": "https://github.com/johnmatthewtennant/mcp-voice-hooks#readme",
+  "repository": "https://github.com/johnmatthewtennant/mcp-voice-hooks",
+  "license": "UNLICENSED",
+  "keywords": [
+    "voice",
+    "speech-recognition",
+    "mcp",
+    "claude-code",
+    "voice-control",
+    "dictation",
+    "speech-to-text"
+  ]
+}

package/{.mcp.json → plugin/.mcp.json}

@@ -4,7 +4,8 @@
       "type": "stdio",
       "command": "npx",
       "args": [
-        "mcp-voice-hooks"
+        "mcp-voice-hooks",
+        "--skip-hooks"
       ],
       "env": {}
     }

package/plugin/hooks/hooks.json

@@ -0,0 +1,46 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/stop\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks not running\"}'"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "^(mcp__voice-hooks__speak|mcp__plugin_mcp-voice-hooks_voice-hooks__speak)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/pre-speak\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks not running\"}'"
+          }
+        ]
+      },
+      {
+        "matcher": "^(mcp__voice-hooks__wait_for_utterance|mcp__plugin_mcp-voice-hooks_voice-hooks__wait_for_utterance)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/pre-wait\" || echo '{\"decision\": \"approve\", \"reason\": \"voice-hooks not running\"}'"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "^(?!mcp__voice-hooks__|mcp__plugin_mcp-voice-hooks_voice-hooks__).*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "curl -s -X POST \"http://localhost:${MCP_VOICE_HOOKS_PORT:-5111}/api/hooks/post-tool\" || echo '{}'"
+          }
+        ]
+      }
+    ]
+  }
+}