Claude History Manager

Chronicle

A native macOS browser for your CLI coding-assistant session history — Claude Code, Codex CLI, and Gemini CLI. Reads each provider's session storage directly. Per-provider data isolation. Indexes everything into local SQLite. Resumes any session in one keystroke.

If this saves you from grepping JSONL files at 1am, star the repo. Thanks.

Install • Linux CLI • First launch • How it works • Features • Privacy • Shortcuts • Configuration • FAQ • License

---

Three CLI coding assistants, three different transcript formats, all sitting in different corners of your home directory. Claude Code writes JSONL under ~/.claude/projects/. Codex CLI writes JSONL under ~/.codex/sessions/. Gemini CLI writes single JSON files under ~/.gemini/tmp/. After a few weeks of real use, those folders are unreadable, ungreppable, and the only way to find the session where you actually solved that one bug is to remember which workspace you were in and scroll through ls -lt. Chronicle reads all three, indexes every session into a local SQLite database, and gives you somewhere to actually look at them. Per-provider data isolation: switching providers swaps every list, count, and stat, so a Claude pin doesn't leak into your Codex sidebar. Pin the ones that matter. Tag the ones you're tracking. Resume any of them in one keystroke, in whichever terminal you prefer.

Transcripts never leave the Mac they were written on.

---

Install

Homebrew (recommended)

brew tap josephyaduvanshi/chronicle
brew install --cask chronicle

The cask handles the download, the drag into /Applications, and the Gatekeeper unquarantine step in one go. To update later:

brew update                              # refreshes the tap; the tap auto-bumps on every release
brew upgrade --cask chronicle

If you previously installed Chronicle by dragging the .app manually and now want Homebrew to take over, add --force:

brew install --cask chronicle --force    # overwrites the manual install + registers it with brew

If brew install reports a 404 on the DMG, your local tap cache is stale — run brew update first.

Tap source: josephyaduvanshi/homebrew-chronicle.

Installer (.pkg)

For the lowest-friction install without Homebrew. Download Chronicle-<version>.pkg from the latest GitHub Release, double-click, follow the prompts. The installer drops Chronicle.app in /Applications/ and strips the Gatekeeper quarantine via a postinstall script. macOS will warn that the package isn't signed by an identified developer; right-click the .pkg and choose Open the first time.

Disk image (.dmg)

Download Chronicle-<version>.dmg from the release page, mount it, drag Chronicle.app onto the Applications shortcut, then run:

xattr -cr /Applications/Chronicle.app

Download the .zip

1. Grab Chronicle-<version>.zip from the latest GitHub Release.
2. Unzip and drag Chronicle.app into /Applications/.
3. Strip the Gatekeeper quarantine attribute so macOS will launch the ad-hoc-signed binary: