open-computer-use-mcp 0.1.5 → 0.1.6

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-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.
+
 ## MCP config
 
 If your MCP client accepts a stdio-style `mcpServers` JSON config, this is the default setup:
@@ -31,10 +33,17 @@ 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-mcp
+
 ## 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
+
+# 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 +55,7 @@ open-computer-use install-codex-plugin
 
 ## Notes
 
-- Version: `0.1.5`
+- Version: `0.1.6`
 - 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,34 @@
 #!/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-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)"
@@ -18,6 +46,26 @@ if [[ "${1:-}" == "install-codex-plugin" ]]; then
   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 [[ ! -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,34 @@
 #!/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-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)"
@@ -18,6 +46,26 @@ if [[ "${1:-}" == "install-codex-plugin" ]]; then
   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 [[ ! -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,34 @@
 #!/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-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)"
@@ -18,6 +46,26 @@ if [[ "${1:-}" == "install-codex-plugin" ]]; then
   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 [[ ! -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.6</string>
   <key>CFBundleVersion</key>
   <string>1</string>
   <key>LSMinimumSystemVersion</key>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "open-computer-use-mcp",
-  "version": "0.1.5",
-  "description": "Prebuilt macOS Computer Use MCP server with Codex plugin installer.",
+  "version": "0.1.6",
+  "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": {

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

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

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-mcp.",
+  "Installed open-computer-use-mcp@0.1.6.",
+  "Package: https://www.npmjs.com/package/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",
+  "",
+  "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. Start the MCP server with open-computer-use mcp, or install into Codex with open-computer-use install-codex-plugin",
+  "",
+  "You can add this to any MCP-capable client:",
+  JSON.stringify(mcpConfig, null, 2),
   "",
 ];
 for (const line of lines) {