Repository Public
1import Foundation23/// The installed official Claude Code CLI, discovered on disk and never modified.4public struct ClaudeCLI: Sendable, Hashable {5 public let path: String6 public let version: String?78 public init(path: String, version: String?) {9 self.path = path10 self.version = version11 }12}1314public enum ClaudeCLIDiscovery {15 /// Candidate locations in priority order after `$PATH`.16 public static let extraSearchPaths: [String] = {17 let home = FileManager.default.homeDirectoryForCurrentUser.path18 return ["/opt/homebrew/bin", "/usr/local/bin", "\(home)/.claude/local/bin", "\(home)/.claude/local", "\(home)/.local/bin", "\(home)/.npm-global/bin", "\(home)/.volta/bin"]19 }()2021 /// Finds `claude` and reads `claude --version` (timeout 8 s). Returns nil when not installed.22 public static func discover(environmentPath: String? = ProcessInfo.processInfo.environment["PATH"]) -> ClaudeCLI? {23 var dirs = (environmentPath ?? "").split(separator: ":").map(String.init)24 dirs += extraSearchPaths25 var seen = Set<String>()26 for dir in dirs where !dir.isEmpty && seen.insert(dir).inserted {27 let candidate = (dir as NSString).appendingPathComponent("claude")28 if FileManager.default.isExecutableFile(atPath: candidate) {29 return ClaudeCLI(path: candidate, version: version(at: candidate))30 }31 }32 return nil33 }3435 /// Runs `<path> --version` and returns the first line (e.g. "2.1.316 (Claude Code)").36 public static func version(at path: String, timeout: TimeInterval = 8) -> String? {37 let process = Process()38 process.executableURL = URL(fileURLWithPath: path)39 process.arguments = ["--version"]40 let pipe = Pipe()41 process.standardOutput = pipe42 process.standardError = FileHandle.nullDevice43 do { try process.run() } catch { return nil }44 let deadline = Date().addingTimeInterval(timeout)45 while process.isRunning && Date() < deadline { Thread.sleep(forTimeInterval: 0.05) }46 if process.isRunning { process.terminate(); return nil }47 let data = pipe.fileHandleForReading.readDataToEndOfFile()48 return String(decoding: data, as: UTF8.self).split(whereSeparator: \.isNewline).first.map(String.init)49 }50}5152/// Builds the argv for an interactive Claude Code session. Only documented flags are used53/// (`claude --help` on 2.1.316: `--session-id <uuid>`, `--resume <id>`, `--settings <file-or-json>`).54public enum ClaudeLaunchBuilder {55 public static func arguments(sessionID: UUID, resume: Bool, hooksSettingsPath: String?, extraArguments: [String] = []) -> [String] {56 var args: [String] = []57 if resume {58 args += ["--resume", sessionID.uuidString.lowercased()]59 } else {60 args += ["--session-id", sessionID.uuidString.lowercased()]61 }62 if let hooksSettingsPath {63 args += ["--settings", hooksSettingsPath]64 }65 args += extraArguments66 return args67 }68}69