{"id":22898204,"url":"https://github.com/specstoryai/getspecstory","last_synced_at":"2026-02-22T16:32:53.973Z","repository":{"id":268007757,"uuid":"903002140","full_name":"specstoryai/getspecstory","owner":"specstoryai","description":"Install our local first extensions for your favorite AI IDE or Terminal Agent. Sync your conversations to the cloud. File issues and requests.","archived":false,"fork":false,"pushed_at":"2026-01-20T17:38:41.000Z","size":608,"stargazers_count":970,"open_issues_count":47,"forks_count":55,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-01-20T21:59:57.939Z","etag":null,"topics":["ai","chat-history","claude","claude-code","codex","codex-cli","copilot","copilot-chat","cursor-ai","cursor-cli","cursorai","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://specstory.com/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/specstoryai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-13T18:05:13.000Z","updated_at":"2026-01-20T17:38:45.000Z","dependencies_parsed_at":"2024-12-13T19:23:42.339Z","dependency_job_id":"b83220ca-af4a-480d-a3e6-d840608dc040","html_url":"https://github.com/specstoryai/getspecstory","commit_stats":null,"previous_names":["specstoryai/getspecstory"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/specstoryai/getspecstory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specstoryai%2Fgetspecstory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specstoryai%2Fgetspecstory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specstoryai%2Fgetspecstory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specstoryai%2Fgetspecstory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/specstoryai","download_url":"https://codeload.github.com/specstoryai/getspecstory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/specstoryai%2Fgetspecstory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28756432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T16:32:25.380Z","status":"ssl_error","status_checked_at":"2026-01-25T16:32:09.189Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chat-history","claude","claude-code","codex","codex-cli","copilot","copilot-chat","cursor-ai","cursor-cli","cursorai","vscode","vscode-extension"],"created_at":"2024-12-14T00:29:51.534Z","updated_at":"2026-01-30T01:50:08.752Z","avatar_url":"https://github.com/specstoryai.png","language":"Go","funding_links":[],"categories":["🚀 AI Tools for Vim, Neovim, and Terminal","Extensions","HarmonyOS","IDE \u0026 Editor Integrations","Shell","Go"],"sub_categories":["Windows Manager"],"readme":"\n\u003cimg width=\"1649\" height=\"158\" alt=\"Group 6 (1)\" src=\"https://github.com/user-attachments/assets/93f0210f-c3ce-4035-91df-ec597e00a3ce\" /\u003e\n\n\n# Intent is the new source code\n\n**Turn your AI development conversations into searchable, shareable knowledge.**\n\nNever 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.\n\n\u003cp align=\"left\"\u003e\n  \u003cstrong\u003eInstall SpecStory ──▶ \u003c/strong\u003e\u0026nbsp;\n  \u003ca href=\"https://specstory.com\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3Dinstalls\u0026style=flat-square\" alt=\"Installs\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://specstory.com\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DactiveUsers\u0026style=flat-square\" alt=\"Active Users\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://specstory.com\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DsessionsSaved\u0026style=flat-square\" alt=\"Sessions Saved\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://specstory.com\"\u003e\u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DrulesGenerated\u0026style=flat-square\" alt=\"Rules Generated\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003cstrong\u003eContribute to OSS ──▶\u003c/strong\u003e\u0026nbsp;\n  \u003ca href=\"https://github.com/specstoryai/getspecstory/tree/main/specstory-cli\"\u003e\u003cimg src=\"https://img.shields.io/badge/CLI-Open%20Source-brightgreen?style=flat-square\" alt=\"CLI Open Source\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/specstoryai/agent-skills\"\u003e\u003cimg src=\"https://img.shields.io/badge/Skills-Open%20Source-brightgreen?style=flat-square\" alt=\"Skills Open Source\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003cstrong\u003eConnect with us ───▶\u003c/strong\u003e\u0026nbsp;\n  \u003ca href=\"https://twitter.com/specstoryai\"\u003e\u003cimg src=\"https://img.shields.io/badge/X-000000?style=flat-square\u0026logoColor=white\" alt=\"X\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.linkedin.com/company/specstory\"\u003e\u003cimg src=\"https://img.shields.io/badge/LinkedIn-0077B5?style=flat-square\u0026logo=linkedin\u0026logoColor=white\" alt=\"LinkedIn\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://specstory.slack.com/join/shared_invite/zt-2vq0274ck-MYS39rgOpDSmgfE1IeK9gg#/shared-invite/email\"\u003e\u003cimg src=\"https://img.shields.io/badge/Slack-4A154B?style=flat-square\u0026logo=slack\u0026logoColor=white\" alt=\"Slack\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/E47yQyEUd3\"\u003e\u003cimg src=\"https://img.shields.io/badge/Discord-5865F2?style=flat-square\u0026logo=discord\u0026logoColor=white\" alt=\"Discord\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.youtube.com/@specstory\"\u003e\u003cimg src=\"https://img.shields.io/badge/YouTube-FF0000?style=flat-square\u0026logo=youtube\u0026logoColor=white\" alt=\"YouTube\" style=\"vertical-align: middle;\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e 🔧 **[Agent Skills](https://github.com/specstoryai/agent-skills)** - Install skills to generate session summaries, fetch project stats, organize history, and more\n\n## How It Works\n```\nAI Coding Tools              Local First                  Cloud Platform\n─────────────────           ─────────────                ─────────────────\n                                                          (Login Required)\nCursor IDE         ┐\nCopilot IDE        │\nClaude Code CLI    │\nCursor CLI         ├──────►  .specstory/history/  ──────►  cloud.specstory.com\nCodex CLI          │          (Auto-Saved Locally)        (Search, Ask \u0026 Share)\nDroid CLI          │\nGemini CLI         ┘\n```\n\n## Workflow\n\n1. **Capture** - Extensions save every AI interaction locally to `.specstory/history/`\n2. **Process** - Use [Agent Skills](https://github.com/specstoryai/agent-skills) to generate summaries, stats, and insights from your history\n3. **Sync (Optional)** - Only if logged in, sessions sync to cloud\n4. **Search** - Find conversations locally or across all projects in cloud\n5. **Share** - Export and share specific solutions with your team\n\n## Supported Development Tools\n\nSpecStory 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.\n\n### Installation\n\n| Product                                                          | Type | Source                                                                                              | Supported Agent                                                               | Min Version  | Installation                                                  | Changelog                                                                                  |\n|------------------------------------------------------------------|------|-----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------|---------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| **[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) |\n| **[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) |\n| **[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`\u003cbr/\u003e`brew install specstory`       | [📋 View](https://github.com/specstoryai/getspecstory/releases)                            |\n| **[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`\u003cbr/\u003e`brew install specstory`       | [📋 View](https://github.com/specstoryai/getspecstory/releases)                            |\n| **[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`\u003cbr/\u003e`brew install specstory`       | [📋 View](https://github.com/specstoryai/getspecstory/releases)                            |\n| **[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`\u003cbr/\u003e`brew install specstory`       | [📋 View](https://github.com/specstoryai/getspecstory/releases)                            |\n| **[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`\u003cbr/\u003e`brew install specstory`       | [📋 View](https://github.com/specstoryai/getspecstory/releases)                            |\n\n\u003e [!NOTE]\n\u003e For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. [Learn why](https://github.com/specstoryai/getspecstory/issues/8)\n\n### CLI Tools\n\n**One installation works with all CLI tools** - Claude Code, Cursor CLI, and Codex:\n\n```bash\n# Check which agents are installed\nspecstory check\n\n# Launch your preferred agent with auto-save\nspecstory run claude    # Launch Claude Code\nspecstory run cursor    # Launch Cursor CLI\nspecstory run codex     # Launch Codex CLI\nspecstory run droid     # Launch Droid CLI\nspecstory run gemini    # Launch Gemini CLI\nspecstory run           # Launch default agent\n```\n\nAll sessions automatically save to `.specstory/history/` in your current project.\n\n\u003e [!TIP]\n\u003e 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.\n\n## SpecStory Cloud ☁️\n\n[**SpecStory Cloud**](https://cloud.specstory.com) transforms your local AI conversations into a powerful, centralized knowledge system.\n\n### The Problem We Solve\n- **Lost Context**: Critical decisions and solutions scattered across machines and projects\n- **No Global Search**: Finding that perfect solution from last month is impossible\n- **Fragile Sharing**: Passing around Markdown files doesn't scale\n\n### The Solution\nSpecStory Cloud creates your personal AI coding knowledge base:\n- 🔍 **Search Everywhere**: Full-text search across all your projects via web interface. RAG coming soon.\n- 🎯 **Explicit Opt-In**: Nothing syncs to cloud without sign-up and login first\n- 📚 **Organized by Project**: Automatic categorization by repository and time\n- 🚀 **API Access**: Programmatic sync and search for automation\n- 👥 **Team Features**: Coming soon - share knowledge across your organization\n\n[Get Started with SpecStory Cloud →](https://cloud.specstory.com)\n\n### How to Sync to Cloud\n\n| Method | One-Time Setup | Live Sessions | Past Sessions |\n|--------|----------------|---------------|---------------|\n| **SpecStory CLI** | `specstory login` | Auto-pushed when using `specstory run` while logged in | Use `specstory sync` to push existing local sessions |\n| **Cursor Extension** | Command Palette → \"SpecStory: Open Cloud Sync Configuration\" | Configure auto-sync in settings | Use sync command from Command Palette |\n| **VSCode Extension** | Command Palette → \"SpecStory: Open Cloud Sync Configuration\" | Configure auto-sync in settings | Use sync command from Command Palette |\n\n\u003e [!IMPORTANT]\n\u003e **Local-First \u0026 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.\n\n## Documentation \u0026 Support\n\n- 📚 **[Full Documentation](https://docs.specstory.com/overview)** - Complete guides and [Cloud API reference](https://docs.specstory.com/api-reference/introduction)\n- 🔧 **[Agent Skills](https://github.com/specstoryai/agent-skills)** - Generate summaries, stats, and insights from your `.specstory/history`\n- 🐛 **[Report Issues](https://github.com/specstoryai/getspecstory/issues)** - We actively monitor and respond\n- 📖 **[Contribute to Docs](https://github.com/specstoryai/docs/)** - PRs welcome!\n\n## Reviews \u0026 Feedback\n\nLove SpecStory? Help others discover their AI coding memory upgrade by leaving a [review](https://marketplace.visualstudio.com/items?itemName=SpecStory.specstory-vscode\u0026ssr=false#review-details)! 🧠\n\n## Star History\n\n![Star History Chart](https://api.star-history.com/svg?repos=specstoryai/getspecstory\u0026type=Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecstoryai%2Fgetspecstory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspecstoryai%2Fgetspecstory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspecstoryai%2Fgetspecstory/lists"}