Skip to main content

​
Multiplatform support is now here

The SpecStory Extension (changelog) supports both Cursor and GitHub Copilot. For terminal agents like Claude Code, Cursor CLI, and Codex CLI, 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.
  • VSCode + Copilot
  • Cursor
  • Manual VSIX Install
  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.

​
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, etc.). It runs the terminal agent while saving your conversations to .specstory/history/ in your project.
  • Install with Homebrew
  • Download Linux/WSL Binary
We recommend using Homebrew to install on Mac
brew tap specstoryai/tap
brew update
brew install specstory
Once installed, verify installation with
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, 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, so let’s go!