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.

Generate Convert Improve

Install / Use

npx skills add specstoryai/getspecstory

Installs into whichever agent you are using.

About this skill

📐

.cursorrules

Cursor IDE rules (legacy)

Quality Score

93/100

Our assessment of getspecstory

getspecstory scores 93/100 on our quality scale, 531st of 4,614 Development & Engineering skills we index (top 12%).

Its .cursorrules is 16 KB long, well organised into 19 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.

With 1,368 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance

30/30

Structure

20/20

Description

15/15

Adoption

13/20

Freshness

15/15

Maintenance, license and trust

The repository was last updated today, so getspecstory is actively maintained.
Our last check on 2026-10-21 found the source still online.
It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-24. Automated pattern scan on 2026-09-24. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

getspecstory compared with similar skills

All 4 of these similar skills score higher than getspecstory; compare them before choosing.

Skill	Score	Stars	Updated	Format
getspecstory (this skill)by specstoryai	93	1.4k	today	.cursorrules
taste-skillby Leonxlnx	100	111.0k	1d ago	CLAUDE.md
ai-job-searchby ai-job-search-dev	100	70.0k	today	CLAUDE.md
claude-howtoby luongnv89	100	46.6k	3d ago	CLAUDE.md
lobehubby lobehub	100	84.2k	today	MCP Server

Frequently asked questions

How do I install getspecstory?: Run npx skills add specstoryai/getspecstory. The install tabs above show the steps for each supported agent.
Which AI agents does getspecstory work with?: It is written for Cursor, GitHub Copilot and OpenAI Codex, as a .cursorrules file. Other agents that read the same format can often use it too.
Is getspecstory safe to use?: Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is getspecstory still maintained?: The repository was last updated today, so getspecstory is actively maintained.

Skill content

View source on GitHub

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 ──▶   <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> Contribute to OSS ──▶  <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> Connect with us ───▶  <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>

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)
DeepSeek TUI       │
Antigravity CLI    │
Grok Build         │
Muse Code          │
OpenCode           │
Pi                 │
Qwen Code          ┘

Workflow

Capture - SpecStory CLI and IDE extensions save every AI interaction locally to .specstory/history/
Sync (Optional) - Sync your local sessions to SpecStory Cloud for safekeeping and team sharing
Search - Find conversations across all projects locally, or across multiple computers and team members in SpecStory Cloud
Chat (Optional) - Ask questions across your sessions in SpecStory Cloud to revisit decisions, understand past work, and find solutions
Share - Export and share specific solutions with your team
Resume - Resume sessions locally between different agents, and between multiple computers and team members with SpecStory Cloud
Process - Run /lore to mine your history into reusable, evidence-backed agent skills

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 SpecStory Cloud.

Installation

| Supported Agent | Agent Type | Min Version | SpecStory Product | Source Code | Installation | | ----------------------------------------------------------------------------- | ---------- | ------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | Cursor AI | IDE | v0.43.6+ | Cursor Extension | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | | GitHub Copilot | IDE | v1.300.0+ | VSC Copilot Extension | Closed | Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install | | Claude Code | CLI | v1.0.27+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Codex CLI | CLI | v0.42.0+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Cursor CLI | CLI | v2025.09.18+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Droid CLI | CLI | v0.56.3+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Gemini CLI | CLI | 0.15.1+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | DeepSeek TUI | CLI | 0.8.39+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Antigravity CLI | CLI | v1.1.5+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Muse Code | CLI | 0.1.0+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Qwen Code | CLI | 0.23.4+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Pi | CLI | 0.85.1+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Grok Build | CLI | 1.0.34+ | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | OpenCode | CLI | | SpecStory CLI | Open | brew tap specstoryai/tap brew install specstory | | Any Agent Skills | Skill | Node 22.5+ | Lore 📜 | Open | npx skills add specstoryai/getspecstory --skill lore |

[!TIP] Don't see the agent you need listed here? The SpecStory CLI is open source and it's easy to contribute new agent providers.

[!NOTE] For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. Learn why

Terminal Coding Agents

One installation works with all terminal coding agents - Claude Code, Cursor CLI, Codex, Droid, DeepSeek, Antigravity CLI, OpenCode, Qwen Code, and Pi:

# Check which agents are installed
specstory check

# Launch your preferred agent with session 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 deepseek     # Launch DeepSeek TUI
specstory run antigravity  # Launch Antigravity CLI
specstory run grok         # Launch Grok Build
specstory run muse         # Launch Muse Code
specstory run opencode     # Launch OpenCode
specstory run qwen         # Launch Qwen Code
specstory run pi           # Launch Pi
specstory run              # Launch the default agent (Claude Code)

# Render all prior agent coding sessions in the project as markdown
specstory sync

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.

Learn much more about the SpecStory CLI.

SpecStory Cloud ☁️

[*SpecStory Cloud

Truncated for display — read the full file on GitHub.

Related Skills

taste-skill

111.0k

Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

ai-job-search

70.0k

The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.

claude-howto

46.6k

A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.

lobehub

84.2k

🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.

specstoryai

View profile

View on GitHub

GitHub Stars1.4k

CategoryDevelopment

Updated9h ago

Forks93

specstoryai/getspecstory

Languages

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions