SpecStory is a Visual Studio Code extension that makes it easy to save, search and share your AI chat history.
- It exports 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.
We support Cursor IDE and GitHub Copilot as of release v0.11.0 (changelog).
- For Cursor: It is tested to work for
Version: 0.43.6and later - For Copilot: It is tested to work for
Version: 1.300.0and later
When enabled, SpecStory automatically saves every AI chat 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.
| Step | GitHub Copilot | Cursor | Install from VSIX |
|---|---|---|---|
| 1 | Open VSCode with GitHub Copilot installed and activated. | Open Cursor. | Make sure you're on the latest version of GitHub Copilot or Cursor. |
| 2 | Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X). | Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X). | Download our extension: specstory-vscode-latest.vsix |
| 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. | From either editor, pop open the Command Palette (Ctrl/CMD-Shift-P) and choose Extensions: Install from VSIX…. |
| 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. |
To verify the installation, open the Command Palette again (Ctrl/CMD-Shift-P) and type SpecStory. You should see the available commands show up. |
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! 🧠
Note
The extension is in rapid, active development. If you're not on Cursor Version: 0.43.6 or later you might experience errors due to the way versions of Cursor prior to 0.43.5 stored chat and composer data that have since changed.
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.
[