openowl 0.3.20 → 0.3.22

package/README.md

@@ -55,8 +55,30 @@ Works with Claude Code, Codex CLI, Cursor, and any MCP-compatible AI.
 
 50 tool calls/day, no credit card required. Upgrade at [openowl.dev/pricing](https://openowl.dev/pricing).
 
+## How it works
+
+OpenOwl is a compiled Python MCP server distributed as a native binary. The npm `postinstall` script downloads the prebuilt binary for your platform from [GitHub Releases](https://github.com/mihir-kanzariya/openowl-releases/releases) (public repo). The source code is at [github.com/mihir-kanzariya/OpenOwl](https://github.com/mihir-kanzariya/OpenOwl).
+
+**What the binary does:**
+- Captures screenshots via macOS native APIs (mss, Quartz)
+- Sends keyboard/mouse input via PyAutoGUI
+- Reads UI elements via the macOS Accessibility API
+- Runs OCR via macOS Vision framework
+- All processing happens locally on your machine
+
+**Data collected (for usage metering only):**
+- A hashed machine ID (SHA-256 of MAC address + hostname) to enforce per-device license limits
+- Tool call counts sent to `openowl.dev/api/v1/usage/check` to enforce free-tier daily limits (50 calls/day)
+- No screenshots, screen content, keystrokes, or personal data are ever sent to our servers
+
+**Permissions required on macOS:**
+- Accessibility (System Settings > Privacy & Security) — for keyboard/mouse control
+- Screen Recording (System Settings > Privacy & Security) — for screenshots
+
 ## Links
 
 - [Quick Setup Guide](https://openowl.dev/quick-setup)
 - [Pricing](https://openowl.dev/pricing)
 - [Dashboard](https://openowl.dev/dashboard)
+- [Source Code](https://github.com/mihir-kanzariya/OpenOwl)
+- [Binary Releases](https://github.com/mihir-kanzariya/openowl-releases/releases)

package/bin/owl

@@ -18,7 +18,7 @@ const crypto = require("crypto");
 const { spawn } = require("child_process");
 
 // ── Version check ──────────────────────────────────────────────
-const VERSION = "0.3.20";
+const VERSION = "0.3.22";
 if (process.argv[2] === "--version" || process.argv[2] === "-v") {
   console.log(`OpenOwl v${VERSION}`);
   process.exit(0);
@@ -28,7 +28,6 @@ if (process.argv[2] === "--version" || process.argv[2] === "-v") {
 const BINARIES = {
   "darwin-arm64": "owl-darwin-arm64",
   "darwin-x64": "owl-darwin-x86_64",
-  "win32-x64": "owl-windows-x86_64.exe",
 };
 
 const platformKey = `${os.platform()}-${os.arch()}`;

package/install.js

@@ -7,9 +7,8 @@ const path = require("path");
 const https = require("https");
 const http = require("http");
 const { execSync } = require("child_process");
-const zlib = require("zlib");
 
-const VERSION = "0.3.20";
+const VERSION = "0.3.22";
 const BASE_URL =
   `https://github.com/mihir-kanzariya/openowl-releases/releases/download/v${VERSION}`;
 
@@ -22,11 +21,6 @@ const PLATFORMS = {
     url: `${BASE_URL}/owl-darwin-x64.tar.gz`,
     binary: "owl-darwin-x86_64",
   },
-  "win32-x64": {
-    url: `${BASE_URL}/owl-win32-x64.zip`,
-    binary: "owl-windows-x86_64.exe",
-    isZip: true,
-  },
 };
 
 function getPlatformKey() {
@@ -54,43 +48,6 @@ function download(url) {
   });
 }
 
-/**
- * Extract a zip file using pure Node.js (no PowerShell dependency).
- */
-function extractZip(zipBuffer, destDir) {
-  let offset = 0;
-  while (offset < zipBuffer.length - 4) {
-    const sig = zipBuffer.readUInt32LE(offset);
-    if (sig !== 0x04034b50) break;
-
-    const compressionMethod = zipBuffer.readUInt16LE(offset + 8);
-    const compressedSize = zipBuffer.readUInt32LE(offset + 18);
-    const nameLen = zipBuffer.readUInt16LE(offset + 26);
-    const extraLen = zipBuffer.readUInt16LE(offset + 28);
-    const nameStart = offset + 30;
-    const fileName = zipBuffer.toString("utf8", nameStart, nameStart + nameLen);
-    const dataStart = nameStart + nameLen + extraLen;
-
-    const destPath = path.join(destDir, fileName);
-
-    if (fileName.endsWith("/")) {
-      fs.mkdirSync(destPath, { recursive: true });
-    } else {
-      fs.mkdirSync(path.dirname(destPath), { recursive: true });
-      const rawData = zipBuffer.slice(dataStart, dataStart + compressedSize);
-
-      if (compressionMethod === 0) {
-        fs.writeFileSync(destPath, rawData);
-      } else if (compressionMethod === 8) {
-        const inflated = zlib.inflateRawSync(rawData);
-        fs.writeFileSync(destPath, inflated);
-      }
-    }
-
-    offset = dataStart + compressedSize;
-  }
-}
-
 async function install() {
   const platformKey = getPlatformKey();
   const info = PLATFORMS[platformKey];
@@ -122,19 +79,13 @@ async function install() {
 
     fs.mkdirSync(installDir, { recursive: true });
 
-    if (info.isZip) {
-      // Pure Node.js zip extraction — no PowerShell needed
-      extractZip(archive, installDir);
-    } else {
-      // macOS/Linux: use tar
-      const tmpFile = path.join(os.tmpdir(), `owl-${VERSION}.tar.gz`);
-      fs.writeFileSync(tmpFile, archive);
-      execSync(`tar -xzf "${tmpFile}" -C "${installDir}"`, { stdio: "pipe" });
-      fs.unlinkSync(tmpFile);
-    }
+    const tmpFile = path.join(os.tmpdir(), `owl-${VERSION}.tar.gz`);
+    fs.writeFileSync(tmpFile, archive);
+    execSync(`tar -xzf "${tmpFile}" -C "${installDir}"`, { stdio: "pipe" });
+    fs.unlinkSync(tmpFile);
 
-    // Make binary executable (no-op on Windows)
-    if (fs.existsSync(binaryPath) && os.platform() !== "win32") {
+    // Make binary executable
+    if (fs.existsSync(binaryPath)) {
       fs.chmodSync(binaryPath, 0o755);
     }
 
@@ -144,11 +95,7 @@ async function install() {
     console.log(`[OpenOwl] Installed v${VERSION} successfully (${(archive.length / 1024 / 1024).toFixed(1)} MB)`);
   } catch (err) {
     console.error(`[OpenOwl] Installation failed: ${err.message}`);
-    if (os.platform() === "win32") {
-      console.error("[OpenOwl] Try downloading manually from: https://openowl.dev/quick-setup");
-    } else {
-      console.error("[OpenOwl] Try: brew install owl");
-    }
+    console.error("[OpenOwl] Try: brew install mihir-kanzariya/owl/owl");
     process.exit(1);
   }
 }

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "openowl",
-  "version": "0.3.20",
-  "description": "AI desktop automation MCP server — give your AI eyes and hands",
+  "version": "0.3.22",
+  "description": "AI desktop automation MCP server — give your AI eyes and hands. Screen capture, clicking, typing, OCR, window management via MCP protocol.",
   "homepage": "https://openowl.dev",
+  "author": "Mihir Kanzariya <kanzariyamihir@gmail.com> (https://openowl.dev)",
   "repository": {
     "type": "git",
     "url": "https://github.com/mihir-kanzariya/OpenOwl"
   },
-  "license": "SEE LICENSE IN LICENSE",
+  "bugs": {
+    "url": "https://github.com/mihir-kanzariya/OpenOwl/issues"
+  },
+  "license": "BUSL-1.1",
   "bin": {
     "owl": "bin/owl"
   },
@@ -26,8 +30,7 @@
     "openowl"
   ],
   "os": [
-    "darwin",
-    "win32"
+    "darwin"
   ],
   "engines": {
     "node": ">=16"
@@ -35,7 +38,6 @@
   "files": [
     "install.js",
     "bin/owl",
-    "bin/owl.cmd",
     "README.md"
   ]
 }

package/bin/owl.cmd

@@ -1,2 +0,0 @@
-@echo off
-node "%~dp0\owl" %*