openowl 0.3.1

package/README.md

@@ -0,0 +1,42 @@
+# OpenOwl
+
+AI desktop automation MCP server — give your AI eyes and hands.
+
+## Install
+
+```bash
+npm install -g openowl
+```
+
+Or use directly with npx:
+
+```bash
+npx openowl
+```
+
+## Setup
+
+1. Sign up at [openowl-portal.vercel.app/quick-setup](https://openowl-portal.vercel.app/quick-setup)
+2. Save your API key:
+   ```bash
+   mkdir -p ~/.openowl
+   echo "owl-xxxx-xxxx-xxxx" > ~/.openowl/api.key
+   ```
+3. Register with Claude Code:
+   ```bash
+   claude mcp add owl --transport stdio -s user -- owl
+   ```
+
+## What it does
+
+OpenOwl gives AI assistants the ability to see your screen and interact with desktop applications — clicking, typing, scrolling, reading text, and more.
+
+## Requirements
+
+- macOS (Apple Silicon or Intel)
+- Grant Accessibility and Screen Recording permissions when prompted
+
+## Links
+
+- [Quick Setup](https://openowl-portal.vercel.app/quick-setup)
+- [GitHub](https://github.com/mihir-kanzariya/OpenOwl)

package/bin/owl

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const path = require("path");
+const { spawn } = require("child_process");
+const fs = require("fs");
+
+const BINARIES = {
+  "darwin-arm64": "owl-darwin-arm64",
+  "darwin-x64": "owl-darwin-x86_64",
+  // "win32-x64": "owl-win32-x64.exe",
+};
+
+const platformKey = `${os.platform()}-${os.arch()}`;
+const binaryName = BINARIES[platformKey];
+
+if (!binaryName) {
+  console.error(`[OpenOwl] Unsupported platform: ${platformKey}`);
+  process.exit(1);
+}
+
+const installDir = path.join(__dirname, "..", ".owl");
+const binaryPath = path.join(installDir, binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error("[OpenOwl] Binary not found. Run: npm rebuild openowl");
+  process.exit(1);
+}
+
+// Spawn with inherited stdio — critical for MCP stdio transport
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("exit", (code) => process.exit(code || 0));
+child.on("error", (err) => {
+  console.error(`[OpenOwl] ${err.message}`);
+  process.exit(1);
+});

package/install.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const http = require("http");
+const { execSync } = require("child_process");
+
+const VERSION = "0.3.1";
+const BASE_URL =
+  "https://dedjlsvrwafhyznaazbm.supabase.co/storage/v1/object/public/releases";
+
+const PLATFORMS = {
+  "darwin-arm64": {
+    url: `${BASE_URL}/v${VERSION}/owl-darwin-arm64.tar.gz`,
+    binary: "owl-darwin-arm64",
+  },
+  "darwin-x64": {
+    url: `${BASE_URL}/v${VERSION}/owl-darwin-x64.tar.gz`,
+    binary: "owl-darwin-x86_64",
+  },
+  // "win32-x64": {
+  //   url: `${BASE_URL}/v${VERSION}/owl-win32-x64.zip`,
+  //   binary: "owl-win32-x64.exe",
+  // },
+};
+
+function getPlatformKey() {
+  const platform = os.platform();
+  const arch = os.arch();
+  return `${platform}-${arch}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const get = url.startsWith("https") ? https.get : http.get;
+    get(url, (res) => {
+      // Follow redirects
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve).catch(reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+      }
+      const chunks = [];
+      res.on("data", (chunk) => chunks.push(chunk));
+      res.on("end", () => resolve(Buffer.concat(chunks)));
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+async function install() {
+  const platformKey = getPlatformKey();
+  const info = PLATFORMS[platformKey];
+
+  if (!info) {
+    console.error(`[OpenOwl] Unsupported platform: ${platformKey}`);
+    console.error(`[OpenOwl] Supported: ${Object.keys(PLATFORMS).join(", ")}`);
+    process.exit(1);
+  }
+
+  const binDir = path.join(__dirname, "bin");
+  const installDir = path.join(__dirname, ".owl");
+
+  // Skip if already installed
+  const binaryPath = path.join(installDir, info.binary);
+  if (fs.existsSync(binaryPath)) {
+    console.log("[OpenOwl] Already installed.");
+    return;
+  }
+
+  console.log(`[OpenOwl] Downloading for ${platformKey}...`);
+
+  try {
+    const tarball = await download(info.url);
+
+    // Write tarball to temp file
+    const tmpFile = path.join(os.tmpdir(), `owl-${VERSION}.tar.gz`);
+    fs.writeFileSync(tmpFile, tarball);
+
+    // Extract
+    fs.mkdirSync(installDir, { recursive: true });
+    execSync(`tar -xzf "${tmpFile}" -C "${installDir}"`, { stdio: "pipe" });
+    fs.unlinkSync(tmpFile);
+
+    // Make binary executable
+    if (fs.existsSync(binaryPath)) {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`[OpenOwl] Installed successfully (${(tarball.length / 1024 / 1024).toFixed(1)} MB)`);
+  } catch (err) {
+    console.error(`[OpenOwl] Installation failed: ${err.message}`);
+    console.error("[OpenOwl] Try: brew install mihir-kanzariya/owl/owl");
+    process.exit(1);
+  }
+}
+
+install();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "openowl",
+  "version": "0.3.1",
+  "description": "AI desktop automation MCP server — give your AI eyes and hands",
+  "homepage": "https://openowl-portal.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mihir-kanzariya/OpenOwl"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "owl": "bin/owl"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "keywords": [
+    "mcp",
+    "automation",
+    "desktop",
+    "screen",
+    "claude",
+    "ai",
+    "accessibility",
+    "screenshot",
+    "openowl"
+  ],
+  "os": [
+    "darwin",
+    "win32"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "install.js",
+    "bin/owl",
+    "bin/owl.cmd",
+    "README.md"
+  ]
+}