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)

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

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

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