open-computer-use 0.1.4 → 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
 ```
 
+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:
@@ -29,28 +31,19 @@ If your MCP client accepts a stdio-style `mcpServers` JSON config, this is the d
 }
 ```
 
-If you want the server without the visual cursor overlay:
-
-```json
-{
-  "mcpServers": {
-    "open-computer-use": {
-      "command": "open-computer-use",
-      "args": ["mcp"],
-      "env": {
-        "OPEN_COMPUTER_USE_VISUAL_CURSOR": "0"
-      }
-    }
-  }
-}
-```
-
 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 and diagnose whether Accessibility / Screen Recording are granted
+# 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
@@ -62,7 +55,7 @@ open-computer-use install-codex-plugin
 
 ## Notes
 
-- Version: `0.1.4`
+- 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,9 +19,9 @@
   <key>CFBundlePackageType</key>
   <string>APPL</string>
   <key>CFBundleShortVersionString</key>
-  <string>0.1.4</string>
+  <string>0.1.6</string>
   <key>CFBundleVersion</key>
-  <string>17</string>
+  <string>1</string>
   <key>LSMinimumSystemVersion</key>
   <string>14.0</string>
   <key>LSUIElement</key>

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "open-computer-use",
-  "version": "0.1.4",
-  "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": {
     "type": "git",
-    "url": "git+https://github.com/iFurySt/open-codex-computer-use.git"
+    "url": "https://github.com/iFurySt/open-codex-computer-use"
   },
   "bugs": {
     "url": "https://github.com/iFurySt/open-codex-computer-use/issues"

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

@@ -1,6 +1,6 @@
 {
   "name": "open-computer-use",
-  "version": "0.1.4",
+  "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.",
+  "Installed open-computer-use@0.1.6.",
+  "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. 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) {