← Reddit

Built a macOS app to search and resume Claude Code sessions

Reddit · joseph_yaduvanshi · April 26, 2026
A developer created Chronicle, a native macOS menubar application that indexes Claude Code sessions with full-text search, enabling users to quickly locate and resume specific conversations directly in their terminal. The tool is built with native Swift and SQLite with FTS5 for local indexing and also supports Codex CLI and Gemini CLI. Chronicle is open-source under the MIT license and available via Homebrew.

Detailed Analysis

Chronicle, a native macOS menubar application built by developer Joseph Yaduvanshi, addresses a friction point that has emerged as Claude Code gains adoption among power users: the difficulty of navigating an ever-growing archive of AI-assisted coding sessions. As developers accumulate hundreds of session files in the `~/.claude/projects/` directory, locating a specific past conversation — one containing a particular bug fix, architectural decision, or code snippet — becomes an increasingly manual and time-consuming process. Chronicle solves this with full-text search powered by SQLite and the FTS5 extension, indexing all local session files and enabling users to click a search result to resume the corresponding session directly in their terminal. The project is MIT licensed, built entirely in Swift, processes everything locally, and is available via `brew install --cask chronicle`.

The tool is part of a small but growing ecosystem of third-party utilities designed to extend and smooth out the Claude Code developer experience. A parallel project, ccrider (developed by Neil Berkman), takes a slightly different approach — offering a TUI-based session browser, CLI interface, and notably an MCP (Model Context Protocol) server that allows Claude itself to search back through prior sessions for context during active conversations. The existence of multiple independent projects converging on the same problem signal that session management is a genuine gap in Claude Code's native capabilities. The built-in `claude --resume` command, while functional, surfaces sessions from all projects indiscriminately, lacking the scoped, searchable interface that multi-project developers require.

The broader significance of Chronicle and its counterparts lies in what they reveal about the maturation arc of AI-assisted development workflows. Claude Code has moved beyond novelty into sustained, professional use — a transition evidenced by the fact that developers are now building infrastructure *around* it rather than merely experimenting with it. The concept of "AI session history as a searchable knowledge base" is a meaningful shift in how developers relate to their tooling: a conversation with Claude Code is no longer ephemeral but is increasingly treated as a durable artifact worth indexing, retrieving, and resuming. This mirrors the evolution seen in other developer tools, where third-party ecosystems (plugins, wrappers, extensions) standardize before the core product absorbs the patterns.

Chronicle's multi-tool support — covering Codex CLI and Gemini CLI alongside Claude Code — further reflects a pragmatic reality for developers operating in heterogeneous AI environments. Rather than committing to a single assistant, many professionals are running parallel experiments across providers, and a unified session manager that spans tools reduces context-switching costs. Yaduvanshi's decision to support competing CLIs in an open-source, locally-run application positions Chronicle as infrastructure-layer tooling rather than a product tied to any single AI provider. The local-first, privacy-preserving architecture (no cloud dependency, all SQLite) is also a deliberate design choice that aligns with developer preferences for tools handling potentially sensitive codebases and proprietary business logic.

Anthropic has not yet shipped native session search or cross-project history management in Claude Code, leaving that surface area open for the community. Whether tools like Chronicle and ccrider represent temporary workarounds that will eventually be superseded by first-party features — or whether they define a persistent third-party tooling layer — depends on how Anthropic prioritizes developer ergonomics in Claude Code's roadmap. For now, the rapid emergence of multiple independent solutions to the same session-management problem constitutes a clear signal of unmet demand, and projects like Chronicle demonstrate that the Claude Code user base is sophisticated enough to build the scaffolding it needs when the core product leaves gaps.

Read original article →