SpecStory (Cursor Extension)

Capture, search and learn from every AI coding journey.

What is SpecStory?

Today SpecStory is a Visual Studio Code extension built for Cursor users. It enables you to:

Extract and store all AI coding interactions in human and LLM readable Markdown and JSON formats
Share these coding interactions on the web with others

Enhance your software composer workflow by capturing and saving your AI coding interactions.

Some things you can do with SpecStory:

Save or commit these logs to your git repository for your own future reference.
Reference these logs locally in your composer sessions with @ references to provide additional context to Cursor Composer.
Share these logs with others via a unique URL hosted at share.specstory.com.
Store your shares in your task management system of choice.

Important Notes

Note: This extension only works with the Cursor fork of Visual Studio Code.

Installing the extension directly from the VSC Marketplace will install it into VSC, and not into Cursor.

Instead, to install SpecStory into Cursor:

Download the VSIX file directly from this page from the "Download Extension" link under "Resources" to the right.
Next, open the Command Palette (CMD/Ctrl-Shift-P) and choose Extensions: Install from VSIX…
Select the VSIX file that you downloaded above
Verify that "SpecStory (Cursor Extension)" appears in Extensions sidebar

Note: Cursor changed the internal storage of Chats and Composers in Cursor version 0.43.6. Chats and Composers created with version 0.43.5 and earlier cannot be saved or shared with this extension.

Getting Started

Read our documentation at docs.specstory.com to learn more about how to use SpecStory.

Never lose your composer and chat history

Save your composer history and chat history from your active project to a local markdown file by opening the command palette (CMD/Ctrl-Shift-P) and running SpecStory: 📝 Save Composer and Chat History.

Share your composer and chat history with others by opening the command palette (CMD/Ctrl-Shift-P) and running SpecStory: ☁️ Share Composer and Chat History.

For Developers

You can enable specstory.showDeveloperTools in your VS Code settings to browse the Cursor Chat DB in your Primary Sidebar’s Tree View.

Search State: Quick search through the VS Code state
- Access via Command Palette: SpecStory (Developer Tools): Search VS Code State
- Click the search icon in the VS Code State view
Refresh State View: Update the state explorer with latest data
- Access via Command Palette: SpecStory (Developer Tools): Refresh VS Code State
- Click the refresh icon in the VS Code State view
Copy Values: Quickly copy state values to clipboard
- Hover over any value in the state explorer
- Click the copy icon that appears
- Values are copied in a format suitable for pasting elsewhere

Documentation, Community and Support

Documentation for extension use is located at docs.specstory.com.

Issue Reporting and Feature Requests

Found a bug? Have a feature request? Please log it on our issues page on GitHub.

Privacy

SpecStory collects pseudo-anonymous usage data to help improve the product. This can be disabled in the extension by unchecking "SpecStory: Help Us Improve" in your SpecStory extension settings.

This setting does not affect web analytics. For more information about what data we collect and how we use it, please see our privacy policy.