diff options
| author | Mitchell Hashimoto <m@mitchellh.com> | 2025-10-09 11:08:19 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-10-09 11:08:19 -0700 |
| commit | d0f800c5fbb0cd940aa8068b88edadb34be57cde (patch) | |
| tree | 182d90d0b180628b5034de944afd579ab6be67dc | |
| parent | 6e5e726bc29a1f1faac6d4ac04bbc7778d3ad559 (diff) | |
| parent | e8ebc6f40535951af3737c571a0023a683e3bfba (diff) | |
docs: Update build requirements for macOS (#9095)
Adds the Metal Toolchain as a required Xcode component for building
Ghostty. Also updates the notes about Xcode 26 now that it and Tahoe are
out of Beta.
| -rw-r--r-- | HACKING.md | 10 |
1 files changed, 4 insertions, 6 deletions
diff --git a/HACKING.md b/HACKING.md index 905a244e8..0a4bbef20 100644 --- a/HACKING.md +++ b/HACKING.md @@ -50,24 +50,22 @@ macOS users don't require any additional dependencies. ## Xcode Version and SDKs Building the Ghostty macOS app requires that Xcode, the macOS SDK, -and the iOS SDK are all installed. +the iOS SDK, and Metal Toolchain are all installed. A common issue is that the incorrect version of Xcode is either installed or selected. Use the `xcode-select` command to ensure that the correct version of Xcode is selected: ```shell-session -sudo xcode-select --switch /Applications/Xcode-beta.app +sudo xcode-select --switch /Applications/Xcode.app ``` > [!IMPORTANT] > -> Main branch development of Ghostty is preparing for the next major -> macOS release, Tahoe (macOS 26). Therefore, the main branch requires -> **Xcode 26 and the macOS 26 SDK**. +> Main branch development of Ghostty requires **Xcode 26 and the macOS 26 SDK**. > > You do not need to be running on macOS 26 to build Ghostty, you can -> still use Xcode 26 beta on macOS 15 stable. +> still use Xcode 26 on macOS 15 stable. ## AI and Agents |