README.md
May 12, 2026 · View on GitHub
Macterm
A lightweight, native terminal for macOS built with SwiftUI and libghostty.

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:
- Open System Settings → Privacy & Security.
- Scroll to the Security section — you'll see "Macterm.app was blocked…" with an Open Anyway button. Click it.
- 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