What's in this release
Patch release — Windows interactive PTY (#30), platform chrome split, and shared workspace UI polish. Thanks @996wuxian.
Added
- Windows Terminal Orchestra PTY: Interactive lanes on Windows via WinPTY backend (#30).
- Platform maintenance guide:
docs/PLATFORM_MAINTENANCE.md— macOS / Windows file boundaries and sharednavConfig.
Fixed
- General Settings font size: Restored preference UI, persistence, root
data-font-size, and customSettingsSelectdropdown (#30). - Windows
tauri:dev: Cross-platform dev launcher vianode scripts/run-tauri-dev.mjs(#30). - Chat workspace chrome: Unified compact chat layout and 30px right supervision panel gutter on macOS and Windows.
Changed
- Workspace chrome (Windows): Sidebar collapse on panel edge, icon-only collapsed rail (#30).
- Platform chrome split:
platform/chrome/*.{macos,windows}.tsx, sharednavConfig.ts,data-platformshell attribute; macOS keeps floating sidebar toggle and icon+label collapsed rail.
Install
macOS (Apple Silicon only):
curl -fsSL https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.sh | bashOr Homebrew:
brew tap fancy1108/clutch
brew install --cask clutchWindows:
irm https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.ps1 | iexOr 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):
- Finder: Applications → right-click
Clutch.app→ Open → Open again. - 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/healthExpected: {"status":"ok"}