<img width="1649" height="158" alt="Group 6 (1)" src="https://github.com/user-attachments/assets/93f0210f-c3ce-4035-91df-ec597e00a3ce" />

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.

<p align="left"> <strong>Install SpecStory ──▶ </strong>&nbsp; <a href="https://specstory.com"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3Dinstalls&style=flat-square" alt="Installs" style="vertical-align: middle;"></a> <a href="https://specstory.com"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DactiveUsers&style=flat-square" alt="Active Users" style="vertical-align: middle;"></a> <a href="https://specstory.com"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DsessionsSaved&style=flat-square" alt="Sessions Saved" style="vertical-align: middle;"></a> <a href="https://specstory.com"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DrulesGenerated&style=flat-square" alt="Rules Generated" style="vertical-align: middle;"></a> </p> <p align="left"> <strong>Contribute to OSS ──▶</strong>&nbsp; <a href="https://github.com/specstoryai/getspecstory/tree/main/specstory-cli"><img src="https://img.shields.io/badge/CLI-Open%20Source-brightgreen?style=flat-square" alt="CLI Open Source" style="vertical-align: middle;"></a> <a href="./lore"><img src="https://img.shields.io/badge/Lore-Forge%20Skills-brightgreen?style=flat-square" alt="Lore: forge skills from your sessions" style="vertical-align: middle;"></a> </p> <p align="left"> <strong>Connect with us ───▶</strong>&nbsp; <a href="https://twitter.com/specstoryai"><img src="https://img.shields.io/badge/X-000000?style=flat-square&logoColor=white" alt="X" style="vertical-align: middle;"></a> <a href="https://www.linkedin.com/company/specstory"><img src="https://img.shields.io/badge/LinkedIn-0077B5?style=flat-square&logo=linkedin&logoColor=white" alt="LinkedIn" style="vertical-align: middle;"></a> <a href="https://specstory.slack.com/join/shared_invite/zt-2vq0274ck-MYS39rgOpDSmgfE1IeK9gg#/shared-invite/email"><img src="https://img.shields.io/badge/Slack-4A154B?style=flat-square&logo=slack&logoColor=white" alt="Slack" style="vertical-align: middle;"></a> <a href="https://discord.gg/E47yQyEUd3"><img src="https://img.shields.io/badge/Discord-5865F2?style=flat-square&logo=discord&logoColor=white" alt="Discord" style="vertical-align: middle;"></a> <a href="https://www.youtube.com/@specstory"><img src="https://img.shields.io/badge/YouTube-FF0000?style=flat-square&logo=youtube&logoColor=white" alt="YouTube" style="vertical-align: middle;"></a> </p>

📜 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

| Product | Type | Source | Supported Agent | Min Version | Installation | Changelog | |------------------------------------------------------------------|------|------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------|---------------------------------------------------------------|--------------------------------------------------------------------------------------------| | Cursor Extension | IDE | Closed | Cursor AI | v0.43.6+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View | | VSC Copilot Extension | IDE | Closed | GitHub Copilot | v1.300.0+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View | | SpecStory CLI | CLI | Open | Claude Code | v1.0.27+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | Codex CLI | v0.42.0+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | Cursor CLI | v2025.09.18+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | Droid CLI | v0.56.3+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | Gemini CLI | 0.15.1+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | DeepSeek TUI | 0.8.39+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | SpecStory CLI | CLI | Open | Antigravity CLI | v1.1.5+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View | | Lore 📜 | Skill | Open | Any Agent Skills | Node 22.5+ | npx skills add specstoryai/getspecstory --skill lore | 📋 View |

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

S