openowl 0.3.19 → 0.3.21

package/README.md

@@ -1,6 +1,6 @@
 # OpenOwl
 
-AI desktop automation MCP server — give your AI eyes and hands.
+AI desktop automation MCP server — give your AI assistant eyes and hands on your screen.
 
 ## Install
 
@@ -8,50 +8,77 @@ AI desktop automation MCP server — give your AI eyes and hands.
 npm install -g openowl
 ```
 
-Or use directly with npx:
-
-```bash
-npx openowl
-```
-
 ## Setup
 
-1. Sign up at [openowl.dev/quick-setup](https://openowl.dev/quick-setup)
+1. Sign up at [openowl.dev/quick-setup](https://openowl.dev/quick-setup) to get your API key
 2. Save your API key:
 
-   **macOS / Linux:**
    ```bash
    mkdir -p ~/.openowl
    echo "owl-xxxx-xxxx-xxxx" > ~/.openowl/api.key
    ```
 
-   **Windows (PowerShell):**
-   ```powershell
-   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.openowl"
-   "owl-xxxx-xxxx-xxxx" | Out-File "$env:USERPROFILE\.openowl\api.key" -Encoding utf8
-   ```
+3. Register with your AI assistant:
 
-3. Register with Claude Code:
+   **Claude Code:**
    ```bash
    claude mcp add owl --transport stdio -s user -- owl
    ```
 
+   **Codex CLI:** Add to `~/.codex/config.toml`:
+   ```toml
+   [mcp_servers.owl]
+   command = "owl"
+   ```
+
+4. Verify:
+   ```bash
+   owl --version
+   ```
+
 ## 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.
+OpenOwl lets AI assistants operate your entire desktop — any app, any button, any workflow. Describe what you need in plain English, OpenOwl handles the clicking, typing, scrolling, and navigation.
+
+Works with Claude Code, Codex CLI, Cursor, and any MCP-compatible AI.
 
 ## Supported platforms
 
-- macOS 10.9+ (Apple Silicon and Intel — Mavericks through Sequoia)
-- Windows 10/11 (x64)
+- macOS 11+ (Apple Silicon and Intel)
 
 ## Requirements
 
-**macOS:** Grant Accessibility and Screen Recording permissions when prompted.
+- Node.js 16+
+- macOS: Grant Accessibility and Screen Recording permissions when prompted (System Settings > Privacy & Security)
+
+## Free tier
+
+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
 
-**Windows:** Windows 10+. Run as Administrator for full desktop control. Python 3.10+ is installed automatically in a local venv on first run.
+**Permissions required on macOS:**
+- Accessibility (System Settings > Privacy & Security) — for keyboard/mouse control
+- Screen Recording (System Settings > Privacy & Security) — for screenshots
 
 ## Links
 
-- [Quick Setup](https://openowl.dev/quick-setup)
-- [GitHub](https://github.com/mihir-kanzariya/OpenOwl)
+- [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.19";
+const VERSION = "0.3.20";
 if (process.argv[2] === "--version" || process.argv[2] === "-v") {
   console.log(`OpenOwl v${VERSION}`);
   process.exit(0);

package/install.js

@@ -9,7 +9,7 @@ const http = require("http");
 const { execSync } = require("child_process");
 const zlib = require("zlib");
 
-const VERSION = "0.3.19";
+const VERSION = "0.3.20";
 const BASE_URL =
   `https://github.com/mihir-kanzariya/openowl-releases/releases/download/v${VERSION}`;
 

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "openowl",
-  "version": "0.3.19",
-  "description": "AI desktop automation MCP server — give your AI eyes and hands",
+  "version": "0.3.21",
+  "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"
   },