Install Termic

Termic is a native desktop app. macOS is first-class (a signed universal binary with a Homebrew cask and an in-app updater); Linux ships as a signed AppImage with every release; Windows builds from source today. Pick your platform below.

macOS

The recommended path is Homebrew:

brew install --cask simion/termic/termic

That one command auto-taps simion/homebrew-termic, downloads the latest .dmg, and installs Termic.app into /Applications. Termic is signed with a Developer ID certificate and notarized by Apple, so it opens with no “unidentified developer” warning. Requires macOS 12 (Monterey) or newer; the build is universal, so it runs natively on both Apple Silicon and Intel.

To upgrade later:

brew upgrade --cask termic

Direct download

The .dmg, the .app.tar.gz, and an ed25519 signature for each release live on the Releases page. The .dmg is signed and notarized by Apple, so it opens on first launch with nothing else to do.

Linux

Download termic_<version>_amd64.AppImage from the Releases page, make it executable, and run it:

chmod +x termic_*_amd64.AppImage
./termic_*_amd64.AppImage

The AppImage is signed by the same ed25519 key as the macOS build, so the in-app updater works identically. Keep the file somewhere writable, like ~/Applications/, so the updater can replace it in place.

Two caveats on Linux:

• No sandbox. The sandbox is built on macOS Seatbelt and is a no-op on Linux for now. The shield toggle is disabled; agents run unsandboxed. Everything else (worktrees, parallel tabs, find-in-files, themes, the diff view) works the same.
• Wayland fonts. If text renders thin, force X11 by prefixing the launch command with GDK_BACKEND=x11 (or set it in the .desktop file’s Exec= line).

Windows

There are no prebuilt Windows binaries yet, but the build works today on Windows 11 (or Windows 10 with the WebView2 Evergreen runtime). You’ll need the Microsoft C++ Build Tools, Rust stable, Node 20+, and Git, then:

git clone https://github.com/simion/termic
cd termic
npm install
npm run tauri build

The .msi lands under src-tauri\target\release\bundle\msi\. It’s unsigned, so SmartScreen will warn on first run; click More info → Run anyway. The sandbox is a no-op on Windows, same as Linux.

Build from source

If you want to hack on Termic, or package it for your own distro, building from source is straightforward. On macOS:

git clone https://github.com/simion/termic
cd termic
make setup     # brew/rust/node + npm install + cargo check
make install   # build, copy to /Applications, launch

make dev is the iteration loop (Vite HMR plus a Rust auto-rebuild). On Linux you’ll need the WebKitGTK 4.1 and GTK 3 development packages for your distro; the full prerequisite lists for Debian, Fedora and Arch are in the project’s README. After npm run tauri build, the .deb, .rpm and .AppImage bundles land under src-tauri/target/release/bundle/.

Updating

Termic ships with a self-updater. When a new release is published, an Update X.Y.Z pill appears in the top-right of the toolbar. Click it to download, verify the ed25519 signature, and relaunch. There’s a changelog link right on the update card so you can see what changed before you take it.

If you installed via Homebrew you can also update with brew upgrade --cask termic. The in-app updater knows how to replace the macOS app and the Linux AppImage in place; .deb / .rpm installs upgrade by rebuilding from source.

Next steps

With Termic installed, head to Your first task to add a project and spawn your first agent. Coming from Conductor? Read Migrating from Conductor first.