open-computer-use-mcp 0.1.2

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "open-computer-use-local",
+  "interface": {
+    "displayName": "Open Computer Use Local"
+  },
+  "plugins": [
+    {
+      "name": "open-computer-use",
+      "source": {
+        "source": "local",
+        "path": "./plugins/open-computer-use"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# open-computer-use-mcp
+
+Prebuilt macOS npm distribution for the open-source **Open Computer Use** MCP server.
+
+This package bundles a ready-to-run `OpenComputerUse.app`, the Codex plugin metadata, and three global command aliases:
+
+- `open-computer-use`
+- `open-computer-use-mcp`
+- `open-codex-computer-use-mcp`
+
+## Install
+
+```bash
+npm install -g open-computer-use-mcp
+```
+
+## Use
+
+```bash
+open-computer-use doctor
+open-computer-use mcp
+open-computer-use install-codex-plugin
+```
+
+## Notes
+
+- Version: `0.1.2`
+- 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
+
+Source repository: https://github.com/iFurySt/open-codex-computer-use

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

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+app_binary="${package_root}/dist/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+install_script="${package_root}/scripts/install-codex-plugin.sh"
+
+if [[ "${1:-}" == "install-codex-plugin" ]]; then
+  shift
+  exec "${install_script}" "$@"
+fi
+
+if [[ ! -x "${app_binary}" ]]; then
+  echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
+  exit 1
+fi
+
+exec "${app_binary}" "$@"

package/bin/open-computer-use

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+app_binary="${package_root}/dist/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+install_script="${package_root}/scripts/install-codex-plugin.sh"
+
+if [[ "${1:-}" == "install-codex-plugin" ]]; then
+  shift
+  exec "${install_script}" "$@"
+fi
+
+if [[ ! -x "${app_binary}" ]]; then
+  echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
+  exit 1
+fi
+
+exec "${app_binary}" "$@"

package/bin/open-computer-use-mcp

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+app_binary="${package_root}/dist/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+install_script="${package_root}/scripts/install-codex-plugin.sh"
+
+if [[ "${1:-}" == "install-codex-plugin" ]]; then
+  shift
+  exec "${install_script}" "$@"
+fi
+
+if [[ ! -x "${app_binary}" ]]; then
+  echo "open-computer-use could not find a runnable app bundle at ${app_binary}." >&2
+  exit 1
+fi
+
+exec "${app_binary}" "$@"

package/dist/OpenComputerUse.app/Contents/Info.plist

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleDevelopmentRegion</key>
+  <string>en</string>
+  <key>CFBundleExecutable</key>
+  <string>OpenComputerUse</string>
+  <key>CFBundleIdentifier</key>
+  <string>dev.opencodex.OpenComputerUse</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>Open Computer Use</string>
+  <key>CFBundleDisplayName</key>
+  <string>Open Computer Use</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleShortVersionString</key>
+  <string>0.1.2</string>
+  <key>CFBundleVersion</key>
+  <string>16</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>14.0</string>
+  <key>LSUIElement</key>
+  <true/>
+  <key>NSPrincipalClass</key>
+  <string>NSApplication</string>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "open-computer-use-mcp",
+  "version": "0.1.2",
+  "description": "Prebuilt macOS Computer Use MCP server with Codex plugin installer.",
+  "license": "MIT",
+  "homepage": "https://github.com/iFurySt/open-codex-computer-use",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iFurySt/open-codex-computer-use.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iFurySt/open-codex-computer-use/issues"
+  },
+  "keywords": [
+    "computer-use",
+    "codex",
+    "mcp",
+    "macos",
+    "automation"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "open-computer-use": "./bin/open-computer-use",
+    "open-computer-use-mcp": "./bin/open-computer-use-mcp",
+    "open-codex-computer-use-mcp": "./bin/open-codex-computer-use-mcp"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs"
+  },
+  "files": [
+    ".agents/plugins/marketplace.json",
+    "bin/",
+    "dist/OpenComputerUse.app/",
+    "plugins/open-computer-use/.codex-plugin/",
+    "plugins/open-computer-use/.mcp.json",
+    "plugins/open-computer-use/assets/",
+    "plugins/open-computer-use/scripts/",
+    "scripts/install-codex-plugin.sh",
+    "scripts/postinstall.mjs",
+    "README.md",
+    "LICENSE"
+  ]
+}

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

@@ -0,0 +1,44 @@
+{
+  "name": "open-computer-use",
+  "version": "0.1.2",
+  "description": "Open-source macOS Computer Use MCP server packaged as a Codex plugin.",
+  "author": {
+    "name": "Leo",
+    "url": "https://github.com/iFurySt"
+  },
+  "homepage": "https://github.com/iFurySt/open-codex-computer-use",
+  "repository": "https://github.com/iFurySt/open-codex-computer-use",
+  "license": "MIT",
+  "keywords": [
+    "computer-use",
+    "macos",
+    "automation",
+    "mcp",
+    "codex"
+  ],
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Open Computer Use",
+    "shortDescription": "Control macOS apps from Codex with the open local server",
+    "longDescription": "Open Computer Use packages this repository's open-source macOS automation server as a Codex plugin. It exposes the same nine desktop-control MCP tools through the locally built OpenComputerUse app bundle, with an AX-first and keyboard-first strategy that tries to avoid stealing focus until global pointer input is truly required.",
+    "developerName": "Leo",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/iFurySt/open-codex-computer-use",
+    "privacyPolicyURL": "https://github.com/iFurySt/open-codex-computer-use/blob/main/SECURITY.md",
+    "termsOfServiceURL": "https://github.com/iFurySt/open-codex-computer-use/blob/main/LICENSE",
+    "defaultPrompt": [
+      "Inspect the current UI state of this Mac app without stealing focus when possible",
+      "Open a new local document with keyboard shortcuts first, then type content without moving my real pointer unless required",
+      "Drive the fixture app and verify the nine computer-use tools still behave correctly"
+    ],
+    "brandColor": "#0E7490",
+    "composerIcon": "./assets/open-computer-use-small.svg",
+    "logo": "./assets/open-computer-use.svg",
+    "screenshots": []
+  }
+}

