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.
VSCode + Copilot
Cursor
Manual VSIX Install
- 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
.specstory folder 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
.specstory folder in your project.
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.
SpecStory CLI for Terminal Agents
The SpecStory CLI auto-generates markdown files from your chat sessions with terminal agents (e.g. Claude Code, Cursor CLI, Codex CLI, Gemini CLI, etc.). It runs the terminal agent while saving your conversations to .specstory/history/ in your project.
We recommend using Homebrew to install on Macbrew tap specstoryai/tap
brew update
brew install specstory
specstory version
specstory check
# Run Claude Code through SpecStory wrapper
specstory run claude
# Run Cursor CLI through SpecStory wrapper
specstory run cursor
# Run Codex CLI through SpecStory wrapper
specstory run codex
# Run Gemini CLI through SpecStory wrapper
specstory run gemini
# Or sync existing sessions to markdown
specstory sync
brew update
brew upgrade specstory
-
Download the latest release for your platform:
-
Extract and move to your PATH:
unzip SpecStoryCLI_*.zip
sudo mv specstory /usr/local/bin/
chmod +x /usr/local/bin/specstory
-
Verify installation:
specstory version
specstory check
-
Start using SpecStory:
# Run Claude Code through SpecStory wrapper
specstory run claude
# Run Cursor CLI through SpecStory wrapper
specstory run cursor
# Run Codex CLI through SpecStory wrapper
specstory run codex
# Or sync existing sessions to markdown
specstory sync
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, so let’s go! 