Skip to content
Back to search

getspecstory

Install our local first extensions for your favorite AI IDE or Terminal Agent. Process your histories into reusable skills with Lore. Sync your conversations to the cloud. File issues and requests.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/specstoryai/getspecstory with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/specstoryai/getspecstory'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/specstoryai--getspecstory/badge.svg)](/listings/specstoryai--getspecstory)

HTML

<a href="/listings/specstoryai--getspecstory"><img src="/api/listings/specstoryai--getspecstory/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

| Supported Agent | Agent Type | Min Version | SpecStory Product | Source Code | Installation | | ----------------------------------------------------------------------------- | ---------- | ------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | [Cursor AI](https://www.cursor.com/) | IDE | v0.43.6+ | **[Cursor Extension](https://www.cursor.com/)** | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | | [GitHub Copilot](https://github.com/features/copilot) | IDE | v1.300.0+ | **[VSC Copilot Extension](https://github.com/features/copilot)** | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | | [Claude Code](https://claude.ai/claude-code) | CLI | v1.0.27+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/claudecode) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [Codex CLI](https://www.openai.com/codex) | CLI | v0.42.0+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/codexcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [Cursor CLI](https://cursor.com/cli) | CLI | v2025.09.18+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/cursorcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [Droid CLI](https://factory.ai/product/cli) | CLI | v0.56.3+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/droidcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [Gemini CLI](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli) | CLI | 0.15.1+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/geminicli) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [DeepSeek TUI](https://github.com/Hmbown/DeepSeek-TUI) | CLI | 0.8.39+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/deepseektui) | `brew tap specstoryai/tap`<br/>`brew install specstory` | | [Antigravity CLI](https://antigravity.google/) | CLI | v1.1.5+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/antigravitycli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "specstory",
  3. "owner": {
  4. "name": "SpecStory",
  5. "url": "https://github.com/specstoryai"
  6. },
  7. "metadata": {
  8. "description": "SpecStory's agent skills: turn your AI coding sessions into durable, installable expertise."
  9. },
  10. "plugins": [
  11. {
  12. "name": "lore",
  13. "source": "./lore",
  14. "version": "3.9.0",
  15. "description": "Mine your SpecStory coding histories into a persistent corpus and forge your repeated workflows into installable agent skills.",
  16. "author": {
  17. "name": "SpecStory",
  18. "url": "https://github.com/specstoryai"
  19. },
  20. "homepage": "https://github.com/specstoryai/getspecstory/tree/dev/lore",
  21. "license": "Apache-2.0",
  22. "category": "productivity"
  23. }
  24. ]
  25. }
