open-codex-computer-use-mcp 0.1.33 → 0.1.36

package/README.md

@@ -1,8 +1,17 @@
 # open-codex-computer-use-mcp
 
-Prebuilt macOS npm distribution for the open-source **Open Computer Use** MCP server.
+Cross-platform npm distribution for the open-source **Open Computer Use** MCP server.
 
-This package bundles a ready-to-run `Open Computer Use.app`, the Codex plugin metadata, and three global command aliases:
+This package bundles native runtimes for these supported platforms and lets the Node launcher choose the current `process.platform` / `process.arch` pair:
+
+- `darwin-arm64`
+- `darwin-x64`
+- `linux-arm64`
+- `linux-x64`
+- `win32-arm64`
+- `win32-x64`
+
+Global command aliases:
 
 - `open-computer-use`
 - `open-computer-use-mcp`
@@ -14,7 +23,7 @@ This package bundles a ready-to-run `Open Computer Use.app`, the Codex plugin me
 npm install -g open-codex-computer-use-mcp
 ```
 
-After install, run `open-computer-use doctor` first. If macOS `Accessibility` or `Screen Recording` permission is missing, it will open the permission onboarding window and tell you what still needs to be granted. If everything is already granted, it just prints the status and exits.
+The root launcher resolves the current `process.platform` / `process.arch` pair and runs the matching bundled native runtime.
 
 ## MCP config
 
@@ -31,52 +40,34 @@ If your MCP client accepts a stdio-style `mcpServers` JSON config, this is the d
 }
 ```
 
-In practice, using this package as MCP is: global install, add the JSON config, then grant macOS `Accessibility` and `Screen Recording` permission to the bundled npm-installed `Open Computer Use.app` on first use.
-
 Package page: https://www.npmjs.com/package/open-codex-computer-use-mcp
 
 ## Use
 
 ```bash
-# Show global help, command help, and version
-open-computer-use --help
-open-computer-use help snapshot
 open-computer-use --version
+open-computer-use --help
+open-computer-use mcp
+open-computer-use call list_apps
 
-# Install into Claude Code for the current project
-open-computer-use install-claude-mcp
+# macOS permission check and onboarding
+open-computer-use doctor
 
-# Install into Gemini CLI for the current project or user config
+# Installer helpers for MCP-capable CLIs
+open-computer-use install-claude-mcp
 open-computer-use install-gemini-mcp
 open-computer-use install-gemini-mcp --scope user
-
-# Install into Codex as a plain MCP entry in ~/.codex/config.toml
 open-computer-use install-codex-mcp
-
-# Install into opencode in ~/.config/opencode
 open-computer-use install-opencode-mcp
-
-# Check permissions first; if Accessibility / Screen Recording is missing, open the permission onboarding window
-# If both are already granted, this just prints the status and exits
-open-computer-use doctor
-
-# Start the stdio MCP server for Claude Desktop, Cursor, Cline, or another MCP client
-open-computer-use mcp
-
-# Call tools directly; the JSON-array form keeps state in one process for follow-up actions
-open-computer-use call list_apps
-open-computer-use call get_app_state --args '{"app":"TextEdit"}'
-open-computer-use call --calls '[{"tool":"get_app_state","args":{"app":"TextEdit"}},{"tool":"press_key","args":{"app":"TextEdit","key":"Return"}}]'
-
-# Install this package into the local Codex plugin marketplace/cache
 open-computer-use install-codex-plugin
 ```
 
 ## Notes
 
-- Version: `0.1.33`
-- Platform: macOS 14+
-- Architectures: `arm64` and `x64` via a universal app bundle
-- The host terminal or app still needs macOS `Accessibility` and `Screen Recording` permissions
+- Version: `0.1.36`
+- Supported npm platforms: `darwin-arm64`, `darwin-x64`, `linux-arm64`, `linux-x64`, `win32-arm64`, `win32-x64`
+- macOS still requires `Accessibility` and `Screen Recording` permissions.
+- Linux requires a signed-in desktop session with AT-SPI2 / D-Bus accessibility available for real app control.
+- Windows requires a signed-in desktop session for UI Automation access.
 
 Source repository: https://github.com/iFurySt/open-codex-computer-use

package/bin/open-codex-computer-use-mcp

