Quickstart

Choose the extension or CLI for your coding agent. Add Cloud when you want to search and share across projects.

curl -fsSL https://specstory.com/install.sh | sh

In your editor

Open the Extensions panel in Cursor or VS Code with GitHub Copilot.
Search for SpecStory and install the extension published by SpecStory.
Open a project folder and have a conversation with your coding agent.
Look in .specstory/history/ for the saved Markdown file.

Autosave is enabled by default. See extension installation for marketplace links and manual installation.

In your terminal

Install the CLI on macOS with Homebrew:

bash

brew install specstoryai/tap/specstory
specstory check

From your project folder, launch your installed coding agent through SpecStory. For example:

bash

specstory run claude
# Or: specstory run codex

SpecStory writes the session to .specstory/history/. To export conversations you already had in this project, run specstory sync.

See CLI installation for Linux and manual downloads, and agent guides for other coding agents.

Add Cloud

Open SpecStory Cloud to sync your history, search across projects, and share sessions.

CLI sync is enabled when you are logged in. Pass --no-cloud-sync to keep a run local, even when authenticated:

bash

specstory run claude --no-cloud-sync

Use the saved context

Open a Markdown file to revisit a decision or give it to your coding agent when the next task begins. The CLI also supports searching and resuming sessions.