Get Started
SpecStory Extension
BearClaude for macOS
FAQs & Privacy
FAQs
Frequently asked questions about SpecStory and BearClaude.
SpecStory is tested to work with:
- Cursor: every version after
v0.43.5 - Copilot: every version after
v1.300.0 - 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:
-
Tell your friends about SpecStory.
-
Introduce us to a colleague at work.
-
Consider purchasing BearClaude when it launches.
-
Leave a review on the VS Code Marketplace
-
Talk about us on Cursor Reddit, Cursor Forums, GitHub Copilot Reddit, X.com, BlueSky and LinkedIn.
-
Follow us on LinkedIn, X.com and BlueSky. Star us on GitHub.
We get this question a lot! Each AI Code IDE stores chats in differing formats and locations. All are subject to change at anytime. We’re currently focused on making the best possible extension for GitHub Copilot & Cursor 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 code editors? 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!
-
Drop us a line at support@specstory.com.
-
Join our Slack community and ping us directly
-
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!
Was this page helpful?