Chronicle is a native macOS app that turns your CLI coding-assistant session history into something you can actually browse. It reads session files from Claude Code, Codex CLI, and Gemini CLI directly from your Mac, indexes everything into a local SQLite database, and gives you instant search, smart folders, transcript rendering, and one-click session resume — all without sending any data off your machine.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/josephyaduvanshi/claude-history-manager/llms.txt
Use this file to discover all available pages before exploring further.
Install Chronicle
Install via Homebrew, .pkg, .dmg, or build from source. Get running in minutes.
First launch
What to expect on first launch, Gatekeeper prompts, and initial indexing.
Search sessions
Full-text FTS5 search and slash-filter syntax for finding any session fast.
Resume sessions
Pick up any session in Ghostty, iTerm, Terminal.app, Alacritty, WezTerm, or kitty.
What Chronicle does
Chronicle solves the problem of three CLI coding assistants writing session transcripts in three different formats to three different corners of your home directory. After a few weeks of real use, those folders are unreadable and ungrepable.Multi-provider
Reads Claude Code (
~/.claude/projects/), Codex CLI (~/.codex/sessions/), and Gemini CLI (~/.gemini/tmp/) with full per-provider data isolation.Local-first
Transcripts never leave your Mac. The SQLite index lives in
~/Library/Application Support/Chronicle/. No telemetry, no cloud upload.Fast search
Title search is instant from the indexed metadata. Type
/full: to drop into FTS5 transcript search across every session body.Core features
Session browser
Color-coded workspace sidebar, live session detection, and per-provider filtering.
Smart folders
Built-in and custom saved searches filtering by date, tags, token count, and keywords.
Transcript view
Markdown-rendered conversations with syntax-highlighted code, collapsible tool calls, and a TOC sidebar.
Stats dashboard
Per-project token usage, cost estimates, and activity heatmaps.
Get started
Install Chronicle
Launch and index
Open Chronicle from
/Applications/. On first launch it indexes your session history — about 60–90 seconds for a few thousand sessions. Grant Full Disk Access in System Settings if the sidebar is empty.Browse and search
Use the workspace sidebar to browse by project. Press
⌘K to focus the search bar. Type /full: your query to search transcript bodies with FTS5.Chronicle requires macOS 15 or newer. It uses SwiftUI APIs and font features that ship in macOS 15.