open-computer-use 0.1.5 → 0.1.9

package/README.md

@@ -14,6 +14,8 @@ This package bundles a ready-to-run `Open Computer Use.app`, the Codex plugin me
 npm install -g open-computer-use
 ```
 
+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.
+
 ## MCP config
 
 If your MCP client accepts a stdio-style `mcpServers` JSON config, this is the default setup:
@@ -31,10 +33,23 @@ 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 host terminal or app on first use.
 
+Package page: https://www.npmjs.com/package/open-computer-use
+
 ## Use
 
 ```bash
-# Check permissions; if Accessibility / Screen Recording is missing, open the permission onboarding window
+# Show global help, command help, and version
+open-computer-use --help
+open-computer-use help snapshot
+open-computer-use --version
+
+# Install into Claude Code for the current project
+open-computer-use install-claude-mcp
+
+# Install into Codex as a plain MCP entry in ~/.codex/config.toml
+open-computer-use install-codex-mcp
+
+# Check permissions first; if Accessibility / Screen Recording is missing, open the permission onboarding window
 open-computer-use doctor
 
 # Start the stdio MCP server for Claude Desktop, Cursor, Cline, or another MCP client
@@ -46,7 +61,7 @@ open-computer-use install-codex-plugin
 
 ## Notes
 
-- Version: `0.1.5`
+- Version: `0.1.9`
 - 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

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

@@ -1,6 +1,36 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+print_launcher_help() {
+  cat <<'EOF'
+Open Computer Use
+
+Usage:
+  open-computer-use [command] [options]
+  open-computer-use
+
+Commands:
+  mcp                  Start the stdio MCP server.
+  doctor               Print permission status and launch onboarding if needed.
+  list-apps            Print running or recently used apps.
+  snapshot <app>       Print the current accessibility snapshot for an app.
+  turn-ended           Acknowledge the host turn boundary.
+  install-claude-mcp   Install the MCP server into ~/.claude.json for this project.
+  install-codex-mcp    Install the MCP server into ~/.codex/config.toml.
+  install-codex-plugin Install this npm package into the local Codex plugin cache.
+  help [command]       Show general or command-specific help.
+  version              Print the CLI version.
+
+Global options:
+  -h, --help           Show help.
+  -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
+}
+
 script_path="${BASH_SOURCE[0]}"
 while [[ -L "${script_path}" ]]; do
   script_dir="$(cd "$(dirname "${script_path}")" && pwd)"
@@ -11,13 +41,66 @@ while [[ -L "${script_path}" ]]; do
 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_mcp_script="${package_root}/scripts/install-codex-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-codex-mcp" ]]; then
+  shift
+  exec "${install_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
+
+Install this npm package into the local Codex plugin cache.
+EOF
+  exit 0
+fi
+
+if [[ "${1:-}" == "help" && "${2:-}" == "install-codex-mcp" ]]; then
+  cat <<'EOF'
+Usage:
+  open-computer-use install-codex-mcp
+
+Install the open-computer-use MCP server into ~/.codex/config.toml.
+EOF
+  exit 0
+fi
+
+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
+
+Install the open-computer-use MCP server into ~/.claude.json for the current project.
+EOF
+  exit 0
+fi
+
 if [[ ! -x "${app_binary}" ]]; then
   echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
   exit 1

package/bin/open-computer-use

@@ -1,6 +1,36 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+print_launcher_help() {
+  cat <<'EOF'
+Open Computer Use
+
+Usage:
+  open-computer-use [command] [options]
+  open-computer-use
+
+Commands:
+  mcp                  Start the stdio MCP server.
+  doctor               Print permission status and launch onboarding if needed.
+  list-apps            Print running or recently used apps.
+  snapshot <app>       Print the current accessibility snapshot for an app.
+  turn-ended           Acknowledge the host turn boundary.
+  install-claude-mcp   Install the MCP server into ~/.claude.json for this project.
+  install-codex-mcp    Install the MCP server into ~/.codex/config.toml.
+  install-codex-plugin Install this npm package into the local Codex plugin cache.
+  help [command]       Show general or command-specific help.
+  version              Print the CLI version.
+
+Global options:
+  -h, --help           Show help.
+  -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
+}
+
 script_path="${BASH_SOURCE[0]}"
 while [[ -L "${script_path}" ]]; do
   script_dir="$(cd "$(dirname "${script_path}")" && pwd)"
