Skip to content

v1.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 03 Jul 17:29
c4193a2

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

Fixed

  • General Settings font size: Restored preference UI, persistence, root data-font-size, and custom SettingsSelect dropdown (#30).
  • Windows tauri:dev: Cross-platform dev launcher via node 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, shared navConfig.ts, data-platform shell 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 | 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.appOpenOpen 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"}