https://github.com/specstoryai/getspecstory
Install our local first extensions for your favorite AI IDE or Terminal Agent. Sync your conversations to the cloud. File issues and requests.
https://github.com/specstoryai/getspecstory
ai chat-history claude claude-code codex codex-cli copilot copilot-chat cursor-ai cursor-cli cursorai vscode vscode-extension
Last synced: 4 months ago
JSON representation
Install our local first extensions for your favorite AI IDE or Terminal Agent. Sync your conversations to the cloud. File issues and requests.
- Host: GitHub
- URL: https://github.com/specstoryai/getspecstory
- Owner: specstoryai
- License: apache-2.0
- Created: 2024-12-13T18:05:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-20T17:38:41.000Z (5 months ago)
- Last Synced: 2026-01-20T21:59:57.939Z (5 months ago)
- Topics: ai, chat-history, claude, claude-code, codex, codex-cli, copilot, copilot-chat, cursor-ai, cursor-cli, cursorai, vscode, vscode-extension
- Language: Go
- Homepage: https://specstory.com/
- Size: 594 KB
- Stars: 970
- Watchers: 12
- Forks: 55
- Open Issues: 47
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE-OF-CONDUCT.md
Awesome Lists containing this project
- awesome-cli-agents - specstoryai/getspecstory - Install our local first extensions for your favorite AI IDE or Terminal Agent. Sync your conversations to the cloud. File issues and requests. [Terminal] (704⭐) (🚀 AI Tools for Vim, Neovim, and Terminal)
- awesome-claude-code - **getspecstory**
README
# 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 ───▶
> 🔧 **[Agent Skills](https://github.com/specstoryai/agent-skills)** - Install skills to generate session summaries, fetch project stats, organize history, and more
## How It Works
```
AI Coding Tools Local First Cloud Platform
───────────────── ───────────── ─────────────────
(Login Required)
Cursor IDE ┐
Copilot IDE │
Claude Code CLI │
Cursor CLI ├──────► .specstory/history/ ──────► cloud.specstory.com
Codex CLI │ (Auto-Saved Locally) (Search, Ask & Share)
Droid CLI │
Gemini CLI ┘
```
## Workflow
1. **Capture** - Extensions save every AI interaction locally to `.specstory/history/`
2. **Process** - Use [Agent Skills](https://github.com/specstoryai/agent-skills) to generate summaries, stats, and insights from your history
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) |
> [!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 # 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.
## 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)
- 🔧 **[Agent Skills](https://github.com/specstoryai/agent-skills)** - Generate summaries, stats, and insights from your `.specstory/history`
- 🐛 **[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
