Skip to main content
SpecStory works across multiple tools. Follow the steps to setup SpecStory for your editor or workflow and get started quickly.

Cursor

Install from Cursor’s marketplace and verify autosave to .specstory/history/.

VS Code + Copilot

Install the VSIX from VS Code and confirm conversations are saved locally.

Terminal Coding Agents

Choose your terminal agent, then expand to jump into a focused guide.
Run Anthropic’s CLI through SpecStory for Markdown transcripts.Open the Claude Code guide →
Mirror Cursor’s terminal agent and keep a durable history of the session.Open the Cursor CLI guide →
Pair Codex CLI with SpecStory to archive GPT-powered workflows.Open the Codex CLI guide →

BearClaude (macOS)

Download the app, open a project, and confirm local autosave.

​
Cursor

​
Install

  1. Open Cursor.
  2. Extensions (Ctrl/Cmd+Shift+X) → search SpecStory → Install.
  3. Verify via Command Palette (Ctrl/Cmd+Shift+P) → type SpecStory.
Installing from the Visual Studio Marketplace website can leave VS Code installed but not Cursor. Install inside Cursor.

​
Verify autosave

  1. Chat with Cursor’s AI in a workspace folder.
  2. Check <your-project>/.specstory/history/ for a Markdown file representing your session.
👉 Learn more in Integrations → VS Code + Copilot.

​
VS Code (Copilot)

​
Install

  1. Open VS Code with GitHub Copilot enabled.
  2. Extensions (Ctrl/Cmd+Shift+X) → search SpecStory → Install.
  3. Verify via Command Palette (Ctrl/Cmd+Shift+P): type SpecStory.

​
Verify autosave

  1. Start a Copilot chat in your workspace.
  2. Check <your-project>/.specstory/history/ for a new Markdown file.
👉 More details in Integrations → VS Code + Copilot.

​
Terminal Coding Agents

Wrap your terminal-based AI assistant with SpecStory to capture a Markdown history of the entire chat and tool output.
Install the SpecStory CLI, then run Claude through the wrapper:
brew tap specstoryai/tap
brew update
brew install specstory
specstory run claude
specstory sync claude
Dive deeper →
Capture Cursor CLI sessions and retroactively export past chats:
brew tap specstoryai/tap
brew update
brew install specstory
specstory run cursor
specstory sync cursor
Dive deeper →
Launch Codex CLI via SpecStory to archive GPT-driven workflows:
brew tap specstoryai/tap
brew update
brew install specstory
specstory run codex
specstory sync codex
Dive deeper →
Generated files appear in <your-project>/.specstory/history/.
Linux/WSL: download binaries from the GitHub releases page. Each guide covers platform-specific paths and tips.
👉 Explore the full overview in Integrations → Terminal Coding Agents or open the dedicated guides for Claude Code, Cursor CLI, and Codex CLI.

​
BearClaude (macOS)

​
Install

​
Use & verify

  1. Open a project folder in BearClaude.
  2. Write a spec in the editor, then use the Claude pane.
  3. Check <your-project>/.specstory/history/ for Markdown files of your conversations.
👉 Deep dive in BearClaude and Settings.

​
Troubleshooting quick checks

  • No files in .specstory/history/: Confirm you are inside a project folder with write permissions.
  • Cursor VS Code not saving: Ensure the extension is installed in the correct editor (Cursor vs VS Code) and restart the editor.
  • CLI not capturing: Run specstory check and confirm the terminal agent runs from your shell (e.g., claude --version).
  • Still stuck? See Integrations for storage paths and known issues, or contact support@specstory.com.

​
Next steps