Computer Use 0.4.0 — macOS beta

Codewhale Computer Use 0.4.0 adds the accessibility primitives a real messaging task was missing: Return/Enter from type, a filtered and paginated get_app_state, focus and get_value on observed elements, and an app click strategy that stays inside the bound app's window. The shared-desktop pointer gate is unchanged.

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.4.0) 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.1

• type treats newlines and press_enter as Return/Enter instead of inserting a literal character. key remains the named key-press tool.
• get_app_state filters (query, role), paginates (limit, offset) and truncates oversized dumps instead of eating the middle of the JSON; detail:"compact" is smaller. find_elements searches a cached state_id.
• focus and get_value act on observed elements; text-field values stay in the state dump.
• Accessibility clicks focus a field that exposes AXFocused even when it is not AXPressable.
• strategy:"app" allows a pointer event only when the point is inside the bound app's window, then restores the cursor. strategy:"event" still requires shared-desktop authorization.
• Coordinate targets accept space:"screen"; ocr_region limits OCR to a screen rect; run_actions batches up to 8 steps.
• Receipts no longer tell the model to use tools that are not in this catalog.

Verification

• Built from source commit 249ae77fad9162c2af11d5460d91b2b5b909c06c; every packaged plugin file is byte-identical to that commit.
• Developer ID signed with the hardened runtime. Apple accepted notarization submission 08f574c9-e4d7-4ff7-b7e1-431136fd4262; the stapled app passes codesign --verify --deep --strict, stapler validate, and Gatekeeper (spctl: Notarized Developer ID).
• Disk image Codewhale-Computer-Use-0.4.0-macos-universal.dmg: SHA-256 3ee12be851a9f7a2feb43fa55eea0abbd5ea9ffc83472b20ccb2d0dab7aae4d8 (88,254,027 bytes), Developer ID signed, notarized (submission 0416455e-1798-4397-b0d0-c9b1bf5cb8dd) and stapled. It contains the same notarized app.
• ZIP archive Codewhale-Computer-Use-0.4.0-macos-universal.zip: SHA-256 753565134e9fa36ac1435b64af0613d4df8195503bad56b93c80fdee0df6a637 (79,725,412 bytes). This is what Check for updates… installs. release.json and SHA256SUMS.txt cover both files.
• Source suite at that commit: 245 passed, 0 failed, 15 platform skips.

Beta scope. Qualification so far comes from one maintainer Mac. The new AX primitives are covered by the source suite; their native qualification on an installed build, 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.

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 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.