- **Session explorer**: Right-click a project and choose "Explore Sessions" (or press Cmd+Shift+E) to browse all past Claude sessions. View the full conversation timeline, resume or fork from any point, and bookmark favorite sessions with a star toggle. Optionally summarize sessions and per-turn actions with Haiku — summaries are cached and incrementally updated when sessions are continued.

newFolderItem.setShortcut(for: .newSidebarFolder)

let moveOutItem = NSMenuItem(title: "Move Out of Folder", action: #selector(moveCurrentProjectOutOfFolder), keyEquivalent: "")

moveOutItem.setShortcut(for: .moveOutOfFolder)

moveOutItem.target = self

fileMenu.addItem(moveOutItem)

let exploreSessionsItem = NSMenuItem(title: "Explore Sessions", action: #selector(exploreSessions), keyEquivalent: "")

exploreSessionsItem.setShortcut(for: .exploreSessions)

fileMenu.addItem(exploreSessionsItem)

@objc private func exploreSessions() {

windowController?.exploreCurrentProjectSessions()

}

@objc private func moveCurrentProjectOutOfFolder() {

windowController?.moveCurrentProjectOutOfFolder()

}

static let exploreSessions = Self("exploreSessions", default: .init(.e, modifiers: [.command, .shift]))

static let newSidebarFolder = Self("newSidebarFolder", default: .init(.n, modifiers: [.command, .option]))

static let moveOutOfFolder = Self("moveOutOfFolder", default: .init(.u, modifiers: [.command, .option]))

ShortcutEntry(name: .exploreSessions, label: "Explore Sessions"),

ShortcutEntry(name: .newSidebarFolder, label: "New Sidebar Folder"),

ShortcutEntry(name: .moveOutOfFolder, label: "Move Out of Folder"),

let messageCount: Int

firstUserMessage: firstMessage,

messageCount: 0

/// Parses a session JSONL file and returns an ordered list of user turns.

/// Deduplicates by promptId — only the first occurrence with non-empty content is kept.

func parseTimeline(sessionId: String, projectPath: String) -> [TimelineEntry] {

let encoded = projectPath.claudeProjectDirName

let jsonlPath = NSHomeDirectory() + "/.claude/projects/\(encoded)/\(sessionId).jsonl"

guard let data = try? Data(contentsOf: URL(fileURLWithPath: jsonlPath)),

let content = String(data: data, encoding: .utf8) else { return [] }

var entries: [TimelineEntry] = []

var seenPromptIds = Set<String>()

let iso8601 = ISO8601DateFormatter()

iso8601.formatOptions = [.withInternetDateTime, .withFractionalSeconds]

for line in content.components(separatedBy: "\n") where !line.isEmpty {

guard let lineData = line.data(using: .utf8),

let json = try? JSONSerialization.jsonObject(with: lineData) as? [String: Any],

let type = json["type"] as? String, type == "user",

let promptId = json["promptId"] as? String,

!seenPromptIds.contains(promptId) else { continue }

let msg = json["message"] as? [String: Any]

var text = ""

if let content = msg?["content"] as? String {

text = content

} else if let contentArr = msg?["content"] as? [[String: Any]] {

text = contentArr.first(where: { $0["type"] as? String == "text" })?["text"] as? String ?? ""

}

// Skip empty continuation messages (same promptId, no content)

guard !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {

seenPromptIds.insert(promptId)

continue

}

seenPromptIds.insert(promptId)

let timestamp: Date?

if let ts = json["timestamp"] as? String {

timestamp = iso8601.date(from: ts)

} else {

timestamp = nil

}

entries.append(TimelineEntry(

index: entries.count,

promptId: promptId,

message: text.trimmingCharacters(in: .whitespacesAndNewlines),

timestamp: timestamp,

actionSummary: nil

))

}

return entries

}

/// Extracts a raw description of tool uses for each user turn in a session.

/// Returns a dictionary mapping turn index to a list of action descriptions.

func parseActions(sessionId: String, projectPath: String) -> [Int: [String]] {

let encoded = projectPath.claudeProjectDirName

let jsonlPath = NSHomeDirectory() + "/.claude/projects/\(encoded)/\(sessionId).jsonl"

guard let data = try? Data(contentsOf: URL(fileURLWithPath: jsonlPath)),

let content = String(data: data, encoding: .utf8) else { return [:] }

var result: [Int: [String]] = [:]

var currentTurnIndex = -1

var seenPromptIds = Set<String>()

for line in content.components(separatedBy: "\n") where !line.isEmpty {

guard let lineData = line.data(using: .utf8),

let json = try? JSONSerialization.jsonObject(with: lineData) as? [String: Any],

let type = json["type"] as? String else { continue }

if type == "user", let promptId = json["promptId"] as? String,

!seenPromptIds.contains(promptId) {

let msg = json["message"] as? [String: Any]

var text = ""

if let c = msg?["content"] as? String {

text = c

} else if let arr = msg?["content"] as? [[String: Any]] {

text = arr.first(where: { $0["type"] as? String == "text" })?["text"] as? String ?? ""

}

guard !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {

seenPromptIds.insert(promptId)

continue

}

seenPromptIds.insert(promptId)

currentTurnIndex += 1

} else if type == "assistant", currentTurnIndex >= 0 {

let msg = json["message"] as? [String: Any]

let inner = msg?["message"] as? [String: Any] ?? msg

guard let contentArr = inner?["content"] as? [[String: Any]] else { continue }

for block in contentArr {

guard block["type"] as? String == "tool_use",

let name = block["name"] as? String else { continue }

let input = block["input"] as? [String: Any] ?? [:]

var desc = name

if let fp = input["file_path"] as? String {

let filename = (fp as NSString).lastPathComponent

desc = "\(name) \(filename)"

} else if let cmd = input["command"] as? String {

let brief = cmd.components(separatedBy: "\n").first ?? cmd

desc = "\(name): \(String(brief.prefix(50)))"

} else if let pattern = input["pattern"] as? String {

desc = "\(name) \(pattern)"

}

result[currentTurnIndex, default: []].append(desc)

}

}

}

return result

}

/// Creates a truncated copy of a session JSONL, keeping everything up to (and including

/// the full response for) the Nth unique user turn. Returns the new session ID.

func truncateSession(sessionId: String, projectPath: String, afterTurnIndex: Int) -> String? {

let encoded = projectPath.claudeProjectDirName

let dir = NSHomeDirectory() + "/.claude/projects/\(encoded)"

let jsonlPath = dir + "/\(sessionId).jsonl"

guard let data = try? Data(contentsOf: URL(fileURLWithPath: jsonlPath)),

let content = String(data: data, encoding: .utf8) else { return nil }

let lines = content.components(separatedBy: "\n")

var seenPromptIds = Set<String>()

var uniqueTurnCount = -1 // will be incremented to 0 on first user turn

var cutoffLineIndex = lines.count

for (i, line) in lines.enumerated() where !line.isEmpty {

guard let lineData = line.data(using: .utf8),

let json = try? JSONSerialization.jsonObject(with: lineData) as? [String: Any],

let type = json["type"] as? String, type == "user",

let promptId = json["promptId"] as? String,

!seenPromptIds.contains(promptId) else { continue }

// Check if this user message has actual content (not a continuation)

let msg = json["message"] as? [String: Any]

var text = ""

if let c = msg?["content"] as? String {

text = c

} else if let arr = msg?["content"] as? [[String: Any]] {

text = arr.first(where: { $0["type"] as? String == "text" })?["text"] as? String ?? ""

}

guard !text.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty else {

seenPromptIds.insert(promptId)

continue

}

seenPromptIds.insert(promptId)

uniqueTurnCount += 1

// When we hit the turn AFTER the one we want, cut here

if uniqueTurnCount > afterTurnIndex {

cutoffLineIndex = i

break

}

}

let truncatedLines = lines.prefix(cutoffLineIndex).filter { !$0.isEmpty }

let truncatedContent = truncatedLines.joined(separator: "\n") + "\n"

let newSessionId = UUID().uuidString.lowercased()

let newPath = dir + "/\(newSessionId).jsonl"

guard let writeData = truncatedContent.data(using: .utf8) else { return nil }

do {

try writeData.write(to: URL(fileURLWithPath: newPath), options: .atomic)

return newSessionId

} catch {

return nil

}

}