README.md · README · 205 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <img width="1649" height="158" alt="Group 6 (1)" src="https://github.com/user-attachments/assets/93f0210f-c3ce-4035-91df-ec597e00a3ce" />
  2. # Intent is the new source code
  3. **Turn your AI development conversations into searchable, shareable knowledge.**
  4. 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.
  5. <p align="left">
  6. <strong>Install SpecStory ──▶ </strong>&nbsp;
  7. <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>
  8. <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>
  9. <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>
  10. </p>
  11. <p align="left">
  12. <strong>Contribute to OSS ──▶</strong>&nbsp;
  13. <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>
  14. <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>
  15. </p>
  16. <p align="left">
  17. <strong>Connect with us ───▶</strong>&nbsp;
  18. <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>
  19. <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>
  20. <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>
  21. <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>
  22. <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>
  23. </p>
  24. ## How It Works
  25. ```
  26. AI Coding Tools Local First Cloud Platform
  27. ───────────────── ───────────── ─────────────────
  28. (Login Required)
  29. Cursor IDE ┐
  30. Copilot IDE │
  31. Claude Code CLI │
  32. Copilot CLI │
  33. Cursor CLI │
  34. Cursor Cloud Agent │
  35. Codex CLI ├──────► .specstory/history/ ──────► cloud.specstory.com
  36. Droid CLI │ (Auto-Saved Locally) (Search, Ask & Share)
  37. DeepSeek TUI │
  38. Antigravity CLI │
  39. Grok Build │
  40. Muse Code │
  41. OpenCode │
  42. Pi │
  43. Qwen Code ┘
  44. ```
  45. ## Workflow
  46. 1. **Capture** - SpecStory CLI and IDE extensions save every AI interaction locally to `.specstory/history/`
  47. 2. **Sync (Optional)** - Sync your local sessions to SpecStory Cloud for safekeeping and team sharing
  48. 3. **Search** - Find conversations across all projects locally, or across multiple computers and team members in SpecStory Cloud
  49. 4. **Chat (Optional)** - Ask questions across your sessions in SpecStory Cloud to revisit decisions, understand past work, and find solutions
  50. 5. **Share** - Export and share specific solutions with your team
  51. 6. **Resume** - Resume sessions locally between different agents, and between multiple computers and team members with SpecStory Cloud
  52. 7. **Process** - Run [`/lore`](./lore) to mine your history into reusable, evidence-backed agent skills
  53. ## Supported Development Tools
  54. 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 SpecStory Cloud.
  55. ### Installation
  56. | Supported Agent | Agent Type | Min Version | SpecStory Product | Source Code | Installation |
  57. | ----------------------------------------------------------------------------- | ---------- | ------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
  58. | [Cursor AI](https://www.cursor.com/) | IDE | v0.43.6+ | **[Cursor Extension](https://www.cursor.com/)** | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install |
  59. | [GitHub Copilot](https://github.com/features/copilot) | IDE | v1.300.0+ | **[VSC Copilot Extension](https://github.com/features/copilot)** | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install |
  60. | [Claude Code](https://claude.ai/claude-code) | CLI | v1.0.27+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/claudecode) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  61. | [Codex CLI](https://www.openai.com/codex) | CLI | v0.42.0+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/codexcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  62. | [Copilot CLI](https://github.com/features/copilot/cli) | CLI | 1.0.105+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/copilotcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  63. | [Cursor CLI](https://cursor.com/cli) | CLI | v2025.09.18+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/cursorcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  64. | [Cursor Cloud Agents](https://cursor.com/agents) | Cloud | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/cursorcloud) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  65. | [Droid CLI](https://factory.ai/product/cli) | CLI | v0.56.3+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/droidcli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  66. | [Gemini CLI](https://docs.cloud.google.com/gemini/docs/codeassist/gemini-cli) | CLI | 0.15.1+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/geminicli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  67. | [DeepSeek TUI](https://github.com/Hmbown/DeepSeek-TUI) | CLI | 0.8.39+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/deepseektui) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  68. | [Antigravity CLI](https://antigravity.google/) | CLI | v1.1.5+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/antigravitycli) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  69. | [Muse Code](https://developer.meta.com/ai/products/muse-code/) | CLI | 0.1.0+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/musecode) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  70. | [Qwen Code](https://github.com/QwenLM/qwen-code) | CLI | 0.23.4+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/qwencode) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  71. | [Pi](https://pi.dev) | CLI | 0.85.1+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/piagent) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  72. | [Grok Build](https://x.ai/cli) | CLI | 1.0.34+ | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/grokbuild) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  73. | [OpenCode](https://opencode.ai/) | CLI | | **[SpecStory CLI](https://specstory.com/specstory-cli)** | [Open](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli/pkg/providers/opencode) | `brew tap specstoryai/tap`<br/>`brew install specstory` |
  74. | Any [Agent Skills](https://agentskills.io) | Skill | Node 22.5+ | **[Lore](./lore)** 📜 | [Open](./lore) | `npx skills add specstoryai/getspecstory --skill lore` |
  75. > [!TIP]
  76. > Don't see the agent you need listed here? The [SpecStory CLI](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli) is open source and it's easy to contribute new agent providers.
  77. > [!NOTE]
  78. > For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. [Learn why](https://github.com/specstoryai/getspecstory/issues/8)
  79. ### Terminal Coding Agents
  80. **One installation works with all terminal coding agents** - Claude Code, Cursor CLI, Codex, Copilot CLI, Droid, DeepSeek, Antigravity CLI, OpenCode, Qwen Code, and Pi - and with Cursor Cloud Agents, read from the Cursor API with your API key (set `CURSOR_API_KEY`, or `cursor_api_key` under `[providers]` in `~/.specstory/cli/config.toml`):
  81. ```bash
  82. # Check which agents are installed
  83. specstory check
  84. # Launch your preferred agent with session auto-save
  85. specstory run claude # Launch Claude Code
  86. specstory run cursor # Launch Cursor CLI
  87. specstory run cursorcloud # Start a Cursor Cloud Agent on this repo and save its sessions
  88. specstory run codex # Launch Codex CLI
  89. specstory run copilot # Launch Copilot CLI
  90. specstory run droid # Launch Droid CLI
  91. specstory run deepseek # Launch DeepSeek TUI
  92. specstory run antigravity # Launch Antigravity CLI
  93. specstory run grok # Launch Grok Build
  94. specstory run muse # Launch Muse Code
  95. specstory run opencode # Launch OpenCode
  96. specstory run qwen # Launch Qwen Code
  97. specstory run pi # Launch Pi
  98. specstory run # Launch the default agent (Claude Code)
  99. # Render all prior agent coding sessions in the project as markdown
  100. specstory sync
  101. ```
  102. All sessions automatically save to `.specstory/history/` in your current project.
  103. > [!TIP]
  104. > 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.
  105. Learn much more about the [SpecStory CLI](https://github.com/specstoryai/getspecstory/tree/dev/specstory-cli).
  106. ## SpecStory Cloud ☁️
  107. [**SpecStory Cloud**](https://cloud.specstory.com) transforms your local AI conversations into a powerful, centralized knowledge system.
  108. ### The Problem We Solve
  109. - **Lost Context**: Critical decisions and solutions scattered across machines and projects
  110. - **No Global Search**: Finding that perfect solution from last month is impossible
  111. - **Fragile Sharing**: Passing around Markdown files doesn't scale
  112. ### The Solution
  113. SpecStory Cloud creates your personal AI coding knowledge base:
  114. - 🎯 **Explicit Opt-In**: Nothing syncs to SpecStory Cloud without an optional sign-up and login first
  115. - 🔍 **Search Everywhere**: Full-text search across all your projects from all your computers.
  116. - 💬 **Chat with Your History**: Ask questions across your sessions to revisit decisions, understand past work, and find solutions.
  117. - 📚 **Organized by Project**: Automatic categorization by repository and time
  118. - 🚀 **API Access**: Programmatic sync and search for automation
  119. - 👥 **Team Features**: Share knowledge across your organization with SpecStory Cloud for Teams
  120. [Get Started with SpecStory Cloud →](https://cloud.specstory.com)
  121. ### How to Sync to Cloud
  122. | Method | One-Time Setup | Live Sessions | Past Sessions |
  123. |----------------------|--------------------------------------------------------------|--------------------------------------------------------|------------------------------------------------------|
  124. | **SpecStory CLI** | `specstory login` | Auto-pushed when using `specstory run` while logged in | Use `specstory sync` to push existing local sessions |
  125. | **Cursor Extension** | Command Palette → "SpecStory: Open Cloud Sync Configuration" | Configure auto-sync in settings | Use sync command from Command Palette |
  126. | **VSCode Extension** | Command Palette → "SpecStory: Open Cloud Sync Configuration" | Configure auto-sync in settings | Use sync command from Command Palette |
  127. > [!IMPORTANT]
  128. > **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.
  129. ## Lore 📜
  130. [**Lore**](./lore) turns the sessions SpecStory saves into agent skills forged from how you actually work. Your sessions are your lore.
  131. ### The Problem We Solve
  132. - **Repeated Yourself Again**: You re-explain the same workflows, conventions, and fixes to your agent every session
  133. - **Skills From Guesswork**: Hand-written agent skills describe how you think you work, not how you demonstrably do
  134. ### The Solution
  135. 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.
  136. Install:
  137. ```sh
  138. npx skills add specstoryai/getspecstory --skill lore
  139. ```
  140. Then invoke it - `/lore` in Claude Code, `$lore` in Codex, or just ask ("mine my lore") in Gemini CLI and others:
  141. ```
  142. /lore
  143. ```
  144. [Get Started with Lore →](./lore)
  145. ## Documentation & Support
  146. - 📚 **[Full Documentation](https://docs.specstory.com/overview)** - Complete guides and [Cloud API reference](https://docs.specstory.com/api-reference/introduction)
  147. - 📜 **[Lore](./lore)** - Forge your `.specstory/history` into installable agent skills, with evidence and outcomes
  148. - 🐛 **[Report Issues](https://github.com/specstoryai/getspecstory/issues)** - We actively monitor and respond
  149. - 📖 **[Contribute to Docs](https://github.com/specstoryai/docs/)** - PRs welcome!
  150. ## Reviews & Feedback
  151. 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)! 🧠
  152. ## Star History
  153. ![Star History Chart](https://api.star-history.com/svg?repos=specstoryai/getspecstory&type=Date)
  154. ---
  155. Made with ❤️ by SpecStory

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.