Install our extensions

Multiplatform support is now here

Note

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

Info

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 .specstory folder in your project.

SpecStory CLI for Terminal Agents

Info

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 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

# Run Gemini CLI through SpecStory wrapper
specstory run gemini

# 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!