---
title: "Capture, search, and optionally sync local coding-agent session history across Claude Code, Codex, Cursor CLI, and Gemini with SpecStory"
description: "Use SpecStory when valuable coding-agent decisions keep disappearing into terminal history and you need one cross-agent workflow to auto-save, search, summarize, and optionally share those sessions."
verification: "security_reviewed"
source: "https://github.com/specstoryai/getspecstory"
author: "SpecStory AI"
publisher_type: "organization"
category:
  - "Developer Tools"
framework:
  - "Multi-Framework"
tool_ecosystem:
  github_repo: "specstoryai/getspecstory"
  github_stars: 1181
---

# Capture, search, and optionally sync local coding-agent session history across Claude Code, Codex, Cursor CLI, and Gemini with SpecStory

Use SpecStory when valuable coding-agent decisions keep disappearing into terminal history and you need one cross-agent workflow to auto-save, search, summarize, and optionally share those sessions.

## Prerequisites

A supported coding agent such as Claude Code, Codex CLI, Cursor CLI, Droid CLI, or Gemini CLI, plus the SpecStory CLI or supported editor extension.

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install the open SpecStory CLI with `brew tap specstoryai/tap && brew install specstory`, run `specstory check`, then launch a supported agent with `specstory run <agent>` so sessions are auto-saved to `.specstory/history/`.
```

## Documentation

- https://specstory.com/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/capture-search-and-optionally-sync-local-coding-agent-session-history-across-claude-code-codex-cursor-cli-and-gemini-with-specstory/)