A native macOS terminal built on libghostty, with tmux-style session management built in. Sessions, tabs, split panes, and a fuzzy switcher live inside the terminal — no separate multiplexer to run, configure, or keep alive.

The same, GPU-accelerated rendering engine you are used to from Ghostty. Mistty wraps it in a SwiftUI shell that organizes your work into a tree of windows, sessions, tabs, and panes you can drive entirely from the keyboard or script from the command line.

Requires macOS 14 (Sonoma) or later on Apple Silicon.

• Session manager (Cmd+J) — one fuzzy palette over your open sessions, recent directories (via zoxide), and SSH hosts from ~/.ssh/config. Type a few letters, hit return, and you're in the right place.
• Sessions, tabs, and split panes — a working-directory-scoped session holds tabs; tabs hold split panes. Standard terminal multiplexing without tmux.
• Sidebar (Cmd+S) — a persistent tree of your sessions and tabs.
• Popups — launch TUIs like lazygit or quick commands you run all the time by binding them to a keyboard shortcut.
• Window mode (Cmd+X) — a modal layer for moving, resizing, zooming, and rearranging panes with single keystrokes, plus one-key standard layouts.
• Copy mode (Cmd+Shift+C) — vim-style keyboard navigation, selection, search, and link/path hints for yanking or opening without the mouse. Also try yank mode (Cmd+Shift+V) or copy mode (Cmd+Shift+O) to copy or open text shaped like numbers, URLs, paths, and more, with a few keystrokes.
• State restoration — relaunch and your sessions, tabs, panes, and working directories come back; allow-listed programs (nvim, ssh, …) relaunch too. Configure restoration strategies like passing environment variables, or repeating the previous arguments.
• CLI control (mistty-cli) — script sessions, tabs, and panes; send keys, run commands, and read pane text over a local socket.
• Configurable — a single TOML file at ~/.config/mistty/config.toml, plus full passthrough to any Ghostty option.
• Desktop notifications — programs can raise a macOS notification (OSC 9 / 777) from inside a pane; the originating tab and the Dock icon are flagged when it's not focused. claude, codex, or other agent harnesses will be highlighted in the sidebar when they are waiting for your response.

brew install --cask milch/mistty/mistty

This installs Mistty.app and puts the mistty-cli tool on your PATH.

It is recommended to install zoxide to populate recent directories in the session manager:

brew install zoxide

See Building from source — you'll need Xcode, Nix (for the pinned Zig that builds libghostty), and just.

Launch Mistty and you get one window with a single session, tab, and pane. From there:

Every shortcut is rebindable. The keyboard shortcuts reference lists them all.

The user guide covers everything in depth:

• Installation — Homebrew, zoxide, and building from source
• Getting started — windows, sessions, tabs, panes, and the session manager
• Keyboard shortcuts — every binding, plus window mode
• Copy mode — vim-style navigation and link hints
• Configuration — the full config.toml reference
• CLI — scripting Mistty with mistty-cli

A fully-commented sample config lives at docs/config-example.toml. There's also a Neovim smart-splits integration for seamless vim ↔ pane navigation.

Run just --list for the full set. The architecture and contributor notes live in docs/user-guide/installation.md and the design docs under docs/.

MIT.