What is SpecStory?

SpecStory is an extension for GitHub Copilot and Cursor IDE that automatically helps you save, share and generate rules for AI from your vibe coding and software composer workflows. Never lose your chat history.

• For Cursor: It is tested to work for Version: 0.43.6 and later
• For Copilot: It is tested to work for Version: 1.300.0 and later

❗️Important Note

By default, installing from the Visual Studio Marketplace directly will install SpecStory into VS Code. To instead install SpecStory into Cursor, you must install directly from inside the extensions panel in Cursor (see details on our documentation site.

✨ What SpecStory does

🪄 Your work saves itself, no cloud required!

When you install SpecStory it begins its work in the background, tucking away your chat history with AI for your active project in ./specstory/history.

Want to wave your wand differently? You can toggle this on and off in our settings.

🧪 Auto generate Cursor Rules or Copilot Instructions from your chat history

One great way to keep your AI development on track is to help it learn from each interaction. Let SpecStory automatically create and maintain your rules and instructions files for you.

You can customize the structure of your rules and SpecStory is more than happy to oblige.

🎯 Cherry pick your save worthy moments

For the delightfully meticulous among us, summon the command palette (CMD/Ctrl-Shift-P) and cast SpecStory: Save AI Chat History to preserve exactly which chat histories you want.

🌟 Share your brilliant work

Ready to razzle-dazzle with your creative AI assisted genius? Open the command palette (CMD/Ctrl-Shift-P), invoke SpecStory: Share AI Chat History, and let the world see your sparkle!

🎮 Your very own control panel

Behold the SpecStory control panel! Here you can save and share histories, tweak settings, and keep an eye on your auto-save status. Find it in the left sidebar, or summon it with View: Open View > SpecStory from the command palette.

🛠️ For Developers

Enable specstory.showDeveloperTools in your VS Code settings to unlock:

1. Debug logging in the SpecStory output channel
2. A shiny new Cursor sqlite DB explorer in your Primary Sidebar's Tree View which you can use to:

• 🕵️‍♂️ Search Like a Pro:

  • Access via Command Palette: SpecStory (Developer Tools): Search VS Code State
  • Or click the magnifying glass icon in the VS Code State view

• 🔄 Refresh your state's reality:

  • Command Palette incantation: SpecStory (Developer Tools): Refresh VS Code State
  • Or hit the refresh button for instant state rejuvenation

• 📋 Copy Magic:

  • 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

• Find our docs chock full of use cases and a getting started guide to master your craft @ docs.specstory.com.

• Join our slack community to connect with other software composers!

🔮 Issue Reporting and Feature Requests

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

• For any other issue please email us at support@specstory.com.

🔒 Privacy

SpecStory collects 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 and data privacy docs which provide detail by feature.