Skip to content

Install

Cleat is distributed through cleat.tools — sign up there to download the installer for your platform. The account is only for getting the download; once installed, the app runs fully local-first, with no telemetry and no online activation.

Early access

Cleat is pre-1.0. Builds are unsigned (code signing is on the roadmap for Phase 3) — you may need to bypass your OS gatekeeper the first time you launch it. Instructions per platform are below.

macOS

  1. Sign in at cleat.tools and download the latest Cleat-*.dmg.
  2. Open the DMG and drag Cleat.app to /Applications.

  3. The first launch is blocked by Gatekeeper because the build isn't signed yet:

    • Right-click Cleat.app → Open → confirm.
    • Or, from a terminal: xattr -d com.apple.quarantine /Applications/Cleat.app

A Homebrew cask is planned for v0.2. For now, use the DMG.

```bash

Not yet available

brew install --cask cleat

```

Requirements: macOS 12 Monterey or newer. Apple Silicon native; Intel Macs are not currently built.

Linux

Download the latest .deb from cleat.tools, then install it:

bash sudo apt install ./cleat_amd64.deb

Download the latest .rpm from cleat.tools, then install it:

bash sudo dnf install ./cleat.x86_64.rpm

Download Cleat-x86_64.AppImage from cleat.tools, then make it executable and run it:

bash chmod +x Cleat-x86_64.AppImage ./Cleat-x86_64.AppImage

Requirements: glibc 2.35+ (Ubuntu 22.04 / Fedora 38 baseline). Wayland and X11 both supported via SDL3.

Windows

  1. Sign in at cleat.tools and download Cleat-Setup.exe.
  2. Run it. SmartScreen will warn — choose More info → Run anyway (builds are unsigned until Phase 3).
  1. Download Cleat-windows-x64.zip from cleat.tools.
  2. Extract anywhere and run cleat.exe.

Requirements: Windows 10 21H2 or newer. x64 only.

Next

You're installed — make your first connection.