Guide

Installation

Building and installing Kytos
Properties3
Is BaseNo
Iconi-lucide-download
Order10

Prerequisites

  • macOS 26+ (Tahoe)
  • pixi package manager
  • Xcode with macOS 26 SDK
  • Ghostty source at ~/Syntropment/ghostty

Install pixi

curl -fsSL https://pixi.sh/install.sh | bash

Clone

git clone https://github.com/jwintz/kytos
cd kytos

Build

pixi run build

This runs the full build pipeline:

  1. build-ghostty — builds GhosttyKit.xcframework from Ghostty source
  2. generate — generates Kytos.xcodeproj from project.yml using XcodeGen
  3. xcodebuild — compiles Swift sources and links against GhosttyKit and KelyphosKit

Run

pixi run run

Builds if needed, then launches Kytos.app.

Configure Terminal

Terminal settings are managed via Ghostty's config file:

~/.config/ghostty/config

Use the Settings window → "Open Ghostty Config" for quick access.

Next Steps