[macOS] feat: Add "quick-terminal" option to "macos-hidden" config

macos/Sources/App/macOS/AppDelegate.swift

@@ -403,6 +403,10 @@ class AppDelegate: NSObject,
         reloadDockMenu()
     }
 
+    func applicationDidUpdate(_ notification: Notification) {
+        syncActivationPolicy()
+    }
+
     /// Syncs a single menu shortcut for the given action. The action string is the same
     /// action string used for the Ghostty configuration.
     private func syncMenuShortcut(_ config: Ghostty.Config, action: String, menuItem: NSMenuItem?) {
@@ -534,13 +538,7 @@ class AppDelegate: NSObject,
         DispatchQueue.main.async { self.syncAppearance(config: config) }
 
         // Decide whether to hide/unhide app from dock and app switcher
-        switch (config.macosHidden) {
-        case .never:
-            NSApp.setActivationPolicy(.regular)
-
-        case .always:
-            NSApp.setActivationPolicy(.accessory)
-        }
+        syncActivationPolicy()
 
         // If we have configuration errors, we need to show them.
         let c = ConfigurationErrorsController.sharedInstance
@@ -616,6 +614,20 @@ class AppDelegate: NSObject,
         NSApplication.shared.appearance = .init(ghosttyConfig: config)
     }
 
+    /// Sync the app activation policy based on the config `MacHidden` value.
+    private func syncActivationPolicy() {
+        switch (derivedConfig.macosHidden) {
+        case .never:
+            NSApp.setActivationPolicy(.regular)
+
+        case .always:
+            NSApp.setActivationPolicy(.accessory)
+
+        case .quick_terminal:
+            NSApp.setActivationPolicy(NSApp.visibleRegularWindows.isEmpty ? .accessory : .regular)
+        }
+    }
+
     //MARK: - Restorable State
 
     /// We support NSSecureCoding for restorable state. Required as of macOS Sonoma (14) but a good idea anyways.
@@ -786,17 +798,20 @@ class AppDelegate: NSObject,
         let initialWindow: Bool
         let shouldQuitAfterLastWindowClosed: Bool
         let quickTerminalPosition: QuickTerminalPosition
+        let macosHidden: Ghostty.Config.MacHidden
 
         init() {
             self.initialWindow = true
             self.shouldQuitAfterLastWindowClosed = false
             self.quickTerminalPosition = .top
+            self.macosHidden = .never
         }
 
         init(_ config: Ghostty.Config) {
             self.initialWindow = config.initialWindow
             self.shouldQuitAfterLastWindowClosed = config.shouldQuitAfterLastWindowClosed
             self.quickTerminalPosition = config.quickTerminalPosition
+            self.macosHidden = config.macosHidden
         }
     }
 

macos/Sources/Features/Terminal/TerminalManager.swift

@@ -17,7 +17,7 @@ class TerminalManager {
     var focusedSurface: Ghostty.SurfaceView? { mainWindow?.controller.focusedSurface }
 
     /// The set of windows we currently have.
-    var windows: [Window] = []
+    private(set) var windows: [Window] = []
 
     // Keep track of the last point that our window was launched at so that new
     // windows "cascade" over each other and don't just launch directly on top

macos/Sources/Ghostty/Ghostty.Config.swift

@@ -529,6 +529,7 @@ extension Ghostty.Config {
     enum MacHidden : String {
         case never
         case always
+        case quick_terminal = "quick-terminal"
     }
 
     enum ResizeOverlay : String {

macos/Sources/Helpers/NSApplication+Extension.swift

@@ -24,6 +24,23 @@ extension NSApplication {
     }
 }
 
+extension NSApplication {
+    private static let nonRegularWindowsClassNames: [String] = [
+        "NSStatusBarWindow",
+        "_NSPopoverWindow",
+        "TUINSWindow"
+    ]
+
+    /// Windows that are visible and regular (such as terminal & update windows).
+    /// `QuickTerminalWindow` instances are omitted from this collection.
+    var visibleRegularWindows: [NSWindow] {
+        NSApp.windows
+            .filter { !($0 is QuickTerminalWindow) }
+            .filter { !Self.nonRegularWindowsClassNames.contains($0.className) }
+            .filter { $0.isVisible }
+    }
+}
+
 extension NSApplication.PresentationOptions.Element: @retroactive Hashable {
     public func hash(into hasher: inout Hasher) {
         hasher.combine(rawValue)

src/config/Config.zig

@@ -5762,6 +5762,7 @@ pub const MacTitlebarProxyIcon = enum {
 pub const MacHidden = enum {
     never,
     always,
+    @"quick-terminal",
 };
 
 /// See macos-icon