README.md

May 12, 2026 · View on GitHub


Macterm

A lightweight, native terminal for macOS built with SwiftUI and libghostty.

screenshot

Features

  • Vertical Project Sidebar: Native macOS sidebar for organizing projects and tabs vertically.
  • Split Panes: Unlimited horizontal and vertical splits, with optional auto-tiling.
  • Persistence: Projects, tabs, and panes are saved and restored automatically.
  • Quick terminal: Global terminal accessible from anywhere.
  • Highly Configurable: Configurable theme, font, and keymap with hot-reloading.
  • Command Palette: Versatile command palette to interact with multiplexing (open, delete, and search projects)

Install

Homebrew

brew install --cask thdxg/tap/macterm

The cask strips the Gatekeeper quarantine xattr on install, so the app launches without any extra prompts. Updates are delivered via Sparkle inside the app.

From Releases

Download the latest .dmg from Releases, open it, and drag Macterm to Applications.

Since the app isn't signed with an Apple Developer certificate, macOS will block it on first launch with a "Macterm.app Not Opened" dialog. Dismiss the dialog, then:

  1. Open System Settings → Privacy & Security.
  2. Scroll to the Security section — you'll see "Macterm.app was blocked…" with an Open Anyway button. Click it.
  3. Launch Macterm again and confirm.

You only need to do this once. (Or, from Terminal: xattr -cr /Applications/Macterm.app, then launch normally.)

Development

Requirements

  • macOS 26.0+
  • Swift 6.0+
  • mise (optional, but recommended)

Quick Start

# Install necessary tools (swiftlint, gh, etc.)
mise install

# Setup dependencies
mise run setup

# Run in debug mode
mise run run

# Build release bundle
mise run build

# Run the test suite
mise run test

License

MIT