getspecstory

Name: getspecstory
Author: specstoryai

Verified

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.

1,275stars

78forks

Installation

# Add to your Claude Code skills
git clone https://github.com/specstoryai/getspecstory

Getting Started

Guides for using ai agents skills like getspecstory.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 4/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-04-30T06:28:12.354Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is getspecstory?

getspecstory is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by specstoryai. 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. It has 1,275 GitHub stars.

Is getspecstory safe to use?

Yes. getspecstory passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install getspecstory?

Clone the repository with "git clone https://github.com/specstoryai/getspecstory" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is getspecstory written in?

getspecstory is primarily written in Go. It is open-source under specstoryai on GitHub, so you can review or fork the full source.

Are there alternatives to getspecstory?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh getspecstory against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

agents quint-code

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.

📜 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 /lore to 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	IDE	Closed	Cursor AI	v0.43.6+	Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install	📋 View
VSC Copilot Extension	IDE	Closed	GitHub Copilot	v1.300.0+	Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install	📋 View
SpecStory CLI	CLI	Open	Claude Code	v1.0.27+	`brew tap specstoryai/tapbrew install specstory`	📋 View
SpecStory CLI	CLI	Open	Codex CLI	v0.42.0+	`brew tap specstoryai/tapbrew install specstory`	📋 View
SpecStory CLI	CLI	Open	Cursor CLI	v2025.09.18+	`brew tap specstoryai/tapbrew install specstory`	📋 View
SpecStory CLI	CLI	Open	Droid CLI	v0.56.3+	`brew tap specstoryai/tapbrew install specstory`	📋 View
SpecStory CLI	CLI	Open	Gemini CLI	0.15.1+	`brew tap specstoryai/tapbrew install specstory`	📋 View
SpecStory CLI	CLI	Open	DeepSeek TUI	0.8.39+	`brew tap specstoryai/tapbrew install specstory`	📋 View
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 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 age