Turn your AI development conversations into searchable, shareable knowledge.
Never lose a brilliant solution, code snippet, or architectural decision again. SpecStory captures, indexes, and makes searchable every interaction you have with AI coding assistants across all your projects and tools.
AI Coding Tools Local First Cloud Platform
───────────────── ───────────── ─────────────────
(Login Required)
Cursor IDE ┐
Copilot IDE │
Claude Code CLI ├──────► .specstory/history/ ──────► cloud.specstory.com
Cursor CLI │ (Auto-Saved Locally) (Search & Share)
Codex CLI ┘
- Capture - Extensions save every AI interaction locally to
.specstory/history/ - Sync (Optional) - Only if logged in, sessions sync to cloud
- Search - Find conversations locally or across all projects in cloud
- Share - Export and share specific solutions with your team
SpecStory integrates seamlessly with your favorite AI coding tools, automatically saving all conversations locally to .specstory/history/ in your project. Everything is local-first - your data stays on your machine unless you choose to sync to the cloud.
| Product | Type | Supported Agents | Min Version | Installation | Changelog |
|---|---|---|---|---|---|
| Cursor Extension | IDE | Cursor AI | v0.43.6+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View |
| VSC Copilot Extension | IDE | GitHub Copilot | v1.300.0+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View |
| SpecStory CLI | CLI | Claude Code Cursor CLI Codex CLI |
v1.0.27+ v2025.09.18+ v0.42.0+ |
brew tap specstoryai/tapbrew install specstory |
📋 View |
Note
For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. Learn why
One installation works with all CLI tools - Claude Code, Cursor CLI, and Codex:
# Check which agents are installed
specstory check
# Launch your preferred agent with auto-save
specstory run claude # Launch Claude Code
specstory run cursor # Launch Cursor CLI
specstory run codex # Launch Codex CLI
specstory run # Launch default agentAll sessions automatically save to .specstory/history/ in your current project.
Tip
The SpecStory CLI acts as a wrapper that enhances any of these terminal agents with automatic session saving. You only need the respective agent installed (e.g., Claude Code) for SpecStory to work with it.
SpecStory Cloud transforms your local AI conversations into a powerful, centralized knowledge system.
- Lost Context: Critical decisions and solutions scattered across machines and projects
- No Global Search: Finding that perfect solution from last month is impossible
- Fragile Sharing: Passing around Markdown files doesn't scale
SpecStory Cloud creates your personal AI coding knowledge base:
- 🔍 Search Everywhere: Full-text search across all your projects via web interface. RAG coming soon.
- 🎯 Explicit Opt-In: Nothing syncs to cloud without sign-up and login first
- 📚 Organized by Project: Automatic categorization by repository and time
- 🚀 API Access: Programmatic sync and search for automation
- 👥 Team Features: Coming soon - share knowledge across your organization
Get Started with SpecStory Cloud →
| Method | One-Time Setup | Live Sessions | Past Sessions |
|---|---|---|---|
| SpecStory CLI | specstory login |
Auto-pushed when using specstory run while logged in |
Use specstory sync to push existing local sessions |
| Cursor Extension | Command Palette → "SpecStory: Open Cloud Sync Configuration" | Configure auto-sync in settings | Use sync command from Command Palette |
| VSCode Extension | Command Palette → "SpecStory: Open Cloud Sync Configuration" | Configure auto-sync in settings | Use sync command from Command Palette |
Important
Local-First & Private by Default: All sessions are saved locally to .specstory/history/. Nothing is ever sent to the cloud unless you explicitly login with. Even after logging in, you can control what gets synced.
For those who prefer a dedicated spec-writing environment, BearClaude offers a three-pane interface combining documentation, editing, and Claude Code terminal. Perfect for maintaining specs alongside your code. (Learn more)
- 📚 Full Documentation - Complete guides and Cloud API reference
- 🐛 Report Issues - We actively monitor and respond
- 📖 Contribute to Docs - PRs welcome!
- X/Twitter: @specstoryai
- LinkedIn: SpecStory
- Slack: Join our community
Love SpecStory? Help others discover their AI coding memory upgrade by leaving a review! 🧠