JusTTY

Under the hood you get Ghostty's Metal renderer and a real PTY login shell. On top of it sits a small SwiftUI shell that owns windows, tabs, and settings. Nothing else.

brew trust --tap 0x96f/justty
brew tap 0x96f/justty
brew install --cask justty

Requires macOS 15.6 or later.

Start Here

Install JusTTY

Homebrew or a manual download, in under a minute

First Launch

Get past Gatekeeper and into a working shell

Keyboard Shortcuts

Every binding, window and terminal

How It Works

Architecture

What the SwiftUI host owns and what libghostty owns

Windows and Tabs

Tab titles, working directories, parking

Fixed Ghostty Behavior

Host-owned defaults you cannot change

What JusTTY Does Not Do

Splits, panes, profiles, and why they are absent

Configure

Settings Reference

Every control in the Settings window

Themes

The GhosttyTheme catalog, light and dark

Fonts and Zoom

Family, size, weight, line height, per-tab zoom

config.yml

Edit settings on disk and reload them

Reference

Build from Source

Xcode, submodules, the justty scheme

Code Signing

The Justty Self-Signed identity and CI secrets

Homebrew Tap

Install path and maintainer cask bumps

Troubleshooting

Gatekeeper, submodules, PTY failures

Requirements

Supported macOS and Xcode versions

Why JusTTY exists#

Ghostty is fast and its renderer is excellent, but a full terminal emulator carries configuration surface most people never touch. JusTTY keeps the rendering engine and drops the rest: no splits, no inspector, no profile system, no remappable keybindings in the UI. You get tabs, a theme, a font, and a shell.

If you want every knob, run Ghostty. If you want a terminal that opens and gets out of the way, this is it.

License#

MIT. Source at github.com/0x96f/justty.

Updated Jul 31, 2026