Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<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> <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> <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> <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](./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
- Capture - Extensions save every AI interaction locally to
.specstory/history/ - Process - Run
/loreto mine your history into reusable, evidence-backed agent skills - 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
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 | v0.43.6+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View |
| [VSC Copilot Extension](https://github.com/features/copilot) | IDE | Closed | GitHub Copilot | v1.300.0+ | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | Claude Code | v1.0.27+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | Codex CLI | v0.42.0+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | Cursor CLI | v2025.09.18+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | Droid CLI | v0.56.3+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | Gemini CLI | 0.15.1+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [SpecStory CLI](https://specstory.com/specstory-cli) | CLI | Open | DeepSeek TUI | 0.8.39+ | brew tap specstoryai/tap<br/>brew install specstory | 📋 View |
| [Lore](./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, 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 droid # Launch Droid CLI
specstory run gemini # Launch Gemini CLI
specstory run deepseek # Launch DeepSeek TUI
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.
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 loreThen invoke it - /lore in Claude Code, $lore in Codex, or just ask ("mine my lore") in Gemini CLI and others:
/loreSpecStory 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
| 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
- 📜 [Lore](./lore) - Forge your
.specstory/historyinto 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! 🧠