captain-tool 0.0.3 → 0.0.7

package/README.md

@@ -50,6 +50,7 @@ The wizard will detect your platform, find the binary, and write the correct MCP
 
 Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
 
+**macOS / Linux:**
 ```json
 {
   "mcpServers": {
@@ -63,6 +64,21 @@ Edit `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Appli
 }
 ```
 
+**Windows** (requires `cmd /c` wrapper so the shell can resolve the `.cmd` shim):
+```json
+{
+  "mcpServers": {
+    "captain-tool": {
+      "command": "cmd",
+      "args": ["/c", "captain-tool"],
+      "env": {
+        "CAPTAIN_API_URL": "https://app.getcaptain.dev/"
+      }
+    }
+  }
+}
+```
+
 Restart Claude Desktop to activate.
 
 ### Claude Code (CLI)

package/bin/captain-tool-setup

@@ -132,6 +132,29 @@ const CLIENTS = [
 
 // ── Config entry builders ─────────────────────────────────────────────────────
 
+/**
+ * Build { command, args } that correctly invokes the captain-tool binary
+ * (or npx fallback) on the current OS.
+ *
+ * WHY the cmd /c wrapper on Windows?
+ *   On Windows, `npx` is installed as `npx.cmd` — a CMD batch script.
+ *   Processes launched without a shell (as MCP hosts do) cannot execute .cmd
+ *   files directly; they must be routed through `cmd /c`.  A bare .exe path
+ *   does NOT need this wrapper, so we only apply it when falling back to npx.
+ */
+function resolveCommand(binaryPath) {
+  if (binaryPath) {
+    // Direct binary — works on all platforms without a shell wrapper.
+    return { command: binaryPath, args: [] };
+  }
+  // Fallback: invoke via npx.  On Windows wrap with cmd /c so the host can
+  // execute the npx.cmd batch script.
+  if (process.platform === 'win32') {
+    return { command: 'cmd', args: ['/c', 'npx', 'captain-tool'] };
+  }
+  return { command: 'npx', args: ['captain-tool'] };
+}
+
 /**
  * Build the MCP server entry object for Format A clients
  * (Claude Desktop, Claude Code, Cursor, Windsurf).
@@ -140,9 +163,10 @@ const CLIENTS = [
  * No "type" field required.
  */
 function buildEntryFormatA(binaryPath) {
+  const { command, args } = resolveCommand(binaryPath);
   return {
-    command: binaryPath,
-    args: [],
+    command,
+    args,
     env: {
       CAPTAIN_API_URL,
     },
@@ -156,10 +180,11 @@ function buildEntryFormatA(binaryPath) {
  * Requires a "type": "stdio" field.
  */
 function buildEntryFormatB(binaryPath) {
+  const { command, args } = resolveCommand(binaryPath);
   return {
     type: 'stdio',
-    command: binaryPath,
-    args: [],
+    command,
+    args,
     env: {
       CAPTAIN_API_URL,
     },
@@ -258,17 +283,21 @@ async function main() {
   console.log('');
 
   // Resolve the absolute binary path — same logic as the runner.
+  // If no platform binary is installed we fall back to npx (null triggers the
+  // npx path in resolveCommand / buildEntry*).
   const binaryPath = findBinary();
-  if (!binaryPath) {
-    console.error(
-      'Error: captain-tool binary not found.\n' +
-      'Make sure you installed the package on a supported platform:\n' +
-      '  npm install -g captain-tool\n'
+  if (binaryPath) {
+    console.log(`Binary path: ${binaryPath}`);
+  } else {
+    const fallback = process.platform === 'win32'
+      ? 'cmd /c npx captain-tool'
+      : 'npx captain-tool';
+    console.warn(
+      `Warning: no pre-built binary found for this platform.\n` +
+      `Falling back to: ${fallback}\n` +
+      `For best performance, install on a supported platform: win32-x64, darwin-x64, darwin-arm64, linux-x64\n`
     );
-    process.exit(1);
   }
-
-  console.log(`Binary path: ${binaryPath}`);
   console.log('');
 
   // Present the client menu.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "captain-tool",
-  "version": "0.0.3",
+  "version": "0.0.7",
   "description": "MCP server connecting Claude Desktop and VS Code Copilot to Captain Cloud",
   "bin": {
     "captain-tool": "bin/captain-tool",
@@ -10,10 +10,10 @@
     "postinstall": "node scripts/postinstall.js"
   },
   "optionalDependencies": {
-    "@captain-tool/captain-tool-win32-x64": "0.0.3",
-    "@captain-tool/captain-tool-darwin-x64": "0.0.3",
-    "@captain-tool/captain-tool-darwin-arm64": "0.0.3",
-    "@captain-tool/captain-tool-linux-x64": "0.0.3"
+    "@captain-tool/captain-tool-win32-x64": "0.0.7",
+    "@captain-tool/captain-tool-darwin-x64": "0.0.7",
+    "@captain-tool/captain-tool-darwin-arm64": "0.0.7",
+    "@captain-tool/captain-tool-linux-x64": "0.0.7"
   },
   "files": [
     "bin/",