@@ -11,13 +41,66 @@ while [[ -L "${script_path}" ]]; do
 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_mcp_script="${package_root}/scripts/install-codex-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-codex-mcp" ]]; then
+  shift
+  exec "${install_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
+
+Install this npm package into the local Codex plugin cache.
+EOF
+  exit 0
+fi
+
+if [[ "${1:-}" == "help" && "${2:-}" == "install-codex-mcp" ]]; then
+  cat <<'EOF'
+Usage:
+  open-computer-use install-codex-mcp
+
+Install the open-computer-use MCP server into ~/.codex/config.toml.
+EOF
+  exit 0
+fi
+
+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
+
+Install the open-computer-use MCP server into ~/.claude.json for the current project.
+EOF
+  exit 0
+fi
+
 if [[ ! -x "${app_binary}" ]]; then
   echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
   exit 1

package/bin/open-computer-use-mcp

@@ -1,6 +1,36 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+print_launcher_help() {
+  cat <<'EOF'
+Open Computer Use
+
+Usage:
+  open-computer-use [command] [options]
+  open-computer-use
+
+Commands:
+  mcp                  Start the stdio MCP server.
+  doctor               Print permission status and launch onboarding if needed.
+  list-apps            Print running or recently used apps.
+  snapshot <app>       Print the current accessibility snapshot for an app.
+  turn-ended           Acknowledge the host turn boundary.
+  install-claude-mcp   Install the MCP server into ~/.claude.json for this project.
+  install-codex-mcp    Install the MCP server into ~/.codex/config.toml.
+  install-codex-plugin Install this npm package into the local Codex plugin cache.
+  help [command]       Show general or command-specific help.
+  version              Print the CLI version.
+
+Global options:
+  -h, --help           Show help.
+  -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
+}
+
 script_path="${BASH_SOURCE[0]}"
 while [[ -L "${script_path}" ]]; do
   script_dir="$(cd "$(dirname "${script_path}")" && pwd)"
@@ -11,13 +41,66 @@ while [[ -L "${script_path}" ]]; do
 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_mcp_script="${package_root}/scripts/install-codex-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-codex-mcp" ]]; then
+  shift
+  exec "${install_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
+
+Install this npm package into the local Codex plugin cache.
+EOF
+  exit 0
+fi
+
+if [[ "${1:-}" == "help" && "${2:-}" == "install-codex-mcp" ]]; then
+  cat <<'EOF'
+Usage:
+  open-computer-use install-codex-mcp
+
+Install the open-computer-use MCP server into ~/.codex/config.toml.
+EOF
+  exit 0
+fi
+
+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
+
+Install the open-computer-use MCP server into ~/.claude.json for the current project.
+EOF
+  exit 0
+fi
+
 if [[ ! -x "${app_binary}" ]]; then
   echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
   exit 1

package/dist/Open Computer Use.app/Contents/Info.plist

@@ -19,7 +19,7 @@
   <key>CFBundlePackageType</key>
   <string>APPL</string>
   <key>CFBundleShortVersionString</key>
-  <string>0.1.5</string>
+  <string>0.1.9</string>
   <key>CFBundleVersion</key>
   <string>1</string>
   <key>LSMinimumSystemVersion</key>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "open-computer-use",
