Repository navigation
Computer Use 0.3.1 — macOS beta
Codewhale Computer Use 0.3.1 is the first public macOS build: a notarized Mac helper with a native setup panel, whale menu-bar icon, and visible Pause and Stop controls. It operates supported app controls in the background and only takes the foreground for actions that require it.
Install. Download the disk image, open it, and drag Codewhale Computer Use into Applications. Open it once from Applications. The setup panel walks through Accessibility and Screen Recording permissions. Apple silicon and Intel Macs on macOS 13.5 or later are supported; Node 24.21.0 is bundled, so no separate Node install or compiler is needed.
- Download and setup guide: https://codewhale.net/computer-use
- Connect it in Codewhale's plugin marketplace (Computer Use 0.3.x) so local actions go through the helper's Pause and Stop controls.
- Updates: choose Check for updates… in the app. Before installing, it verifies the archive digest, the Codewhale signing identity and the notarized Developer ID verdict, and keeps the previous app for recovery.
What changed since 0.3.0
- The helper retires when its menu-bar owner disconnects, so reopening the app restores the human controls with input still stopped.
- A replacement helper's socket and run receipt survive old-session cleanup.
- The result of an update is shown after relaunch, including failed installs.
- MCP hosts receive the manifest version, and a missing registered app is explained with a repair path instead of being bypassed.
- Public plugin host eligibility is limited to macOS. Windows and Linux stay experimental, source-only backends.
Verification
- Built from source commit
9f6c39f738c0d8e8dcc93af11af5e00d19081b60; every packaged plugin file is byte-identical to that commit. - Developer ID signed with the hardened runtime. Apple accepted notarization submission
769ff14d-ee5c-4db5-a3b9-f733c2743e6e; the stapled app passescodesign --verify --deep --strict,stapler validate, and Gatekeeper (spctl: Notarized Developer ID). - Disk image
Codewhale-Computer-Use-0.3.1-macos-universal.dmg: SHA-25691491faa6d44b8e4b52113fea1831c07c402fdd8f673323c8125468d0d89be3a(88,246,026 bytes), Developer ID signed, notarized (submissiona24464ec-f3ed-4670-b873-fcacb8a1bef3) and stapled. It contains the same notarized app. - ZIP archive
Codewhale-Computer-Use-0.3.1-macos-universal.zip: SHA-25676752d33fff60d62b5445452e5a7f21396eb5aace6dbf632fc2a172f75e4720a(79,720,031 bytes). This is what Check for updates… installs.release.jsonandSHA256SUMS.txtcover both files. - Source suite at that commit: 240 passed, 0 failed, 15 platform skips.
Beta scope. Qualification so far comes from one maintainer Mac. A clean-machine first install with fresh permission grants, a model-driven task through an installed Codewhale Engine, and the non-admin Applications-folder update path are still being gathered as public evidence; please report anything you hit at https://github.com/Hmbown/codewhale-cu-plugin/issues. This release is the Mac helper only; it does not change the separate Codewhale Engine release.