package/plugins/open-computer-use/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "open-computer-use": {
+      "command": "./scripts/launch-open-computer-use.sh",
+      "cwd": "."
+    }
+  }
+}

package/plugins/open-computer-use/assets/open-computer-use-small.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Open Computer Use">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1FABFC"/>
+      <stop offset="100%" stop-color="#F0BDEF"/>
+    </linearGradient>
+  </defs>
+  <rect x="0" y="0" width="64" height="64" fill="url(#bg)"/>
+  <g transform="translate(-5.9259 -5.9259) scale(1.1851852)">
+    <path d="M18.5 39A18.5 18.5 0 0 1 45.5 22" fill="none" stroke="#FFFFFF" stroke-opacity="0.72" stroke-width="3" stroke-linecap="round"/>
+    <path d="M32.25 25.5L32.25 45.25L37.25 40.5L40.25 48.25L44 46.5L41 39.25L48 38Z" fill="#FFFFFF" fill-opacity="0.14"/>
+    <path d="M31.5 24.5L31.5 44.25L36.5 39.5L39.5 47.25L43.25 45.5L40.25 38.25L47.25 37Z" fill="#FFFFFF" fill-opacity="0.94" stroke="#FFFFFF" stroke-width="1.5" stroke-linejoin="round"/>
+  </g>
+</svg>

package/plugins/open-computer-use/assets/open-computer-use.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" role="img" aria-label="Open Computer Use">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1FABFC"/>
+      <stop offset="100%" stop-color="#F0BDEF"/>
+    </linearGradient>
+  </defs>
+  <rect x="0" y="0" width="256" height="256" fill="url(#bg)"/>
+  <g transform="translate(-23.7037 -23.7037) scale(1.1851852)">
+    <path d="M74 156A74 74 0 0 1 182 88" fill="none" stroke="#FFFFFF" stroke-opacity="0.72" stroke-width="12" stroke-linecap="round"/>
+    <path d="M129 102L129 181L149 162L161 193L176 186L164 157L192 152Z" fill="#FFFFFF" fill-opacity="0.14"/>
+    <path d="M126 98L126 177L146 158L158 189L173 182L161 153L189 148Z" fill="#FFFFFF" fill-opacity="0.94" stroke="#FFFFFF" stroke-width="6" stroke-linejoin="round"/>
+  </g>
+</svg>

package/plugins/open-computer-use/scripts/launch-open-computer-use.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+plugin_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+bundled_app_binary="${plugin_root}/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+repo_root="$(cd "${plugin_root}/../.." && pwd)"
+repo_app_binary="${repo_root}/dist/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+
+if [[ -x "${bundled_app_binary}" ]]; then
+  cd "${plugin_root}"
+  exec "${bundled_app_binary}" mcp
+fi
+
+if [[ -x "${repo_app_binary}" ]]; then
+  cd "${repo_root}"
+  exec "${repo_app_binary}" mcp
+fi
+
+echo "open-computer-use could not find a runnable app bundle." >&2
+echo "Checked:" >&2
+echo "  - ${bundled_app_binary}" >&2
+echo "  - ${repo_app_binary}" >&2
+echo "Run ./scripts/install-codex-plugin.sh to populate the Codex plugin cache." >&2
+exit 1

