Add Cursor Agent integration

Integrate the Cursor Agent CLI (`agent`) into Ghostree, following the
same patterns used for Claude Code, Codex and OpenCode:

- Agent wrapper in the hooks bin dir that resolves the real `agent`
  binary, emits a synthetic Start lifecycle event and execs through
- Stop hook installed into ~/.cursor/hooks.json (merged with any
  existing user hooks) so the notify script fires on agent stop
- SessionSource.agent and session discovery from ~/.cursor/chats/
  (reads SQLite store.db metadata via a lightweight CursorAgentDB helper)
- Shell integration aliases for both zsh and bash
- WorktrunkAgent / WorktrunkDefaultAction entries for the sidebar
- Resume support via `agent --resume <id>`

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: bvolpato-dd

macos/Ghostty.xcodeproj/project.pbxproj

@@ -151,6 +151,7 @@
 				Features/Worktrunk/AgentStatus/AgentHookInstaller.swift,
 				Features/Worktrunk/AgentStatus/AgentStatusModels.swift,
 				Features/Worktrunk/AgentStatus/AgentStatusPaths.swift,
+				Features/Worktrunk/AgentStatus/CursorAgentDB.swift,
 				Features/Worktrunk/GitHub/GHClient.swift,
 				Features/Worktrunk/GitHub/GitHubModels.swift,
 				Features/Worktrunk/GitHub/GitRefWatcher.swift,

macos/Sources/Features/Terminal/TerminalController.swift

@@ -1872,6 +1872,8 @@ class TerminalController: BaseTerminalController, TabGroupCloseCoordinator.Contr
             base.command = "codex resume \(session.id)"
         case .opencode:
             base.command = "opencode --session \(session.id)"
