v1.4.1

What's in this release

Changed

• Agnes free models: Built-in catalog is now Agnes 3.0 Flash (chat), Agnes Image 2.5 Flash, and Agnes Video 2.5 Flash (720P, OpenAI Videos-compatible). Retired agnes-2.0-flash, agnes-image-2.1-flash, and agnes-video-v2.0; saved selections remap to the new ids.
• Clutch Agent reply style (D68): Default replies lead with the next action or the answer, skip preamble/closers, and state error cause + fix. Time estimates, <agent_status> recaps, and unsolicited images stay out of the default prompt; the full ADHD output skill remains optional via Skills / read_skill.

Fixed

• Windows CI delay test: Background-job sleep on windows-latest now uses ping -n instead of timeout /t (piped stdout made timeout fail immediately).

---

Install

macOS (Apple Silicon only):

curl -fsSL https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.sh | bash

Or Homebrew:

brew tap fancy1108/clutch
brew install --cask clutch

Windows:

irm https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.ps1 | iex

Or download *-setup.exe / *.msi from Assets on this page.

Full guide: docs/INSTALL.md · docs/PACKAGE_MANAGERS.md

Upgrade

Situation	Action
macOS v1.0.0 / v1.0.1	Install v1.0.2+ DMG manually once — older builds lack the in-app updater
macOS v1.0.2+	Follow the in-app update banner, or reinstall from Assets
Homebrew	brew upgrade --cask clutch
Windows	Download and run the new installer (no in-app updater yet)

Details: docs/UPDATES.md · docs/INSTALL.md §3

macOS: first launch (unsigned app)

Clutch is unsigned (no Apple notarization yet — see D31). Gatekeeper warnings are expected, not malware or a corrupt download.

You may see: “cannot verify developer”, “Clutch is damaged”, or double-click does nothing.

Fix (pick one):

1. Finder: Applications → right-click Clutch.app → Open → Open again.
2. Terminal (one-time): xattr -cr /Applications/Clutch.app && open -a Clutch

More: docs/INSTALL.md §2–§4 · docs/DATA_AND_PRIVACY.md

Windows

Windows 10/11 x64 MSI and NSIS (.exe) may appear under Assets (since v1.0.2).

Item	Note
CI	Built by GitHub Actions; pytest and packaging checks pass
Smoke test	Maintainers have not completed full manual smoke on physical Win10/11 (#23)
Code signing	None — SmartScreen may warn; verify SHA-256 and Release source first

Report issues: GitHub Issues (include installer filename and Windows version).

Verify download

Checksum (recommended):

shasum -a 256 -c SHA256SUMS.txt

(Run in the folder where you downloaded the DMG and SHA256SUMS.txt.)

After launch (~5 s):

curl -s http://127.0.0.1:8123/health

Expected: {"status":"ok"}