Cursor Chronicle – search, export, and analyze your Cursor chat history

Hey everyone!

I’ve been using Cursor for a while now and realized I had no easy way to look back at my old conversations. Wanted to find that one chat where I solved a tricky bug? Good luck scrolling through hundreds of dialogs. Needed to see how much I actually use the AI features? No stats anywhere.

So I built Cursor Chronicle – a CLI tool that lets you:

  • Search across all your chat history (finally found that regex solution from 3 months ago)
  • Export conversations to Markdown (great for Obsidian or just keeping backups)
  • View stats – messages, tokens, tool calls, activity by project
  • Browse dialogs by date, project, or just see what you worked on last week

It reads directly from Cursor’s internal SQLite databases, so no API keys or cloud stuff needed. Pure Python, zero dependencies.

Quick examples

# Search for anything across all history
search-history "authentication bug"

# See your last 30 days of activity
cursor-chronicle --stats

# Export everything to markdown
cursor-chronicle --export

The README also documents Cursor’s internal database structure pretty thoroughly – might be useful if anyone else wants to build tools around it.

GitHub: GitHub - mikhailsal/cursor-chronicle · GitHub

Would love to hear if this is useful to anyone, and happy to take feature requests. Still figuring out what else would be worth adding.

This sounds pretty neat! But I get a 404 on your github repo, can you check the visibility settings?

Sorry, the broken link fixed: GitHub - mikhailsal/cursor-chronicle · GitHub

Nice, would be great to have a skill around it.

1 Like