Skip to content

Computer Use 0.3.1 — macOS beta

Choose a tag to compare

@Hmbown Hmbown released this 13 Sep 22:02
· 147 commits to main since this release

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 passes codesign --verify --deep --strict, stapler validate, and Gatekeeper (spctl: Notarized Developer ID).
  • Disk image Codewhale-Computer-Use-0.3.1-macos-universal.dmg: SHA-256 91491faa6d44b8e4b52113fea1831c07c402fdd8f673323c8125468d0d89be3a (88,246,026 bytes), Developer ID signed, notarized (submission a24464ec-f3ed-4670-b873-fcacb8a1bef3) and stapled. It contains the same notarized app.
  • ZIP archive Codewhale-Computer-Use-0.3.1-macos-universal.zip: SHA-256 76752d33fff60d62b5445452e5a7f21396eb5aace6dbf632fc2a172f75e4720a (79,720,031 bytes). This is what Check for updates… installs. release.json and SHA256SUMS.txt cover 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.