Clutch

Local AI multi-agent orchestration & supervision — on your desktop.

English · 简体中文 · Website · Getting Started · Releases

[!TIP] New here? Read the Getting Started Guide — install, first-launch wizard, and your first chat in ~5 minutes. No dev setup required.

Clutch is a desktop app (Tauri + React) for developers and technical operators who want visible, editable, multi-agent workflows on top of tools you already use — Claude Code, Codex, Ollama, MCP, and cloud LLMs. Drag a SOP on a canvas; LangGraph runs it locally; you supervise chat, terminal, diffs, and approvals in one place.

Not a replacement for Claude Code or Cursor — a control layer for long sessions and multi-agent pipelines.

What's new in v1.2.8

• Multi-Agent Workflow Hardening: End-to-end fixes for check/gate branching, data passthrough, and canvas compatibility — a complete 7-node image generation SOP now runs correctly.
• Gate → Agent Data Transparency: Human Gate and Check nodes no longer leak control signals ("approve") to downstream agents; real upstream content passes through.
• Agent Fan-Out: Agent nodes can now fan out to up to 3 downstream nodes for parallel execution.
• WebSocket Session Isolation: Stale messages from previous workflow runs no longer leak into new conversations.
• Workflow UI Polish: Human Gate messages now clearly say "Awaiting approval"; Check nodes show "Checks passed"; Evaluator icons use Rivet branding.

v1.2.7 ships macOS + Windows. macOS: Apple Silicon DMG + in-app updater. Windows: MSI/NSIS. Sidecar hotpatch assets published separately.

Older releases (v1.2.6 CSP fix, v1.2.5 Design presets, v1.2.4 prototype unlock, …): CHANGELOG.md · docs/releases/.

Quick start (end users)

Option A — Terminal install (recommended)

macOS (Apple Silicon) — pick one:

# One-liner (no Homebrew required)
curl -fsSL https://raw.githubusercontent.com/fancy1108/Clutch/main/scripts/install.sh | bash

# If you already use Homebrew
brew tap fancy1108/clutch
brew install --cask clutch

Windows (x64 · not yet verified on hardware):

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

Pin a version: CLUTCH_VERSION=v1.2.8 before running either script (or v1.2.7 / v1.2.6 /

Install channels (maintainers): docs/RELEASE_MAINTAINER.md

Option B — Manual download

1. Download — GitHub Releases

[!WARNING] Windows: Installers are built in CI and attached to Releases, but maintainers have not completed full smoke testing on real Windows 10/11 machines yet. Expect rough edges; please open an Issue with your OS version and installer filename if something breaks. Tracking: #23.

2. First open (macOS unsigned build) — Gatekeeper may block the app. This is normal for unsigned OSS desktop apps:

xattr -cr /Applications/Clutch.app && open -a Clutch

Or: Applications → right-click Clutch → Open → confirm.

3. Follow the setup wizard — workspace → model or CLI → tools → done.

4. New Chat — pick an agent, send a message.

→ Full walkthrough: docs/GETTING_STARTED.md · Install details: docs/INSTALL.md

What you can do

Deep dive: docs/PRODUCT_INTRO.md · Architecture: docs/ARCHITECTURE.md

Screenshots

Hybrid workflow console — multi-agent run, progress, and token stats:

Visual SOP editor — zero-code multi-agent pipeline on a canvas:

Terminal Orchestra — interactive CLI lanes, dispatch, and session resume in Terminal mode:

Documentation

Full index: docs/README.md · Maintainers: docs/RELEASE_MAINTAINER.md

Compatibility

Details: docs/STABILITY.md

Dev toolchain (source only): Node ≥ 20, pnpm ≥ 9, Python ≥ 3.11, uv, Rust (for tauri build). Run ./scripts/doctor.sh to check.

For developers

Windows source builds: use Windows 10/11 x64 with Node >= 20, pnpm >= 9, Python >= 3.11, uv, Rust stable x86_64-pc-windows-msvc, Visual Studio 2022 Build Tools with MSVC v143, a Windows 10/11 SDK, and Git for Windows. The Windows app is still Tauri-based: React/Vite frontend, Rust desktop shell, PyInstaller Python sidecar, then MSI/NSIS bundles. More detail: docs/BUILD_FROM_SOURCE.md.

git clone https://github.com/fancy1108/Clutch.git
cd Clutch
./scripts/doctor.sh
pnpm install
cd services/orchestrator && uv sync --extra dev && cd ../..
export CLUTCH_RUNTIME_MODE=hybrid   # optional
pnpm tauri:dev

Commands & discipline: CLAUDE.md · Before PR: ./scripts/verify.sh

Security & CLI permissions

Clutch talks to local AI CLIs through a loopback Sidecar (127.0.0.1:8123).

[!IMPORTANT] For Claude Code, CodeBuddy, MiMo Code, ZCode, and Antigravity (agy) CLIs, Clutch defaults to permission-bypass flags (--dangerously-skip-permissions or ZCode --mode yolo) so workflows can run without per-tool CLI prompts. Only use on workspaces you trust. The in-chat Permission menu controls MCP gating for built-in agents, not this CLI default.

Report vulnerabilities: SECURITY.md

Repository layout

clutch/
├── apps/desktop/           # Tauri + React UI
├── services/orchestrator/  # Python Sidecar (LangGraph)
├── docs/                   # Product & install docs
├── workflows/              # Workflow schemas & templates
└── scripts/                # verify · doctor · release

Frontend and Sidecar communicate only over loopback HTTP/WebSocket (dev 8124, packaged 8123).

Community

• Questions / bugs: GitHub Issues
• Contributing: CONTRIBUTING.md · CODE_OF_CONDUCT.md
• Changelog: CHANGELOG.md