​
Multiplatform support is now here

The SpecStory Extension (changelog) supports both Cursor and GitHub Copilot. For Claude Code, we offer a CLI wrapper (changelog) that captures your sessions.
SpecStory saves, organizes, and makes all your AI chats searchable in structured Markdown. Never lose a great solution, easily share interactions, and use conversation history to refine Copilot and Cursor with custom instructions and project rules.

​
🍦 Installation Options

Choose your installation method based on your IDE:

​
Extensions for VSCode & Cursor

Our VSIX extension works with both VSCode (with GitHub Copilot) and Cursor. Install directly from the Extension Marketplace in your preferred editor.
  1. Open VSCode with GitHub Copilot installed and activated.
  2. Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X).
  3. Click Install. Consult our Changelog to make sure you’re on the latest version.
  4. Once installed, SpecStory automatically saves your Copilot chats to the .specstory folder in your project.

​
CLI for Claude Code

SpecStory for Claude Code is a wrapper that auto-generates markdown files from your chat sessions. It runs Claude Code while saving your conversations to .specstory/history/ in your project.
We recommend using Homebrew to install on Mac
brew tap specstoryai/tap
brew update
brew install specstory
Once installed, verify installation with
specstory version
Start using SpecStory
# Run Claude Code through SpecStory wrapper
specstory run

# Or sync existing sessions to markdown
specstory sync
In the future, to upgrade, use Homebrew again
brew update
brew upgrade specstory

​
🌎 Why this will rock your world

Think of SpecStory as your AI conversation time machine.
  • ⚡ Auto-save your conversations into digestible Markdown format (readable by both humans AND machines).
  • 🌐 Make your vibe-coding adventures shareable via URLs at share.specstory.com.
  • 🧪 Auto-magically derive Copilot custom instructions and Cursor project rules to improve agent-first coding performance.
🧠 Your AI companion is about to get significantly less forgetful, and you won’t have to lift a finger - let’s go!