Install our extensions
Save, search and share your AI chat history with SpecStory.
Multiplatform support is now here
The SpecStory Extension as of v0.11.0 (changelog) supports both Cursor and GitHub Copilot. For Claude Code, we offer a CLI wrapper v0.0.2 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.
- Open VSCode with GitHub Copilot installed and activated.
- Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X).
- Click Install. Consult our Changelog to make sure you’re on the latest version.
- Once installed, SpecStory automatically saves your Copilot chats to the
.specstoryfolder in your project.
- Open VSCode with GitHub Copilot installed and activated.
- Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X).
- Click Install. Consult our Changelog to make sure you’re on the latest version.
- Once installed, SpecStory automatically saves your Copilot chats to the
.specstoryfolder in your project.
- Open Cursor.
- Search for SpecStory in the Extensions Marketplace (Ctrl/CMD-Shift-X).
- Click Install. Consult our Changelog to make sure you’re on the latest version.
- Once installed, SpecStory automatically saves your Cursor chats to the
.specstoryfolder in your project.
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. No one wants that.
The SpecStory extension’s VSIX works seamlessly with both GitHub Copilot and Cursor. You’ll need to install it separately in each environment.
- Make sure you’re on the latest version of GitHub Copilot or Cursor.
- Download our extension: specstory-vscode-latest.vsix
- From either editor, pop open the Command Palette (Ctrl/CMD-Shift-P) and choose
Extensions: Install from VSIX…. - To verify the installation, open the Command Palette again (Ctrl/CMD-Shift-P) and type
SpecStory. You should see the available commands show up.
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
Once installed, verify installation with
Start using SpecStory
In the future, to upgrade, use Homebrew again
We recommend using Homebrew to install on Mac
Once installed, verify installation with
Start using SpecStory
In the future, to upgrade, use Homebrew again
-
Download the latest release for your platform:
- Linux (ARM64)
- Linux (x86) (Note: If you’re running WSL, download this)
-
Extract and move to your PATH:
-
Verify installation:
-
Start using SpecStory:
In the future, to upgrade, just follow these instructions again.
🌎 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!