Intent is the new source code

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.

Install SpecStory ──▶  

Contribute to OSS ──▶ 

Connect with us ───▶ 

📜 Lore - Mine your saved sessions into evidence-backed agent skills, forged from how you actually work. Your sessions are your lore.

How It Works

AI Coding Tools              Local First                  Cloud Platform
─────────────────           ─────────────                ─────────────────
                                                          (Login Required)
Cursor IDE         ┐
Copilot IDE        │
Claude Code CLI    │
Cursor CLI         │
Codex CLI          ├──────►  .specstory/history/  ──────►  cloud.specstory.com
Droid CLI          │          (Auto-Saved Locally)        (Search, Ask & Share)
Gemini CLI         │
DeepSeek TUI       │
Antigravity CLI    ┘

Workflow

1. Capture - Extensions save every AI interaction locally to .specstory/history/
2. Process - Run /lore to mine your history into reusable, evidence-backed agent skills
3. Sync (Optional) - Only if logged in, sessions sync to cloud
4. Search - Find conversations locally or across all projects in cloud
5. Share - Export and share specific solutions with your team

Supported Development Tools

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.

Installation

[!NOTE] For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. Learn why

CLI Tools

One installation works with all CLI tools - Claude Code, Cursor CLI, Codex, Droid, DeepSeek, and Antigravity:

# 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 droid        # Launch Droid CLI
specstory run gemini       # Launch Gemini CLI
specstory run deepseek     # Launch DeepSeek TUI
specstory run antigravity  # Launch Antigravity CLI
specstory run           # Launch default agent

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

Lore 📜

Lore turns the sessions SpecStory saves into agent skills forged from how you actually work. Your sessions are your lore.

The Problem We Solve

• Repeated Yourself Again: You re-explain the same workflows, conventions, and fixes to your agent every session
• Skills From Guesswork: Hand-written agent skills describe how you think you work, not how you demonstrably do

The Solution

Lore mines your .specstory/history into evidence - what you actually ran, what worked, and the judgment you apply without noticing - and forges the skills you approve into every agent on your machine.

Install:

npx skills add specstoryai/getspecstory --skill lore

Then invoke it - /lore in Claude Code, $lore in Codex, or just ask (“mine my lore”) in Gemini CLI and others:

/lore

Get Started with Lore →

SpecStory Cloud ☁️

SpecStory Cloud transforms your local AI conversations into a powerful, centralized knowledge system.

The Problem We Solve

• 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

The Solution

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 →

How to Sync to Cloud

[!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.

Documentation & Support

• 📚 Full Documentation - Complete guides and Cloud API reference
• 📜 Lore - Forge your .specstory/history into installable agent skills, with evidence and outcomes
• 🐛 Report Issues - We actively monitor and respond
• 📖 Contribute to Docs - PRs welcome!

Reviews & Feedback

Love SpecStory? Help others discover their AI coding memory upgrade by leaving a review! 🧠

Star History