feat: focus terminal in basic cases

macos/Sources/Features/App Intents/FocusTerminalIntent.swift

@@ -0,0 +1,35 @@
+import AppKit
+import AppIntents
+import GhosttyKit
+
+struct FocusTerminalIntent: AppIntent {
+    static var title: LocalizedStringResource = "Focus Terminal"
+    static var description = IntentDescription("Move focus to an existing terminal.")
+
+    @Parameter(
+        title: "Terminal",
+        description: "The terminal to focus.",
+    )
+    var terminal: TerminalEntity
+
+    @available(macOS 26.0, *)
+    static var supportedModes: IntentModes = .background
+
+    @MainActor
+    func perform() async throws -> some IntentResult {
+        guard await requestIntentPermission() else {
+            throw GhosttyIntentError.permissionDenied
+        }
+
+        guard let surfaceView = terminal.surfaceView else {
+            throw GhosttyIntentError.surfaceNotFound
+        }
+
+        guard let controller = surfaceView.window?.windowController as? BaseTerminalController else {
+            return .result()
+        }
+
+        controller.focusSurface(surfaceView)
+        return .result()
+    }
+}

macos/Sources/Features/Terminal/BaseTerminalController.swift

@@ -233,6 +233,16 @@ class BaseTerminalController: NSWindowController,
         return newView
     }
 
+    func focusSurface(_ view: Ghostty.SurfaceView) {
+        guard surfaceTree.contains(view) else { return }
+
+        DispatchQueue.main.async {
+            Ghostty.moveFocus(to: view, from: self.focusedSurface)
+            view.window?.makeKeyAndOrderFront(nil)
+            NSApp.activate(ignoringOtherApps: true)
+        }
+    }
+
     /// Called when the surfaceTree variable changed.
     ///
     /// Subclasses should call super first.