You don’t write prompts. You author intent. Enhance your AI development workflow with SpecStory.
- Enhance Current Workflows: Use our free extensions for Cursor IDE, GitHub Copilot and Claude Code to save, search and share your AI chat history.
- Spec-First Development: Try our new macOS desktop app BearClaude (Alpha) that helps you write specs to generate code.
Join the developers using our extensions in their favorite IDEs.
- They export your AI chats in searchable structured Markdown that you can version.
- Never lose a great solution, easily share interactions, and use conversation history to refine custom instructions and project rules.
- For Cursor: It is tested to work for
Version: 0.43.6and later. (Read changelog) - For Copilot: It is tested to work for
Version: 1.300.0and later (Read cangelog) - For Claude Code: It is tested to work for
Version: 1.0.27and later (Read changelog)
- For Cursor: It is tested to work for
When enabled, our extensions automatically save your AI chats to your local project's .specstory directory.
To learn about additional features, check out our website and read the docs.
1️⃣ We recommend installing directly from the Extension Marketplace in your preferred editor, or via Homebrew for Claude Code. For more installation options, consult our docs.
| Step | GitHub Copilot | Cursor | Claude Code |
|---|---|---|---|
| 1 | Open VSCode with GitHub Copilot installed and activated. | Open Cursor. | Install via Homebrew: brew tap specstoryai/tap && brew install specstory |
| 2 | Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X). | Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X). | Run specstory to launch Claude Code with automatic session saving. |
| 3 | Click Install. Consult our Changelog to make sure you're on the latest version. | Click Install. Consult our Changelog to make sure you're on the latest version. | Your sessions are automatically saved to .specstory/history/ in your current project directory. |
| 4 | Once installed, SpecStory automatically saves your Copilot chats to the .specstory folder in your project. |
Once installed, SpecStory automatically saves your Cursor chats to the .specstory folder in your project. |
Use -s flag to sync sessions or -u to convert specific sessions to markdown. |
Note
As a Cursor user, if you try to install from the Visual Studio Marketplace website banner you might find yourself in a state where VSCode has SpecStory installed but Cursor doesn't. It makes for a bad time
2️⃣ Take a quick spin through our docs, they explain installation details in more depth.
3️⃣ Love the extension? Help others discover their AI assistant's memory upgrade by dropping a quick review! 🧠
Don't quite need a full AI IDE? Try a simpler way. Rushing into code gen without clear intent and requirements leads to wasted effort.
Try BearClaude our new macOS-specific tool in Alpha. It features:
- Three-pane layout: Document sidebar, editor, and Claude Code terminal for seamless workflow
- Requirements: macOS 15+ on Apple Silicon
- Key workflow: Think → Execute → Save → Repeat
- Integration: Works directly with Claude Code for auto-saving docs and chats locally
- Focus: Preserves development intent and context throughout your coding sessions
We think its just right for minimalist AI-first developers that want to focus on maintaining specs, chats and documentation alongside code. Read more about why we are making this and follow along as we do (Read changelog)
Take a look at our docs for more details about configuration, features and settings.
Note
All products are in rapid, active development and we are actively monitoring this repo. Please use it to file bugs and feature enhancements. We'd love to hear from you!
We welcome edits and contribution to our documentation. Just issue a pull request against our docs repo.
- X/Twitter: @specstoryai
- LinkedIn: SpecStory
- Slack: Join our community
[
