josephyaduvanshi

josephyaduvanshi / claude-history-manager

Public

A native macOS browser for your Claude Code session history. Search, pin, tag, resume sessions in any terminal. Transcripts stay on your Mac.

github.comjosephyaduvanshiclaude-history-manager
17
0
100% credibility
Found Apr 26, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Chronicle is a native macOS app that indexes local Claude Code session histories for easy searching, resuming conversations, viewing stats, and organizing with tags and pins.

How It Works

1
🔍 Discover Chronicle

You hear about Chronicle from a developer friend or GitHub—it's a simple app that organizes your messy Claude Code chat histories so you never lose that one fix again.

2
📥 Install with one command

Grab it via Homebrew or download the app—drag to Applications and run the quick setup command if needed.

3
⚡ Launch and watch it index

Open the app, grant folder access once, and it quietly scans your Claude projects folder to build a fast searchable list.

4
⭐ Browse your full history

See all your sessions organized by project, with search, pins, tags, stats, and live indicators for active chats—everything at your fingertips.

5
🚀 Resume any chat instantly

Click a session to jump back in your favorite terminal or editor, picking up exactly where you left off.

🎉 Never lose a coding session again

Your Claude chats are now searchable, organized, and ready to resume anytime, saving hours of digging through files.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 17 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-history-manager?

Chronicle is a claude code history manager: a native macOS app that indexes your Claude Code session transcripts from ~/.claude/projects/ into a local SQLite database with full-text search. It lets you search, pin, tag, and resume sessions in one keystroke from any terminal like Ghostty, iTerm, or WezTerm, plus view stats and heatmaps—all while keeping transcripts on your Mac. Built in Swift with SwiftUI, it includes a lightweight Linux CLI for remote servers.

Why is it gaining traction?

No more scrolling ls -lt or grepping massive JSONL files at midnight—slash commands like /full: hit FTS instantly, smart folders track "Today" or "git push" sessions, and global hotkeys toggle a menubar browser for live/recent/pinned items. Resume launches your preferred terminal and editor (VS Code, Cursor, Zed) side-by-side, with iCloud metadata sync across machines. As a native macOS app, it feels snappy, with Quick Look previews and themes matching GitHub's UI.

Who should use this?

Claude Code power users on macOS with dozens of workspaces, drowning in session history and needing fast search/resume for bug fixes or experiments. Terminal-heavy devs who switch between Ghostty/iTerm/WezTerm and want stats on token spend per project. Linux remote workers can grab the CLI for quick searches without the GUI.

Verdict

Grab it if you're deep into Claude Code—polished docs, Homebrew cask, and solid tests make setup painless despite 17 stars and 1.0% credibility score. Still alpha-ish (macOS 15 only, ad-hoc signed), so test on a side machine first.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.