Macterm

A native macOS terminal with a vertical project sidebar and persistent multiplexing, built on libghostty

Documentation · Website · Releases

Features

• Persistent multiplexing — projects, tabs, and split panes are saved and restored on relaunch. Shells run under a bundled zmx session, so quitting detaches and relaunching reattaches every pane with its scrollback and running processes intact.
• Remote projects — open a directory on another machine over SSH. Each pane is a persistent session on the host, so your shells survive quits, dropped connections, and even a local reboot.
• Vertical project sidebar — organize projects and their tabs in a native macOS sidebar, stacked vertically where there's room to read them.
• Command palette — press ⌘P to split panes, switch projects, or open a directory. Every action is a keystroke away, and each row shows its keybind.
• Declarative layouts — describe a project's tabs, splits, and per-pane commands in YAML; Macterm builds the workspace from it on open.
• Control CLI — a bundled macterm command drives the running app over a local socket, so scripts and AI agents can spawn panes, run commands, and script layouts.
• Quick terminal — a global drop-down terminal on a hotkey (⌃`), for scratch work from anywhere.
• Ghostty compatibility — reads your existing ~/.config/ghostty/config. Theme, font, keybinds — all of it just works.

Install

Homebrew

brew install --cask thdxg/tap/macterm

The cask strips the Gatekeeper quarantine attribute on install, so the app launches without extra prompts.

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, clear the quarantine flag once:

xattr -cr /Applications/Macterm.app

Sparkle handles updates from there, verifying an EdDSA signature on each one — so you won't need xattr again.

Documentation

Full guides live at macterm.thdxg.dev/docs:

• Installation and Configuration
• Command palette and Quick terminal
• Declarative layouts, Session persistence, and Remote projects
• The macterm CLI

Contributing

See CONTRIBUTING.md for setup, build, and PR guidelines.

License

MIT