ClaudeSessions

A native macOS app for browsing, searching, and reviving your local Claude Code (CLI) sessions.

If you use the Claude CLI heavily, your ~/.claude/projects/ folder fills up with hundreds of .jsonl transcripts. The CLI has no built-in browser for them. ClaudeSessions is what fills that gap: a fast three-pane reader that loads every session, groups continuations together, makes the whole archive searchable, costs them up, and lets you jump back into any one with a single click.

It's built in SwiftUI for macOS 13+, signed locally, and reads your transcripts directly off disk — nothing leaves your machine.

---

What it does

• Three-pane browser — projects on the left, sessions in the middle, full transcript on the right. Resizable splits, keyboard-navigable, dark + light themes.
• Full-text search across every transcript with a debounced index, plus metadata search on titles, models, and Claude Desktop accounts.
• Continuation grouping — sessions resumed via --resume or chained from another session are detected and shown as a single group, with a combined cost.
• Token usage and spend tracking — input / output / cache-read / cache-write tokens per session, USD cost per model, weekly + monthly trend buckets.
• Markdown + LaTeX rendering in the transcript pane (Marked.js + DOMPurify + MathJax SVG, sandboxed in a WKWebView).
• Apple Intelligence integration (macOS 26+, opt-in): auto-name untitled sessions, generate session summaries, summarize tool-call runs, and ask grounded questions about a session — all via the on-device FoundationModels framework. Cached to disk so summaries persist across launches.
• Resume command builder — one click copies a cd … && claude --resume <id> command for any session.
• Pin, rename, and recycle bin — soft delete with 30-day retention. Restorable. Bulk actions for empty / zero-usage cleanup.
• Theme editor — full palette control + panel materials (solid / blur / Liquid Glass on macOS 26).

Screenshots

Browser, sessions, transcript — searchable across the whole archive.

Markdown + LaTeX rendering, tool-call summaries, on-device Apple Intelligence.

Drop PNGs at docs/screenshots/three-pane.png and docs/screenshots/transcript-detail.png to populate this section.

Requirements

• macOS 13.0 or later (some features require macOS 26)
• Xcode 15+ to build
• An existing ~/.claude/projects/ directory populated by the Claude CLI

Build & run

git clone https://github.com/taikunudel/ClaudeSessions.git
cd ClaudeSessions
open ClaudeSessions.xcodeproj

Then in Xcode:

1. Select the ClaudeSessions scheme.
2. Open the project's Signing & Capabilities tab and pick your own Apple Developer team. (The repo ships with the team field blank.)
3. ⌘R to run.

For an unsigned local build, you can also run:

xcodebuild -project ClaudeSessions.xcodeproj -scheme ClaudeSessions -configuration Release build

Architecture, briefly

• Models/ — Session, Message, pricing catalog, spend analytics.
• Services/SessionLoader.swift — SessionStore: file scanning, JSONL parsing, on-disk cache, full-text index, recycle bin, automatic rescan on idle CPU.
• Services/SessionAutoTitleGenerator.swift — Apple Intelligence title / summary / Q&A / tool-call summarization with disk-backed caches.
• Views/ContentView.swift — three-pane layout, debounced search.
• Views/ConversationView.swift — transcript detail, prerendering pipeline.
• Views/MessageBubble.swift — message rendering, markdown WebView host, layout cache.
• Views/SessionListView.swift — list / group rows, disjoint-set continuation grouping.
• Views/ClaudeTheme.swift — palette, panel surfaces (frosted / Liquid Glass), font sizing.

Privacy

The app reads ~/.claude/projects/ and ~/Library/Application Support/Claude/ directly. It does not make any network calls. Apple Intelligence features run on-device via FoundationModels. Title and summary metadata are appended to each session's .jsonl as new custom-title / custom-summary records.

Status

Early. There are known robustness issues — see the open issues. PRs welcome, especially around:

• Replacing the in-place .jsonl append for title/summary metadata with a sidecar file (avoids races with the Claude CLI).
• Streaming JSONL parsing (currently slurps full files).
• Bounded prerender state (TranscriptConversationPrerenderer).

License

MIT.