Group 6 (1) # 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 ──▶   Installs Active Users Sessions Saved Rules Generated

Contribute to OSS ──▶  CLI Open Source Lore: forge skills from your sessions

Connect with us ───▶  X LinkedIn Slack Discord YouTube

> 📜 **[Lore](./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 ┘ ``` ## Workflow 1. **Capture** - Extensions save every AI interaction locally to `.specstory/history/` 2. **Process** - Run [`/lore`](./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](https://www.cursor.com/)** | IDE | Closed | [Cursor AI](https://www.cursor.com/) | v0.43.6+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | [📋 View](https://marketplace.visualstudio.com/items/SpecStory.specstory-vscode/changelog) | | **[VSC Copilot Extension](https://github.com/features/copilot)** | IDE | Closed | [GitHub Copilot](https://github.com/features/copilot) | v1.300.0+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | [📋 View](https://marketplace.visualstudio.com/items/SpecStory.specstory-vscode/changelog) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/claudecode) | [Claude Code](https://claude.ai/claude-code) | v1.0.27+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/codexcli) | [Codex CLI](https://www.openai.com/codex) | v0.42.0+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/cursorcli) | [Cursor CLI](https://cursor.com/cli) | v2025.09.18+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/droidcli) | [Droid CLI](https://factory.ai/product/cli) | v0.56.3+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/geminicli) | [Gemini CLI](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli) | 0.15.1+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | CLI | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/deepseektui) | [DeepSeek TUI](https://github.com/Hmbown/DeepSeek-TUI) | 0.8.39+ | `brew tap specstoryai/tap`
`brew install specstory` | [📋 View](https://github.com/specstoryai/getspecstory/releases) | | **[Lore](./lore)** 📜 | Skill | [Open](./lore) | Any [Agent Skills](https://agentskills.io) | Node 22.5+ | `npx skills add specstoryai/getspecstory --skill lore` | [📋 View](./lore/CHANGELOG.md) | > [!NOTE] > For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. [Learn why](https://github.com/specstoryai/getspecstory/issues/8) ### CLI Tools **One installation works with all CLI tools** - Claude Code, Cursor CLI, and Codex: ```bash # 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 # 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**](./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: ```sh 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 →](./lore) ## SpecStory Cloud ☁️ [**SpecStory Cloud**](https://cloud.specstory.com) 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 →](https://cloud.specstory.com) ### How to Sync to 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. ## Documentation & Support - 📚 **[Full Documentation](https://docs.specstory.com/overview)** - Complete guides and [Cloud API reference](https://docs.specstory.com/api-reference/introduction) - 📜 **[Lore](./lore)** - Forge your `.specstory/history` into installable agent skills, with evidence and outcomes - 🐛 **[Report Issues](https://github.com/specstoryai/getspecstory/issues)** - We actively monitor and respond - 📖 **[Contribute to Docs](https://github.com/specstoryai/docs/)** - PRs welcome! ## Reviews & Feedback Love SpecStory? Help others discover their AI coding memory upgrade by leaving a [review](https://marketplace.visualstudio.com/items?itemName=SpecStory.specstory-vscode&ssr=false#review-details)! 🧠 ## Star History ![Star History Chart](https://api.star-history.com/svg?repos=specstoryai/getspecstory&type=Date)