Install, update, and organize your work

The convenience installer authenticates an exact signed release, verifies the archive and app identity, chooses a user-writable Applications directory, and opens Clinch. It does not use sudo, clear quarantine, alter Gatekeeper, or configure provider integrations directly.

Review the current installer source before running it. The latest URL resolves to an immutable, versioned release asset.

For the primary manual verification path, download Clinch.dmg from a versioned release, authenticate the checksum list with its release-key signature, and compare the DMG digest. The repository README contains the complete commands and public key. Browser downloads are quarantined, so the first launch may require System Settings → Privacy & Security → Open Anyway.

Updater-enabled builds request signed release metadata from GitHub at most once per active calendar day. Automatic checks never download the app. When a newer release is available, the header shows Update available.

Click that notice or choose Clinch → Check for Updates…. Clinch presents the authenticated version and notes first. After you approve Download and Install, it verifies the archive, saves restorable state, quits, atomically swaps the app, relaunches, and rolls back if the new build does not start.

The updater never asks for administrator privileges. If the app or its parent directory is not writable by the current user, Clinch opens the authenticated manual installation path instead.

Project tabs are complete workspaces across the top of a window. Each project preserves its own terminal tabs, panes, panels, working directory, agent state, and unread activity.

• Drag an eligible ordinary tab upward into the project header to promote that live tab into a new project.
• Or right-click the tab and choose Move Tab to New Project.
• Drag project tabs horizontally to reorder them or onto another Clinch window's project strip to transfer them.
• Drag a project tab away from the header and drop it on the desktop to move that same live project into a new window.

Clinch transfers the live workspace instead of restarting its sessions. Cancelling a drag or encountering a failed transfer leaves the project in its source window.

Clinch Remote Control (Beta) is a private mobile web app for viewing and controlling the projects and sessions on your Mac. Its first transport uses Tailscale on both devices; it does not require a Clinch account or send terminal traffic through clinch.sh. It ships in the current release and stays off until you turn it on.

Click the phone button in Clinch's header to open guided setup. Once enabled and paired, the mobile client supports live viewing, command execution, new terminal and agent tabs, quick inserts, usage snapshots, and file uploads into local terminal directories. See the interface tour, setup steps, and security model.

On first launch, Clinch enables its local Claude Code and Codex session-capture integration. Change it under Clinch Settings → Agents → Claude Code and Codex session capture.

Resume is best effort: Clinch records a provider session ID and starts a new provider process with a resume command. It does not keep the old process alive through quit, crash, or reboot, and deleted or incompatible provider transcripts may not be recoverable.

Stable Clinch starts no Warp account session, RudderStack analytics destination, or Sentry crash reporter. Its updater can make the signed metadata request described above. Claude Code, Codex, SSH, MCP servers, plugins, package tools, and other programs still use the network and credentials according to their own configuration.

Clinch is ad-hoc signed and not Apple-notarized or independently security-audited. See the FAQ and repository security documentation for the complete threat model and residual risks.

Every release includes a selective uninstall.sh. With no flags it removes only the app. Optional flags remove managed integrations, captured metadata, app data, or provider plugins without deleting all of ~/.warp, provider transcripts, or Keychain credentials.

bash uninstall.sh --help