package/scripts/install-codex-plugin.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+repo_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+codex_home="${CODEX_HOME:-${HOME}/.codex}"
+config_path="${codex_home}/config.toml"
+marketplace_name="open-computer-use-local"
+plugin_name="open-computer-use"
+plugin_source_root="${repo_root}/plugins/${plugin_name}"
+plugin_manifest="${plugin_source_root}/.codex-plugin/plugin.json"
+build_script="${repo_root}/scripts/build-open-computer-use-app.sh"
+configuration="debug"
+rebuild="false"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --rebuild)
+      rebuild="true"
+      shift
+      ;;
+    --configuration)
+      configuration="${2:-}"
+      if [[ -z "${configuration}" ]]; then
+        echo "--configuration requires a value" >&2
+        exit 1
+      fi
+      shift 2
+      ;;
+    *)
+      echo "Unknown argument: $1" >&2
+      echo "Usage: $0 [--rebuild] [--configuration debug|release]" >&2
+      exit 1
+      ;;
+  esac
+done
+
+app_binary="${repo_root}/dist/OpenComputerUse.app/Contents/MacOS/OpenComputerUse"
+
+if [[ "${rebuild}" == "true" || ! -x "${app_binary}" ]]; then
+  if [[ -x "${build_script}" ]]; then
+    "${build_script}" "${configuration}"
+  else
+    echo "Missing runnable app bundle at ${app_binary} and no local build script is available." >&2
+    exit 1
+  fi
+fi
+
+if [[ ! -f "${repo_root}/.agents/plugins/marketplace.json" ]]; then
+  echo "Missing ${repo_root}/.agents/plugins/marketplace.json" >&2
+  exit 1
+fi
+
+if [[ ! -f "${plugin_manifest}" ]]; then
+  echo "Missing ${plugin_manifest}" >&2
+  exit 1
+fi
+
+if [[ ! -x "${app_binary}" ]]; then
+  echo "Missing runnable app binary at ${app_binary}" >&2
+  exit 1
+fi
+
+plugin_version="$(
+  python3 - "${plugin_manifest}" <<'PY'
+import json
+import sys
+
+with open(sys.argv[1], "r", encoding="utf-8") as fh:
+    manifest = json.load(fh)
+
+print(manifest["version"])
+PY
+)"
+
+if [[ -z "${plugin_version}" ]]; then
+  echo "Failed to read plugin version from ${plugin_manifest}" >&2
+  exit 1
+fi
+
+plugin_cache_root="${codex_home}/plugins/cache/${marketplace_name}/${plugin_name}"
+plugin_install_root="${plugin_cache_root}/${plugin_version}"
+
+mkdir -p "${codex_home}" "${plugin_cache_root}"
+rm -rf "${plugin_install_root}"
+mkdir -p "${plugin_install_root}"
+
+rsync -a "${plugin_source_root}/" "${plugin_install_root}/"
+rsync -a "${repo_root}/dist/OpenComputerUse.app" "${plugin_install_root}/"
+
+python3 - "${config_path}" "${repo_root}" "${marketplace_name}" "${plugin_name}" <<'PY'
+import json
+import re
+import sys
+from pathlib import Path
+
+
+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])
+repo_root = Path(sys.argv[2]).resolve()
+marketplace_name = sys.argv[3]
+plugin_name = sys.argv[4]
+
+text = config_path.read_text() if config_path.exists() else ""
+
+for header in (
+    'mcp_servers."open-codex-computer-use"',
+    'mcp_servers."open-computer-use"',
+):
+    text = remove_section(text, header)
+
+text = upsert_section(
+    text,
+    f"marketplaces.{marketplace_name}",
+    f'source_type = "local"\nsource = {json.dumps(str(repo_root))}',
+)
+text = upsert_section(
+    text,
+    f'plugins."{plugin_name}@{marketplace_name}"',
+    "enabled = true",
+)
+
+text = re.sub(r"\n{3,}", "\n\n", text).rstrip() + "\n"
+config_path.write_text(text)
+PY
+
+echo "Installed ${plugin_name}@${marketplace_name}"
+echo "Marketplace source: ${repo_root}"
+echo "Plugin cache: ${plugin_install_root}"
+echo "Updated Codex config: ${config_path}"
+echo "Restart Codex to load the plugin marketplace."

package/scripts/postinstall.mjs

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+const lines = [
+  "",
+  "Installed open-computer-use-mcp.",
+  "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",
+  "",
+];
+for (const line of lines) {
+  console.log(line);
+}