@@ -1,9 +1,74 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-print_launcher_help() {
-  cat <<'EOF'
-Open Computer Use
+#!/usr/bin/env node
+const { spawn } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const platformPackages = {
+  "darwin-arm64": {
+    "executablePath": [
+      "dist",
+      "Open Computer Use.app",
+      "Contents",
+      "MacOS",
+      "OpenComputerUse"
+    ]
+  },
+  "darwin-x64": {
+    "executablePath": [
+      "dist",
+      "Open Computer Use.app",
+      "Contents",
+      "MacOS",
+      "OpenComputerUse"
+    ]
+  },
+  "linux-arm64": {
+    "executablePath": [
+      "dist",
+      "linux",
+      "arm64",
+      "open-computer-use"
+    ]
+  },
+  "linux-x64": {
+    "executablePath": [
+      "dist",
+      "linux",
+      "amd64",
+      "open-computer-use"
+    ]
+  },
+  "win32-arm64": {
+    "executablePath": [
+      "dist",
+      "windows",
+      "arm64",
+      "open-computer-use.exe"
+    ]
+  },
+  "win32-x64": {
+    "executablePath": [
+      "dist",
+      "windows",
+      "amd64",
+      "open-computer-use.exe"
+    ]
+  }
+};
+const packageRoot = path.resolve(__dirname, "..");
+const args = process.argv.slice(2);
+const command = args[0] || "";
+const installCommands = new Map([
+  ["install-claude-mcp", "install-claude-mcp.sh"],
+  ["install-clauce-mcp", "install-claude-mcp.sh"],
+  ["install-gemini-mcp", "install-gemini-mcp.sh"],
+  ["install-codex-mcp", "install-codex-mcp.sh"],
+  ["install-opencode-mcp", "install-opencode-mcp.sh"],
+  ["install-codex-plugin", "install-codex-plugin.sh"],
+]);
+
+function printLauncherHelp() {
+  console.log(`Open Computer Use
 
 Usage:
   open-computer-use [command] [options]
@@ -11,10 +76,10 @@ Usage:
 
 Commands:
   mcp                  Start the stdio MCP server.
-  doctor               Print permission status and launch onboarding if needed.
+  doctor               Print permission status and launch onboarding if needed on macOS.
   list-apps            Print running or recently used apps.
   snapshot <app>       Print the current accessibility snapshot for an app.
-  call <tool>           Call one tool, or run a JSON array of tool calls.
+  call <tool>          Call one tool, or run a JSON array of tool calls.
   turn-ended           Notify the running MCP process that the host turn ended.
   install-claude-mcp   Install the MCP server into ~/.claude.json for this project.
   install-gemini-mcp   Install the MCP server into Gemini CLI config.
@@ -29,116 +94,115 @@ Global options:
   -v, --version        Show version.
 
 Notes:
-  Running without a command launches the permission onboarding app.
-  Use `open-computer-use help <command>` for command-specific help.
-EOF
+  This npm package bundles native runtimes for supported platforms and selects the current os-arch at launch.
+  Use 'open-computer-use help <command>' for command-specific help.`);
 }
 
-script_path="${BASH_SOURCE[0]}"
-while [[ -L "${script_path}" ]]; do
-  script_dir="$(cd "$(dirname "${script_path}")" && pwd)"
-  script_path="$(readlink "${script_path}")"
-  if [[ "${script_path}" != /* ]]; then
-    script_path="${script_dir}/${script_path}"
-  fi
-done
-package_root="$(cd "$(dirname "${script_path}")/.." && pwd)"
-app_binary="${package_root}/dist/Open Computer Use.app/Contents/MacOS/OpenComputerUse"
-install_claude_mcp_script="${package_root}/scripts/install-claude-mcp.sh"
-install_gemini_mcp_script="${package_root}/scripts/install-gemini-mcp.sh"
-install_mcp_script="${package_root}/scripts/install-codex-mcp.sh"
-install_opencode_mcp_script="${package_root}/scripts/install-opencode-mcp.sh"
-install_script="${package_root}/scripts/install-codex-plugin.sh"
-
-if [[ "${1:-}" == "install-claude-mcp" || "${1:-}" == "install-clauce-mcp" ]]; then
-  shift
-  exec "${install_claude_mcp_script}" "$@"
-fi
-
-if [[ "${1:-}" == "install-gemini-mcp" ]]; then
-  shift
-  exec "${install_gemini_mcp_script}" "$@"
-fi
-
-if [[ "${1:-}" == "install-codex-mcp" ]]; then
-  shift
-  exec "${install_mcp_script}" "$@"
-fi
-
-if [[ "${1:-}" == "install-opencode-mcp" ]]; then
-  shift
-  exec "${install_opencode_mcp_script}" "$@"
-fi
-
-if [[ "${1:-}" == "install-codex-plugin" ]]; then
-  shift
-  exec "${install_script}" "$@"
-fi
-
-if [[ "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
-  print_launcher_help
-  exit 0
-fi
-
-if [[ "${1:-}" == "help" && $# -le 1 ]]; then
-  print_launcher_help
-  exit 0
-fi
-
-if [[ "${1:-}" == "help" && "${2:-}" == "install-codex-plugin" ]]; then
-  cat <<'EOF'
-Usage:
-  open-computer-use install-codex-plugin
+function printInstallHelp(scriptName, usage) {
+  console.log(`Usage:
+  ${usage}
 
-Install this npm package into the local Codex plugin cache.
-EOF
-  exit 0
-fi
+This helper updates a local MCP or plugin config to run:
+  open-computer-use mcp
 
-if [[ "${1:-}" == "help" && "${2:-}" == "install-codex-mcp" ]]; then
-  cat <<'EOF'
-Usage:
-  open-computer-use install-codex-mcp
+Script:
+  ${scriptName}`);
+}
 
-Install the open-computer-use MCP server into ~/.codex/config.toml.
-EOF
-  exit 0
-fi
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
 
-if [[ "${1:-}" == "help" && "${2:-}" == "install-gemini-mcp" ]]; then
-  cat <<'EOF'
-Usage:
-  open-computer-use install-gemini-mcp [--scope project|user]
+function spawnAndExit(executable, executableArgs) {
+  const child = spawn(executable, executableArgs, {
+    stdio: "inherit",
+    windowsHide: false,
+  });
+
+  child.on("error", (error) => {
+    fail(`Failed to start ${executable}: ${error.message}`);
+  });
+
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.on(signal, () => {
+      child.kill(signal);
+    });
+  }
+
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.exit(1);
+    }
+    process.exit(code ?? 0);
+  });
+}
 
-Install the open-computer-use MCP server into Gemini CLI config.
-EOF
-  exit 0
-fi
+function runInstallCommand(scriptName, scriptArgs) {
+  if (process.platform === "win32") {
+    fail(`${command} currently requires a POSIX shell. Configure your MCP client with command "open-computer-use" and args ["mcp"] on Windows.`);
+  }
 
-if [[ "${1:-}" == "help" && "${2:-}" == "install-opencode-mcp" ]]; then
-  cat <<'EOF'
-Usage:
-  open-computer-use install-opencode-mcp
+  const scriptPath = path.join(packageRoot, "scripts", scriptName);
+  if (!fs.existsSync(scriptPath)) {
+    fail(`Missing installer helper at ${scriptPath}.`);
+  }
 
-Install the open-computer-use MCP server into ~/.config/opencode.
-EOF
-  exit 0
-fi
+  spawnAndExit(scriptPath, scriptArgs);
+}
 
-if [[ "${1:-}" == "help" && ( "${2:-}" == "install-claude-mcp" || "${2:-}" == "install-clauce-mcp" ) ]]; then
-  cat <<'EOF'
-Usage:
-  open-computer-use install-claude-mcp
-  open-computer-use install-clauce-mcp
+function resolveNativeExecutable() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const target = platformPackages[platformKey];
+  if (!target) {
+    const supported = Object.keys(platformPackages).sort().join(", ");
+    fail(`Unsupported platform ${platformKey}. Supported platforms: ${supported}.`);
+  }
 
-Install the open-computer-use MCP server into ~/.claude.json for the current project.
-EOF
-  exit 0
-fi
+  const executablePath = path.join(packageRoot, ...target.executablePath);
+  if (!fs.existsSync(executablePath)) {
+    fail(`Missing bundled native runtime for ${platformKey} at ${executablePath}.
 
-if [[ ! -x "${app_binary}" ]]; then
-  echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
-  exit 1
-fi
+Reinstall with:
+  npm install -g open-computer-use`);
+  }
 
-exec "${app_binary}" "$@"
+  return executablePath;
+}
+
+if (command === "-h" || command === "--help" || (command === "help" && args.length <= 1)) {
+  printLauncherHelp();
+  process.exit(0);
+}
+
+if (command === "help" && args[1] === "install-codex-plugin") {
+  printInstallHelp("install-codex-plugin.sh", "open-computer-use install-codex-plugin");
+  process.exit(0);
+}
+
+if (command === "help" && args[1] === "install-codex-mcp") {
+  printInstallHelp("install-codex-mcp.sh", "open-computer-use install-codex-mcp");
+  process.exit(0);
+}
+
+if (command === "help" && args[1] === "install-gemini-mcp") {
+  printInstallHelp("install-gemini-mcp.sh", "open-computer-use install-gemini-mcp [--scope project|user]");
+  process.exit(0);
+}
+
+if (command === "help" && args[1] === "install-opencode-mcp") {
+  printInstallHelp("install-opencode-mcp.sh", "open-computer-use install-opencode-mcp");
+  process.exit(0);
+}
+
+if (command === "help" && (args[1] === "install-claude-mcp" || args[1] === "install-clauce-mcp")) {
+  printInstallHelp("install-claude-mcp.sh", "open-computer-use install-claude-mcp");
+  process.exit(0);
+}
+
+if (installCommands.has(command)) {
+  const scriptName = installCommands.get(command);
+  runInstallCommand(scriptName, args.slice(1));
+} else {
+  spawnAndExit(resolveNativeExecutable(), args);
+}