From d05fb652ed51727300f701e5c2f71f5624c64cdb Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <m@mitchellh.com>
Date: Thu, 26 Feb 2026 09:09:57 -0800
Subject: [PATCH] macos: update AGENTS.md

---
 AGENTS.md       | 7 -------
 macos/AGENTS.md | 6 ++++++
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 21645e4d2..c6bd79b0e 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -18,13 +18,6 @@ A file for [guiding coding agents](https://agents.md/).
 - macOS app: `macos/`
 - GTK (Linux and FreeBSD) app: `src/apprt/gtk`
 
-## macOS App
-
-- Do not use `xcodebuild`
-- Use `zig build` to build the macOS app and any shared Zig code
-- Use `zig build run` to build and run the macOS app
-- Run Xcode tests using `zig build test`
-
 ## Issue and PR Guidelines
 
 - Never create an issue.
diff --git a/macos/AGENTS.md b/macos/AGENTS.md
index 6321808b8..50e91781d 100644
--- a/macos/AGENTS.md
+++ b/macos/AGENTS.md
@@ -1,3 +1,9 @@
 # macOS Ghostty Application
 
 - Use `swiftlint` for formatting and linting Swift code.
+- If code outside of this directory is modified, use
+  `zig build -Demit-macos-app=false` before building the macOS app to update
+  the underlying Ghostty library.
+- Use `xcodebuild` to build the macOS app, do not use `zig build`
+  (except to build the underlying library as mentioned above).
+- Run unit tests directly with `xcodebuild`