Zentty

A native macOS terminal for agent-native development, built on Ghostty.
Zentty gets out of the way. Minimal friction, maximum focus.
Download · Install · Status · Build · Contributing

Features

• Worklanes, not just tabs. Borrowed from niri and Hyprland: a horizontally-scrolling strip of columns, each column a vertical stack of panes. Rearrange, resize, and navigate without losing your place.
• Keyboard-first, top to bottom. Every action is a command. Every command is bindable. Rebind anything in settings, or fall back to the command palette when your muscle memory runs out.
• Command palette. A fuzzy-searchable list of every action in the app, with your recent commands on top.
• Agent-aware. Claude Code, Codex, Copilot CLI, Gemini CLI, and OpenCode report their status into the sidebar, so you see what they're doing, what they're asking, and when they need you, without switching panes.
• Native Ghostty themes. Zentty reads Ghostty's own theme files (your ~/.config/ghostty/themes and the bundled library), with automatic light/dark switching.
• Built on Ghostty. GPU-accelerated rendering via libghostty, wrapped in a native Swift and AppKit shell. No Electron, no web views. It feels like a Mac app because it is one.

Install

Download the latest .dmg from the releases page, open it, and drag Zentty to your Applications folder.

Zentty updates itself in place via Sparkle once installed. No need to check back here for new versions.

Builds are signed and notarized by Zenjoy BV. Requires macOS 26 (Tahoe) or later.

Status

Zentty is in active development. Expect rapid iteration, rough edges, and occasional breaking changes while the project is opened up.

Requirements

• macOS 26 (Tahoe) or later
• Xcode
• zig on PATH
• gettext on PATH

Build

Zentty requires a local GhosttyKit.xcframework before the app can build normally.

Build the framework:

./scripts/build_ghosttykit.sh

Then build the app:

xcodebuild -project Zentty.xcodeproj -scheme Zentty -destination 'platform=macOS' build

If you need to regenerate the Xcode project from project.yml:

bundle exec fastlane mac generate_project

More detail about the Ghostty bootstrap flow lives in docs/ghosttykit-setup.md.

Test

Run the full test suite:

xcodebuild test -scheme Zentty -destination 'platform=macOS'

Agent Hooks

Zentty bundles helper commands and environment variables for agent-aware workflows inside terminal panes.

Hook configuration details are documented in docs/agent-hooks.md.

Contributing

Contributions are welcome. Start with CONTRIBUTING.md.

Before a non-trivial contribution can be merged, contributors must agree to CLA.md.

License

Zentty is available under the GNU General Public License v3.0 only (GPL-3.0-only). See LICENSE.

If your organization cannot or does not want to comply with GPLv3, alternative commercial licensing may be available from Zenjoy BV. Contact hallo@zenjoy.be.

Trademarks

The GPL license covers the code. It does not grant rights to use the Zentty name, logos, icons, or other branding for your own distribution.

See TRADEMARKS.md for branding rules.