-  "version": "0.1.5",
-  "description": "Prebuilt macOS Computer Use MCP server with Codex plugin installer.",
+  "version": "0.1.9",
+  "description": "Prebuilt macOS Computer Use MCP server. After install, run open-computer-use doctor.",
   "license": "MIT",
   "homepage": "https://github.com/iFurySt/open-codex-computer-use",
   "repository": {
@@ -45,6 +45,8 @@
     "plugins/open-computer-use/.mcp.json",
     "plugins/open-computer-use/assets/",
     "plugins/open-computer-use/scripts/",
+    "scripts/install-claude-mcp.sh",
+    "scripts/install-codex-mcp.sh",
     "scripts/install-codex-plugin.sh",
     "scripts/postinstall.mjs",
     "README.md",

package/plugins/open-computer-use/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "open-computer-use",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "description": "Open-source macOS Computer Use MCP server packaged as a Codex plugin.",
   "author": {
     "name": "Leo",

package/scripts/install-claude-mcp.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+claude_config_path="${CLAUDE_CONFIG_PATH:-${HOME}/.claude.json}"
+project_root="$(pwd -P)"
+server_name="open-computer-use"
+command_name="open-computer-use"
+
+usage() {
+  cat <<'EOF'
+Usage: ./scripts/install-claude-mcp.sh
+
+Install the open-computer-use stdio MCP entry into ~/.claude.json for the current project.
+The script is idempotent: if the same MCP server entry already exists, it leaves the file unchanged.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+python3 - "${claude_config_path}" "${project_root}" "${server_name}" "${command_name}" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+config_path = Path(sys.argv[1])
+project_root = sys.argv[2]
+server_name = sys.argv[3]
+command_name = sys.argv[4]
+desired_entry = {
+    "type": "stdio",
+    "command": command_name,
+    "args": ["mcp"],
+}
+legacy_server_name = "open-codex-computer-use"
+
+if config_path.exists():
+    try:
+        raw = config_path.read_text()
+        data = json.loads(raw) if raw.strip() else {}
+    except json.JSONDecodeError as exc:
+        print(f"Existing Claude config is not valid JSON: {exc}", file=sys.stderr)
+        sys.exit(1)
+else:
+    data = {}
+
+if not isinstance(data, dict):
+    print("Existing Claude config root is not a JSON object; refusing to modify it.", file=sys.stderr)
+    sys.exit(1)
+
+projects = data.setdefault("projects", {})
+if not isinstance(projects, dict):
+    print('Existing Claude config has non-object "projects"; refusing to modify it.', file=sys.stderr)
+    sys.exit(1)
+
+project_entry = projects.setdefault(project_root, {})
+if not isinstance(project_entry, dict):
+    print(f'Existing Claude project entry for {project_root} is not an object; refusing to modify it.', file=sys.stderr)
+    sys.exit(1)
+
+mcp_servers = project_entry.setdefault("mcpServers", {})
+if not isinstance(mcp_servers, dict):
+    print(f'Existing Claude project MCP config for {project_root} is not an object; refusing to modify it.', file=sys.stderr)
+    sys.exit(1)
+
+target = mcp_servers.get(server_name)
+legacy = mcp_servers.get(legacy_server_name)
+
+target_matches = target == desired_entry
+legacy_matches = legacy == desired_entry
+
+if target_matches and not legacy_matches:
+    print(f'Claude MCP server "{server_name}" is already installed for {project_root} in {config_path}.')
+    sys.exit(0)
+
+mcp_servers[server_name] = desired_entry
+
+if legacy_matches:
+    del mcp_servers[legacy_server_name]
+
+config_path.parent.mkdir(parents=True, exist_ok=True)
+config_path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n")
+
+if target_matches and legacy_matches:
+    print(f'Claude MCP server "{server_name}" was already installed for {project_root}; removed legacy alias "{legacy_server_name}" from {config_path}.')
+else:
+    print(f'Installed Claude MCP server "{server_name}" for {project_root} into {config_path}.')
+PY

package/scripts/install-codex-mcp.sh

@@ -0,0 +1,119 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+codex_home="${CODEX_HOME:-${HOME}/.codex}"
+config_path="${codex_home}/config.toml"
+server_name="open-computer-use"
+command_name="open-computer-use"
+
+usage() {
+  cat <<'EOF'
+Usage: ./scripts/install-codex-mcp.sh
+
+Install the open-computer-use stdio MCP entry into ~/.codex/config.toml.
+The script is idempotent: if the same MCP server entry already exists, it leaves the file unchanged.
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+mkdir -p "${codex_home}"
+
+python3 - "${config_path}" "${server_name}" "${command_name}" <<'PY'
+import json
+import re
+import sys
+from pathlib import Path
+
+try:
+    import tomllib
+except ModuleNotFoundError as exc:
+    print(f"python3 with tomllib is required: {exc}", file=sys.stderr)
+    sys.exit(1)
+
+
+def section_pattern(header: str) -> re.Pattern[str]:
+    return re.compile(rf'(?ms)^\[{re.escape(header)}\]\n.*?(?=^\[|\Z)')
+
+
+def remove_section(text: str, header: str) -> str:
+    return section_pattern(header).sub("", text)
+
+
+def upsert_section(text: str, header: str, body: str) -> str:
+    section = f'[{header}]\n{body.rstrip()}\n'
+    pattern = section_pattern(header)
+    if pattern.search(text):
+        return pattern.sub(section, text, count=1)
+
+    if text and not text.endswith("\n"):
+        text += "\n"
+    if text and not text.endswith("\n\n"):
+        text += "\n"
+    return text + section
+
+
+config_path = Path(sys.argv[1])
+server_name = sys.argv[2]
+command_name = sys.argv[3]
+desired_args = ["mcp"]
+legacy_server_name = "open-codex-computer-use"
+
+text = config_path.read_text() if config_path.exists() else ""
+
+try:
+    parsed = tomllib.loads(text) if text.strip() else {}
+except tomllib.TOMLDecodeError as exc:
+    print(f"Existing Codex config is not valid TOML: {exc}", file=sys.stderr)
+    sys.exit(1)
+
+mcp_servers = parsed.get("mcp_servers")
+if mcp_servers is not None and not isinstance(mcp_servers, dict):
+    print('Existing Codex config has non-table "mcp_servers"; refusing to modify it.', file=sys.stderr)
+    sys.exit(1)
+
+target = (mcp_servers or {}).get(server_name)
+legacy = (mcp_servers or {}).get(legacy_server_name)
+
+target_matches = (
+    isinstance(target, dict)
+    and target.get("command") == command_name
+    and target.get("args") == desired_args
+)
+legacy_matches = (
+    isinstance(legacy, dict)
+    and legacy.get("command") == command_name
+    and legacy.get("args") == desired_args
+)
+
+if target_matches and not legacy_matches:
+    print(f'Codex MCP server "{server_name}" is already installed in {config_path}.')
+    sys.exit(0)
+
+body = f'command = {json.dumps(command_name)}\nargs = {json.dumps(desired_args)}'
+text = upsert_section(text, f'mcp_servers."{server_name}"', body)
+
+if legacy_matches:
+    text = remove_section(text, f'mcp_servers."{legacy_server_name}"')
+
+text = re.sub(r"\n{3,}", "\n\n", text).rstrip() + "\n"
+config_path.write_text(text)
+
+if target_matches and legacy_matches:
+    print(f'Codex MCP server "{server_name}" was already installed; removed legacy alias "{legacy_server_name}" from {config_path}.')
+else:
+    print(f'Installed Codex MCP server "{server_name}" into {config_path}.')
+PY

package/scripts/postinstall.mjs

@@ -1,11 +1,27 @@
 #!/usr/bin/env node
+const mcpConfig = {
+  "mcpServers": {
+    "open-computer-use": {
+      "command": "open-computer-use",
+      "args": [
+        "mcp"
+      ]
+    }
+  }
+};
 const lines = [
   "",
-  "Installed open-computer-use.",
+  "Installed open-computer-use@0.1.9.",
+  "Package: https://www.npmjs.com/package/open-computer-use",
   "Commands: open-computer-use, open-computer-use-mcp, open-codex-computer-use-mcp",
-  "Start MCP: open-computer-use mcp",
-  "Grant permissions / diagnose: open-computer-use doctor",
-  "Install into Codex plugin cache: open-computer-use install-codex-plugin",
+  "",
+  "Next:",
+  "1. Run open-computer-use doctor",
+  "2. In macOS System Settings, grant Accessibility and Screen Recording to your host terminal or MCP client",
+  "3. Run open-computer-use install-claude-mcp for Claude Code, open-computer-use install-codex-mcp for Codex, or open-computer-use install-codex-plugin for the local plugin cache",
+  "",
+  "You can add this to any MCP-capable client:",
+  JSON.stringify(mcpConfig, null, 2),
   "",
 ];
 for (const line of lines) {