lore

Q: How to install lore?

Create the skills directory: mkdir -p .claude/skills. Then run: mkdir -p .claude/skills && curl -o .claude/skills/lore.md https://raw.githubusercontent.com/specstoryai/getspecstory/dev/lore/SKILL.md. Finally, /lore in Claude Code.

Q: What is lore best for?

lore is categorized under General. It covers: agent.

New

1.2kCommunity RegistryGeneralby SpecStory · Apache-2.0

Mine your SpecStory coding histories into a persistent corpus and forge your repeated workflows into installable agent skills.

First seen 6/18/2026

View Source

Summary

The lore skill mines your SpecStory coding histories into a persistent, searchable corpus, then forges your repeated workflows into installable agent skills.

It helps developers capture, index, and reuse knowledge from AI development conversations, turning ephemeral chats into durable assets.

Overview

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> <a href="https://specstory.com"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DrulesGenerated&style=flat-square" alt="Rules Generated" 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="https://github.com/specstoryai/agent-skills"><img src="https://img.shields.io/badge/Skills-Open%20Source-brightgreen?style=flat-square" alt="Skills Open Source" 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>

🔧 [Agent Skills](https://github.com/specstoryai/agent-skills) - Install skills to generate session summaries, fetch project stats, organize history, and more

How It Works

code

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 - Use Agent Skills to generate summaries, stats, and insights from your history
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](https://www.cursor.com/)	IDE	Closed	Cursor AI	v0.43.6+	Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install	📋 View
[VSC Copilot Extension](https://github.com/features/copilot)	IDE	Closed	GitHub Copilot	v1.300.0+	Search "SpecStory" in Extensions (Cmd/Ctrl+Shift+X) → Install	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	Claude Code	v1.0.27+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	Codex CLI	v0.42.0+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	Cursor CLI	v2025.09.18+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	Droid CLI	v0.56.3+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	Gemini CLI	0.15.1+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 View
[SpecStory CLI](https://specstory.com/specstory-cli)	CLI	Open	DeepSeek TUI	0.8.39+	`brew tap specstoryai/tap`<br/>`brew install specstory`	📋 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:

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 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 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** 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 →

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
•🔧 [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! 🧠

Star History

!Star History Chart

Install & Usage

Create the skills directory

mkdir -p .claude/skills

Download the skill file

mkdir -p .claude/skills && curl -o .claude/skills/lore.md https://raw.githubusercontent.com/specstoryai/getspecstory/dev/lore/SKILL.md

Invoke in Claude Code

/lore

Use Cases

Search your entire SpecStory history for a specific code snippet or architectural decision you discussed months ago.

Extract a recurring workflow (e.g., setting up a new microservice) from past conversations and package it as a reusable Claude Code skill.

Index all your project's AI interactions to build a team-shareable knowledge base of solutions and best practices.

Automatically generate a skill from a series of chat sessions that solved a complex bug, so you never have to debug it again.

Query your personal corpus for alternative implementation approaches you explored in earlier sessions.

Share a curated set of coding patterns from your SpecStory history as a skill for onboarding new team members.

Usage Examples

/lore search 'how did we implement OAuth flow'

/lore forge 'deploy to Kubernetes' from last 10 sessions

Create a skill from my SpecStory history that automates setting up a new React component with tests.

View source on GitHub

agent

Security Audits

LicensePassSourceWarnRepositoryPass

Frequently Asked Questions

What is lore?

The lore skill mines your SpecStory coding histories into a persistent, searchable corpus, then forges your repeated workflows into installable agent skills. It helps developers capture, index, and reuse knowledge from AI development conversations, turning ephemeral chats into durable assets.

How to install lore?

To install lore: create the skills directory (mkdir -p .claude/skills), then run: mkdir -p .claude/skills && curl -o .claude/skills/lore.md https://raw.githubusercontent.com/specstoryai/getspecstory/dev/lore/SKILL.md. Finally, /lore in Claude Code.

What is lore best for?

lore is a skill categorized under General. It is designed for: agent. Created by SpecStory.

What can I use lore for?

lore is useful for: Search your entire SpecStory history for a specific code snippet or architectural decision you discussed months ago.; Extract a recurring workflow (e.g., setting up a new microservice) from past conversations and package it as a reusable Claude Code skill.; Index all your project's AI interactions to build a team-shareable knowledge base of solutions and best practices.; Automatically generate a skill from a series of chat sessions that solved a complex bug, so you never have to debug it again.; Query your personal corpus for alternative implementation approaches you explored in earlier sessions.; Share a curated set of coding patterns from your SpecStory history as a skill for onboarding new team members..