Skip to main content
SpecStory is tested to work with:
  • Cursor: every version after v0.43.5
  • Copilot: every version after v1.300.0
  • Codex CLI: every version after 0.42.0
  • Cursor CLI: every version after 2025.09.18-7ae6800
  • Claude Code: every version after v1.0.27
The SpecStory Extension is free as in beer 🍺. Enjoy! BearClaude is available for free during the Alpha, but will have paid tiers when we launch.
Sharing is caring! We’d absolutely love if you could:
We get this question a lot! Each AI coding tool stores chats in differing formats and locations. All are subject to change at anytime. We’re currently focused on supporting the broadest set of tools with SpecStory.BearClaude takes a different approach as a standalone macOS app with integrated Claude Code, so it doesn’t depend on other editors.We would like to make SpecStory available for Windsurf. Tell them your interested in making your chats available on this issue!Curious about the hype around the different AI coding tools? Us too. That’s why we created the AI Editor Tracker to follow the sentiment.
In a nutshell, SpecStory allows you to save and share your AI conversation history.For Cursor, it reads your local chat history directly from a sqlite3 database. This is located in different paths depending on your operating system:
  • Windows: %APPDATA%\Cursor\User\globalStorage\state.vscdb
  • MacOS: ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
  • Linux: ~/.config/Cursor/User/globalStorage/state.vscdb
For GitHub Copilot, it reads your local chat history directly from chat jsons:
  • Windows: %APPDATA%\Code\User\workspaceStorage\{hash}\chatSessions
  • MacOS: ~/Library/Application Support/Code/User/workspaceStorage/{hash}/chatSessions
  • Linux: ~/.config/Code/User/workspaceStorage/{hash}/chatSessions
For Claude Code, the SpecStory CLI wrapper acts as a launcher that:
  • Runs Claude Code while capturing your conversations
  • Reads session files from ~/.claude/projects/ (JSONL format)
  • Converts them to markdown and saves to .specstory/history/ in your project
  • Works on macOS, Linux, and Windows
BearClaude is a standalone macOS application that provides a three-pane interface combining document management, markdown editing, and Claude Code integration. It automatically saves your Claude Code conversations to your project’s .specstory folder.For more detail about each feature check out our feature pages. For insight into what data we collect and access look at our data privacy page.
Don’t be shy: we’d absolutely love to hear from you and promise to be extra responsive!
  1. Drop us a line at support@specstory.com.
  2. Join our Slack community and ping us directly
  3. File an issue on github.
Both tools are still in active development with rapid iterations. We’ve talked about this internally but have not made a decision.We do strive to be as open as possible in terms of how they work, what data is accessed and stored and what our policy is.
Not today. We do not conduct write operations on the state.vscdb or the Shadow Workspace Cursor maintains. We do not modify the workspaceStorage directory Copilot maintains.You can @ reference (in Cursor) or # reference (Copilot) these files to provide context to your AI though!