openowl 0.3.20 → 0.3.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +22 -0
  2. package/package.json +7 -3
package/README.md CHANGED
@@ -55,8 +55,30 @@ Works with Claude Code, Codex CLI, Cursor, and any MCP-compatible AI.
55
55
 
56
56
  50 tool calls/day, no credit card required. Upgrade at [openowl.dev/pricing](https://openowl.dev/pricing).
57
57
 
58
+ ## How it works
59
+
60
+ 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).
61
+
62
+ **What the binary does:**
63
+ - Captures screenshots via macOS native APIs (mss, Quartz)
64
+ - Sends keyboard/mouse input via PyAutoGUI
65
+ - Reads UI elements via the macOS Accessibility API
66
+ - Runs OCR via macOS Vision framework
67
+ - All processing happens locally on your machine
68
+
69
+ **Data collected (for usage metering only):**
70
+ - A hashed machine ID (SHA-256 of MAC address + hostname) to enforce per-device license limits
71
+ - Tool call counts sent to `openowl.dev/api/v1/usage/check` to enforce free-tier daily limits (50 calls/day)
72
+ - No screenshots, screen content, keystrokes, or personal data are ever sent to our servers
73
+
74
+ **Permissions required on macOS:**
75
+ - Accessibility (System Settings > Privacy & Security) — for keyboard/mouse control
76
+ - Screen Recording (System Settings > Privacy & Security) — for screenshots
77
+
58
78
  ## Links
59
79
 
60
80
  - [Quick Setup Guide](https://openowl.dev/quick-setup)
61
81
  - [Pricing](https://openowl.dev/pricing)
62
82
  - [Dashboard](https://openowl.dev/dashboard)
83
+ - [Source Code](https://github.com/mihir-kanzariya/OpenOwl)
84
+ - [Binary Releases](https://github.com/mihir-kanzariya/openowl-releases/releases)
package/package.json CHANGED
@@ -1,13 +1,17 @@
1
1
  {
2
2
  "name": "openowl",
3
- "version": "0.3.20",
4
- "description": "AI desktop automation MCP server — give your AI eyes and hands",
3
+ "version": "0.3.21",
4
+ "description": "AI desktop automation MCP server — give your AI eyes and hands. Screen capture, clicking, typing, OCR, window management via MCP protocol.",
5
5
  "homepage": "https://openowl.dev",
6
+ "author": "Mihir Kanzariya <kanzariyamihir@gmail.com> (https://openowl.dev)",
6
7
  "repository": {
7
8
  "type": "git",
8
9
  "url": "https://github.com/mihir-kanzariya/OpenOwl"
9
10
  },
10
- "license": "SEE LICENSE IN LICENSE",
11
+ "bugs": {
12
+ "url": "https://github.com/mihir-kanzariya/OpenOwl/issues"
13
+ },
14
+ "license": "BUSL-1.1",
11
15
  "bin": {
12
16
  "owl": "bin/owl"
13
17
  },