+        case .agent:
+            base.command = "agent --resume \(session.id)"
         }
 
         if WorktrunkPreferences.worktreeTabsEnabled {

macos/Sources/Features/Worktrunk/AgentStatus/AgentHookInstaller.swift

@@ -3,7 +3,8 @@ import Foundation
 enum AgentHookInstaller {
     private static let notifyScriptMarker = "# Ghostree agent notification hook v7"
     private static let claudeSettingsMarker = "\"_v\":3"
-    private static let wrapperMarker = "# Ghostree agent wrapper v3"
+    private static let wrapperMarker = "# Ghostree agent wrapper v4"
+    private static let cursorAgentHooksMarker = "ghostree-notify"
 
     static func ensureInstalled() {
         if ProcessInfo.processInfo.environment["GHOSTREE_DISABLE_AGENT_HOOKS"] == "1" {
@@ -51,6 +52,13 @@ enum AgentHookInstaller {
             marker: wrapperMarker,
             content: buildCodexWrapper()
         )
+        ensureFile(
+            url: AgentStatusPaths.cursorAgentWrapperPath,
+            mode: 0o755,
+            marker: wrapperMarker,
+            content: buildCursorAgentWrapper()
+        )
+        ensureCursorAgentGlobalHooks(notifyPath: AgentStatusPaths.notifyHookPath.path)
 
         ensureFile(
             url: AgentStatusPaths.opencodeGlobalPluginPath,
@@ -295,6 +303,102 @@ enum AgentHookInstaller {
         """
     }
 
+    private static func buildCursorAgentWrapper() -> String {
+        let binDir = AgentStatusPaths.binDir.path
+        let eventsDir = AgentStatusPaths.eventsCacheDir.path
+        return """
+        #!/bin/bash
+        \(wrapperMarker)
+        # Wrapper for Cursor Agent: emits lifecycle events.
+        # Hook configuration is managed via ~/.cursor/hooks.json.
+
+        \(pathAugmentSnippet())
+
+        find_real_binary() {
+          local name="$1"
+          local IFS=:
+          for dir in $PATH; do
+            [ -z "$dir" ] && continue
+            dir="${dir%/}"
+            if [ "$dir" = "\(binDir)" ]; then
+              continue
+            fi
+            if [ -x "$dir/$name" ] && [ ! -d "$dir/$name" ]; then
+              printf "%s\\n" "$dir/$name"
+              return 0
+            fi
+          done
+          return 1
+        }
+
+        REAL_BIN="$(find_real_binary "agent")"
+        if [ -z "$REAL_BIN" ]; then
+          REAL_BIN="$(find_real_binary "cursor-agent")"
+        fi
+        if [ -z "$REAL_BIN" ]; then
+          echo "Ghostree: agent (Cursor Agent) not found in PATH. Install it and ensure it is on PATH, then retry." >&2
+          exit 127
+        fi
+
+        # Emit synthetic Start event for Cursor Agent
+        printf '{\"timestamp\":\"%s\",\"eventType\":\"Start\",\"cwd\":\"%s\"}\\n' \
+          "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" \
+          "$(pwd -P 2>/dev/null || pwd)" \
+          >> "${GHOSTREE_AGENT_EVENTS_DIR:-\(eventsDir)}/agent-events.jsonl" 2>/dev/null
+
+        exec "$REAL_BIN" "$@"
+        """
+    }
+
+    /// Merges the Ghostree stop hook into ~/.cursor/hooks.json without clobbering
+    /// any existing user hooks.  Idempotent: checks for the marker command before writing.
+    private static func ensureCursorAgentGlobalHooks(notifyPath: String) {
+        let url = AgentStatusPaths.cursorAgentGlobalHooksPath
+        let escapedNotifyPath = notifyPath.replacingOccurrences(of: "'", with: "'\\''")
+        let ghostreeCommand = "bash '\(escapedNotifyPath)'"
+
+        // Read existing file if it exists
+        var root: [String: Any] = [:]
+        if let data = try? Data(contentsOf: url),
+           let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] {
+            root = json
+        }
+
+        // Already installed?
+        if let existing = try? String(contentsOf: url, encoding: .utf8),
+           existing.contains(cursorAgentHooksMarker) {
+            return
+        }
+
+        root["version"] = 1
+
+        var hooks = root["hooks"] as? [String: Any] ?? [:]
+        var stopHooks = hooks["stop"] as? [[String: Any]] ?? []
+
+        // Remove any stale Ghostree entries
+        stopHooks.removeAll { entry in
+            guard let cmd = entry["command"] as? String else { return false }
+            return cmd.contains("ghostree") || cmd.contains("Ghostree") || cmd.contains(cursorAgentHooksMarker)
+        }
+
+        // Add the Ghostree hook (tagged so we can find it later)
+        stopHooks.append(["command": ghostreeCommand])
+        hooks["stop"] = stopHooks
+        root["hooks"] = hooks
+
+        // Ensure ~/.cursor directory exists
+        let parentDir = url.deletingLastPathComponent()
+        try? FileManager.default.createDirectory(at: parentDir, withIntermediateDirectories: true)
+
+        guard let data = try? JSONSerialization.data(withJSONObject: root, options: [.prettyPrinted, .sortedKeys]),
+              var jsonString = String(data: data, encoding: .utf8) else {
+            return
+        }
+
+        jsonString += "\n"
+        try? jsonString.write(to: url, atomically: true, encoding: .utf8)
+    }
+
     private static func buildOpenCodePlugin() -> String {
         let marker = AgentStatusPaths.opencodePluginMarker
         return """

macos/Sources/Features/Worktrunk/AgentStatus/AgentStatusPaths.swift

@@ -46,6 +46,16 @@ enum AgentStatusPaths {
         binDir.appendingPathComponent("codex")
     }
 
+    static var cursorAgentWrapperPath: URL {
+        binDir.appendingPathComponent("agent")
+    }
+
+    static var cursorAgentGlobalHooksPath: URL {
+        FileManager.default.homeDirectoryForCurrentUser
+            .appendingPathComponent(".cursor", isDirectory: true)
+            .appendingPathComponent("hooks.json", isDirectory: false)
+    }
+
     static var opencodePluginMarker: String { "// Ghostree opencode plugin v5" }
 
     /** @see https://opencode.ai/docs/plugins */

macos/Sources/Features/Worktrunk/AgentStatus/CursorAgentDB.swift

@@ -0,0 +1,80 @@
+import CryptoKit
+import Foundation
+import SQLite3
+
+/// Lightweight read-only accessor for Cursor Agent chat store.db files.
+/// The DB has two tables: `meta` (key TEXT, value TEXT) and `blobs` (id TEXT, data BLOB).
+/// The meta row with key "0" holds hex-encoded JSON with session metadata.
+final class CursorAgentDB {
+    struct Meta {
+        var agentId: String?
+        var name: String?
+        var createdAt: Double?
+        var lastUsedModel: String?
+    }
+
+    private var db: OpaquePointer?
+
+    init?(path: String) {
+        var handle: OpaquePointer?
+        let flags = SQLITE_OPEN_READONLY | SQLITE_OPEN_NOMUTEX
+        guard sqlite3_open_v2(path, &handle, flags, nil) == SQLITE_OK else {
+            if let handle { sqlite3_close(handle) }
+            return nil
+        }
+        self.db = handle
+    }
+
+    func close() {
+        if let db {
+            sqlite3_close(db)
+            self.db = nil
+        }
+    }
+
+    deinit {
+        close()
+    }
+
+    func readMeta() -> Meta? {
+        guard let db else { return nil }
+        var stmt: OpaquePointer?
+        guard sqlite3_prepare_v2(db, "SELECT value FROM meta WHERE key = '0' LIMIT 1", -1, &stmt, nil) == SQLITE_OK else {
+            return nil
+        }
+        defer { sqlite3_finalize(stmt) }
+
+        guard sqlite3_step(stmt) == SQLITE_ROW else { return nil }
+        guard let cstr = sqlite3_column_text(stmt, 0) else { return nil }
+        let hexString = String(cString: cstr)
+
+        guard let jsonData = dataFromHex(hexString) else { return nil }
+        guard let json = try? JSONSerialization.jsonObject(with: jsonData) as? [String: Any] else { return nil }
+
+        var meta = Meta()
+        meta.agentId = json["agentId"] as? String
+        meta.name = json["name"] as? String
+        meta.createdAt = json["createdAt"] as? Double
+        meta.lastUsedModel = json["lastUsedModel"] as? String
+        return meta
+    }
+
+    /// Cursor Agent uses MD5(workspace_path) as the project directory hash.
+    static func projectHash(for workspacePath: String) -> String {
+        let digest = Insecure.MD5.hash(data: Data(workspacePath.utf8))
+        return digest.map { String(format: "%02x", $0) }.joined()
+    }
+
+    private func dataFromHex(_ hex: String) -> Data? {
+        let chars = Array(hex)
+        guard chars.count % 2 == 0 else { return nil }
+        var data = Data(capacity: chars.count / 2)
+        var i = 0
+        while i < chars.count {
+            guard let byte = UInt8(String(chars[i..<i+2]), radix: 16) else { return nil }
+            data.append(byte)
+            i += 2
+        }
+        return data
+    }
+}

macos/Sources/Features/Worktrunk/WorktrunkPreferences.swift

@@ -4,6 +4,7 @@ enum WorktrunkAgent: String, CaseIterable, Identifiable {
     case claude
     case codex
     case opencode
+    case agent
 
     var id: String { rawValue }
 
@@ -12,6 +13,7 @@ enum WorktrunkAgent: String, CaseIterable, Identifiable {
         case .claude: return "Claude Code"
         case .codex: return "Codex"
         case .opencode: return "OpenCode"
+        case .agent: return "Cursor Agent"
         }
     }
 
@@ -20,6 +22,7 @@ enum WorktrunkAgent: String, CaseIterable, Identifiable {
         case .claude: return "claude"
         case .codex: return "codex"
         case .opencode: return "opencode"
+        case .agent: return "agent"
         }
     }
 
@@ -75,6 +78,7 @@ enum WorktrunkDefaultAction: String, CaseIterable, Identifiable {
     case claude
     case codex
     case opencode
+    case agent
 
     var id: String { rawValue }
 
@@ -84,6 +88,7 @@ enum WorktrunkDefaultAction: String, CaseIterable, Identifiable {
         case .claude: return "Claude Code"
         case .codex: return "Codex"
         case .opencode: return "OpenCode"
+        case .agent: return "Cursor Agent"
         }
     }
 
@@ -93,6 +98,7 @@ enum WorktrunkDefaultAction: String, CaseIterable, Identifiable {
         case .claude: return .claude
         case .codex: return .codex
         case .opencode: return .opencode
+        case .agent: return .agent
         }
     }