swift-ghostty

A Swift package wrapping Ghostty's terminal engine for embedding in macOS apps.

Requirements

• macOS 26+
• Swift 6.2+
• Zig 0.15.2 (installed automatically via mise)

Installation

Add swift-ghostty as a Swift Package Manager dependency:

dependencies: [
    .package(url: "https://github.com/NoDevOrg/swift-ghostty.git", from: "0.1.0"),
]

Then add Ghostty to your target's dependencies:

.target(
    name: "YourApp",
    dependencies: [
        .product(name: "Ghostty", package: "swift-ghostty"),
    ]
)

Building the XCFramework

The package depends on a pre-built GhosttyKit xcframework. Build it from the ghostty submodule:

git submodule update --init --recursive
make xcframework

This compiles the Ghostty C library from source using Zig and packages it as Frameworks/GhosttyKit.xcframework.zip.

Usage

import Ghostty

// Initialize once at app launch
GhosttyAppManager.shared.initialize()

// Embed a terminal in SwiftUI
GhosttyTerminalView(appManager: GhosttyAppManager.shared)

See Examples/BasicTerminal for a complete working app.

Running the Example

make xcframework
cd Examples/BasicTerminal
swift run

Package Structure

• Ghostty - Swift library with SwiftUI/AppKit terminal views
  • GhosttyAppManager - Singleton managing the ghostty app lifecycle
  • GhosttyTerminalView - SwiftUI view embedding a terminal
  • GhosttyTerminalSurface - AppKit NSView with Metal rendering
• GhosttyKit - Binary target wrapping the C xcframework