diff --git a/include/module.modulemap b/include/module.modulemap
index 917796d89..8961f5c04 100644
--- a/include/module.modulemap
+++ b/include/module.modulemap
@@ -1,3 +1,6 @@
+// This makes Ghostty available to the XCode build for the macOS app.
+// We append "Kit" to it not to be cute, but because targets have to have
+// unique names and we use Ghostty for other things.
 module GhosttyKit {
     umbrella header "ghostty.h"
     export *