specstory.com

# SpecStory

> SpecStory saves coding-agent conversations. RunStory runs software, reports reproducible failures to coding agents, and verifies fixes.

## When to use this site

- Install SpecStory extensions or the CLI to save prompts, decisions, and coding-agent sessions.
- Find supported agents, configuration, troubleshooting, and session export instructions in the product docs.
- Learn about RunStory's private alpha for testing CLI and web applications in isolated sandboxes.
- Learn agentic engineering with the free 25 Patterns book, our course, and the blog.
- Find the SpecStory team, contact details, privacy notice, and terms.

## Read content programmatically

Request any public page with `Accept: text/markdown` to read its Markdown representation. Responses vary by Accept. Direct Markdown links below also work without negotiation.

- [Public content index](https://specstory.com/api/content.json): all published page IDs, descriptions, and representation URLs in one response. No authentication required.
- [OpenAPI specification](https://specstory.com/openapi.json): typed GET operations for the public content index and individual pages.
- [Website sitemap](https://specstory.com/sitemap.xml): canonical company and product page URLs.
- [Documentation sitemap](https://docs.specstory.com/sitemap.xml): canonical documentation URLs.

## Product boundaries

The website content API is read-only and free to access. SpecStory extensions and the CLI are free. Cloud has a free plan; features such as analytics and skills depend on your plan. RunStory is a private alpha; no public price is announced here. Course availability and pricing are maintained on [Maven](https://maven.com/specstory/hardcore-agentic-engineering-for-builders-who-ship).

Private synced projects and sessions belong to [SpecStory Cloud](https://cloud.specstory.com), whose [API documentation](https://docs.specstory.com/api-reference/introduction) and [authentication guide](https://docs.specstory.com/api-reference/authentication) describe the separate authenticated service. Never send Cloud API tokens to this public website. Alpha enrollment requires the visitor's consent on [/runstory#alpha](https://specstory.com/runstory#alpha).

## Contact

SpecStory, Inc. · [Contact](https://specstory.com/contact) · info@specstory.com.

## Pages

- [SpecStory — Software should do what you meant.](https://specstory.com/): Save the conversations behind your code with SpecStory. RunStory tests your software and sends defects back to your coding agent. [Markdown](https://specstory.com/markdown/index.md)
- [SpecStory | Free Extensions, CLI & Cloud](https://specstory.com/specstory): Save coding-agent conversations with SpecStory extensions and CLI. Keep local Markdown files and optionally sync to SpecStory Cloud to search and share your history. [Markdown](https://specstory.com/markdown/specstory.md)
- [RunStory | Test What Your Coding Agent Builds](https://specstory.com/runstory): RunStory runs your software, sends reproducible failures to your coding agent, and verifies the fix. Explore the private alpha for CLI and web apps. [Markdown](https://specstory.com/markdown/runstory.md)
- [Education | SpecStory](https://specstory.com/education): Read 25 Patterns in Agentic Engineering, our free field guide, and put the patterns into practice with Hardcore Agentic Engineering. [Markdown](https://specstory.com/markdown/education.md)
- [Blog | SpecStory](https://specstory.com/blog): Guides and updates from our team and community on coding agents, agentic engineering, and building software with SpecStory and RunStory. [Markdown](https://specstory.com/markdown/blog.md)
- [Tutorials | SpecStory](https://specstory.com/tutorials): Step-by-step guides from the SpecStory team on building real features with coding agents, from signup flows to verification. [Markdown](https://specstory.com/markdown/tutorials.md)
- [About | SpecStory](https://specstory.com/about): Why we built SpecStory to preserve coding-agent conversations, and why we’re building RunStory to verify what the software actually does. [Markdown](https://specstory.com/markdown/about.md)
- [Contact | SpecStory](https://specstory.com/contact): Contact the SpecStory team for product help, questions about RunStory, education, and privacy. [Markdown](https://specstory.com/markdown/contact.md)
- [Book a Design Call | SpecStory](https://specstory.com/design-call): Book a free 30-minute call with the SpecStory founders. We’ll help you turn one of your core requirements into a repeatable, test-driven agentic loop. [Markdown](https://specstory.com/markdown/design-call.md)
- [Privacy Policy | SpecStory](https://specstory.com/privacy): Read SpecStory’s privacy policy. [Markdown](https://specstory.com/markdown/privacy.md)
- [Terms of Use | SpecStory](https://specstory.com/terms): Read SpecStory’s terms of use. [Markdown](https://specstory.com/markdown/terms.md)
- [Toyota manufactures learning (and cars). Lessons for your software factory. | SpecStory Blog](https://specstory.com/blog/toyota-manufactures-learning): We talk about software factories and picture finished products rolling off the line without a human hand in the mix. The picture is useful. But the history of real factories carries a… [Markdown](https://specstory.com/markdown/blog/toyota-manufactures-learning.md)
- [Ten Ways to Let an Agent Test an Electron App | SpecStory Blog](https://specstory.com/blog/ten-ways-to-let-an-agent-test-an-electron-app): An agent here means a program, such as a coding assistant, that starts your app, drives it, reads what happened and decides whether it passed. These ten ideas make that possible without… [Markdown](https://specstory.com/markdown/blog/ten-ways-to-let-an-agent-test-an-electron-app.md)
- [Why Twiniti Started Using SpecStory | SpecStory Blog](https://specstory.com/blog/why-we-started-using-specstory): AI-assisted development has changed the way we build software at Twiniti. [Markdown](https://specstory.com/markdown/blog/why-we-started-using-specstory.md)
- [SpecStory in Action: How a Deleted Repo Was Rebuilt from History | SpecStory Blog](https://specstory.com/blog/how-a-deleted-repo-was-rebuilt-from-history): AI-assisted coding is powerful, but anyone who’s spent time with it knows that it’s not always predictable. What looks like a productive session can sometimes take a sharp turn. For one… [Markdown](https://specstory.com/markdown/blog/how-a-deleted-repo-was-rebuilt-from-history.md)
- [How to be an Open Source Hero: Contributing AI-Generated Code with Care | SpecStory Blog](https://specstory.com/blog/how-to-be-an-opensource-hero): AI coding tools are now part of everyday development. They help contributors explore new codebases, draft solutions quickly, and learn unfamiliar patterns. For people opening pull… [Markdown](https://specstory.com/markdown/blog/how-to-be-an-opensource-hero.md)
- [SpecStory in Action: From AI Session to Blog Post | SpecStory Blog](https://specstory.com/blog/from-ai-session-to-blogpost): Most people think AI coding is all about speed and treat their AI coding sessions as disposable. You generate the code you need, close the tab, and move on. [Markdown](https://specstory.com/markdown/blog/from-ai-session-to-blogpost.md)
- [Building a Mintlify Alternative with AI (Part 1) | SpecStory Blog](https://specstory.com/blog/building-a-mintlify-alternative-with-AI-Part-1): In this tutorial, we'll build TinyDocs, an open-intent alternative to Mintlify, using AI-driven development to handle planning, research, and coding. [Markdown](https://specstory.com/markdown/blog/building-a-mintlify-alternative-with-AI-Part-1.md)
- [SpecStory Studio Case Study | SpecStory Blog](https://specstory.com/blog/process-mining): This process analysis examines the development of SpecStory Studio from May 8 to June 2, 2025, revealing how four human developers successfully orchestrated AI agents to build a complex… [Markdown](https://specstory.com/markdown/blog/process-mining.md)
- [Workshop: From Vibes to Validation: A Hands-On Approach to Product Discovery | SpecStory Blog](https://specstory.com/blog/workshop-vibes-to-validation): Goal: By the end of this session, you'll be able to start from scratch and create a working software prototype that serves as a mechanism for user and customer feedback—turning your… [Markdown](https://specstory.com/markdown/blog/workshop-vibes-to-validation.md)
- [Now serving two: GitHub Copilot | SpecStory Blog](https://specstory.com/blog/specstory-and-copilot): Four months ago, SpecStory flipped the lights on with one lovable child. Our Cursor extension. We promised ourselves we wouldn't rush into more kids. Then came your inbox-flooding… [Markdown](https://specstory.com/markdown/blog/specstory-and-copilot.md)
- [Keep Cursor Aligned with Your Intent | SpecStory Blog](https://specstory.com/blog/keeping-cursor-aligned-with-your-intent): Hey there, builders! 👋 Today, I'm thrilled to share a new feature that's going to make your AI-assisted coding experience significantly smoother. [Markdown](https://specstory.com/markdown/blog/keeping-cursor-aligned-with-your-intent.md)
- [Build Me Anything: AI-coded Apps from Community Ideas | SpecStory Blog](https://specstory.com/blog/build-me-anything): What if we built 48 apps in a single day? [Markdown](https://specstory.com/markdown/blog/build-me-anything.md)
- [Dangit, Cursor!?! | SpecStory Blog](https://specstory.com/blog/dangit-cursor): Cursor is awesome, but sometimes things get weird. And unfortunately there isn't an instruction manual. Here's how I solve common "dangit" moments while building stuff with natural language. [Markdown](https://specstory.com/markdown/blog/dangit-cursor.md)
- [Using Cursor to Create Sample Data for your NextJS App | SpecStory Blog](https://specstory.com/blog/using-cursor-to-create-sample-data-for-nextjs): This is going to be a hands-on tutorial for getting sample data into a prototype application that you’re composing. We’ll demonstrate using a NextJS web application, but the same… [Markdown](https://specstory.com/markdown/blog/using-cursor-to-create-sample-data-for-nextjs.md)
- [A CEO's Journey Back to Code | SpecStory Blog](https://specstory.com/blog/a-ceos-journey-back-to-code): There's a peculiar feeling that many product leaders know well – the combination of pride and slight detachment that comes during a product launch. You're there, heart racing with… [Markdown](https://specstory.com/markdown/blog/a-ceos-journey-back-to-code.md)
- [SpecStory Launch | SpecStory Blog](https://specstory.com/blog/specstory-launch): Today, we're thrilled to introduce SpecStory - we make it easy to capture, search and learn from every AI coding journey. [Markdown](https://specstory.com/markdown/blog/specstory-launch.md)
- [How to make an SMS signup agent | SpecStory Tutorials](https://specstory.com/tutorials/howto-make-an-sms-signup-agent): A prompt you can hand to your coding agent to turn a signup form into a texting conversation run by an AI assistant, using LoopMessage, Vercel AI Gateway, and Vercel Workflow. The setup… [Markdown](https://specstory.com/markdown/tutorials/howto-make-an-sms-signup-agent.md)
- [Authentication | SpecStory Docs](https://docs.specstory.com/api-reference/authentication): The SpecStory Cloud API uses JWT Bearer token authentication for all requests. You'll need to include your API key in the Authorization header of every request. [Markdown](https://specstory.com/markdown/docs/api-reference/authentication.md)
- [Error Handling | SpecStory Docs](https://docs.specstory.com/api-reference/errors): The SpecStory Cloud API uses conventional HTTP response codes to indicate the success or failure of an API request. Error responses include detailed information to help you understand and resolve issues. [Markdown](https://specstory.com/markdown/docs/api-reference/errors.md)
- [GraphQL Endpoint | SpecStory Docs](https://docs.specstory.com/api-reference/graphql-endpoint): Execute GraphQL queries for advanced data retrieval and search [Markdown](https://specstory.com/markdown/docs/api-reference/graphql-endpoint.md)
- [GraphQL Examples | SpecStory Docs](https://docs.specstory.com/api-reference/graphql-examples): Practical GraphQL query examples for the SpecStory Cloud API - search, filter, and retrieve your AI conversation data efficiently [Markdown](https://specstory.com/markdown/docs/api-reference/graphql-examples.md)
- [GraphQL API Overview | SpecStory Docs](https://docs.specstory.com/api-reference/graphql): Advanced querying interface for complex operations, filtering, and full-text search [Markdown](https://specstory.com/markdown/docs/api-reference/graphql.md)
- [Cloud API | SpecStory Docs](https://docs.specstory.com/api-reference/introduction): Manage your projects and coding-agent sessions programmatically with the SpecStory Cloud REST and GraphQL APIs. [Markdown](https://specstory.com/markdown/docs/api-reference/introduction.md)
- [Delete Project | SpecStory Docs](https://docs.specstory.com/api-reference/projects/delete-project): Permanently delete a project and all its sessions [Markdown](https://specstory.com/markdown/docs/api-reference/projects/delete-project.md)
- [List Projects | SpecStory Docs](https://docs.specstory.com/api-reference/projects/list-projects): Retrieve all projects in your workspace [Markdown](https://specstory.com/markdown/docs/api-reference/projects/list-projects.md)
- [Update Project | SpecStory Docs](https://docs.specstory.com/api-reference/projects/update-project): Update project name, icon, or color [Markdown](https://specstory.com/markdown/docs/api-reference/projects/update-project.md)
- [Check Session | SpecStory Docs](https://docs.specstory.com/api-reference/sessions/check-session): Check if a session exists and get metadata without retrieving content [Markdown](https://specstory.com/markdown/docs/api-reference/sessions/check-session.md)
- [Delete Session | SpecStory Docs](https://docs.specstory.com/api-reference/sessions/delete-session): Permanently delete a session and its content [Markdown](https://specstory.com/markdown/docs/api-reference/sessions/delete-session.md)
- [Get Recent Sessions | SpecStory Docs](https://docs.specstory.com/api-reference/sessions/get-recent-sessions): Retrieve the most recent sessions across all projects [Markdown](https://specstory.com/markdown/docs/api-reference/sessions/get-recent-sessions.md)
- [Get Session | SpecStory Docs](https://docs.specstory.com/api-reference/sessions/get-session): Retrieve a specific session with its content and metadata [Markdown](https://specstory.com/markdown/docs/api-reference/sessions/get-session.md)
- [List Sessions | SpecStory Docs](https://docs.specstory.com/api-reference/sessions/list-sessions): List all sessions for a specific project [Markdown](https://specstory.com/markdown/docs/api-reference/sessions/list-sessions.md)
- [Analytics | SpecStory Docs](https://docs.specstory.com/cloud/analytics): Analytics gives you a cross-agent view of your AI coding activity. Every session you sync — from Claude Code, Codex CLI, Antigravity CLI, Cursor, and more — feeds a single dashboard where you can see how much you code with AI, when you do it, how deep your conversations go, and what it's costing you. [Markdown](https://specstory.com/markdown/docs/cloud/analytics.md)
- [Cloud overview | SpecStory Docs](https://docs.specstory.com/cloud/overview): Search and share your coding agent sessions across projects and machines. [Markdown](https://specstory.com/markdown/docs/cloud/overview.md)
- [Set up Cloud | SpecStory Docs](https://docs.specstory.com/cloud/quickstart): Connect your account, sync a project, and find your first session. [Markdown](https://specstory.com/markdown/docs/cloud/quickstart.md)
- [Search your sessions | SpecStory Docs](https://docs.specstory.com/cloud/search-and-organization): Find the prompts and decisions you want to use again. [Markdown](https://specstory.com/markdown/docs/cloud/search-and-organization.md)
- [Share a session | SpecStory Docs](https://docs.specstory.com/cloud/session-sharing): Give someone the context behind a change with a public, read-only session link. [Markdown](https://specstory.com/markdown/docs/cloud/session-sharing.md)
- [Sync and storage | SpecStory Docs](https://docs.specstory.com/cloud/sync-and-store): Choose which sessions reach Cloud while keeping local Markdown available. [Markdown](https://specstory.com/markdown/docs/cloud/sync-and-store.md)
- [Troubleshooting | SpecStory Docs](https://docs.specstory.com/faqs): Check capture, sync, and reuse when something is missing. [Markdown](https://specstory.com/markdown/docs/faqs.md)
- [Product Docs | SpecStory](https://docs.specstory.com/): Guides for SpecStory extensions, CLI, Cloud, and RunStory. [Markdown](https://specstory.com/markdown/docs.md)
- [Antigravity CLI | SpecStory Docs](https://docs.specstory.com/integrations/antigravity-cli): Save Antigravity CLI sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/antigravity-cli.md)
- [Claude Code | SpecStory Docs](https://docs.specstory.com/integrations/claude-code): Save Claude Code sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/claude-code.md)
- [Codex CLI | SpecStory Docs](https://docs.specstory.com/integrations/codex-cli): Save Codex CLI sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/codex-cli.md)
- [Cursor CLI | SpecStory Docs](https://docs.specstory.com/integrations/cursor-cli): Save Cursor CLI sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/cursor-cli.md)
- [Cursor | SpecStory Docs](https://docs.specstory.com/integrations/cursor): Save your Cursor conversations in your project. [Markdown](https://specstory.com/markdown/docs/integrations/cursor.md)
- [Droid CLI | SpecStory Docs](https://docs.specstory.com/integrations/droid-cli): Save Droid CLI sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/droid-cli.md)
- [Gemini CLI | SpecStory Docs](https://docs.specstory.com/integrations/gemini-cli): Save Gemini CLI sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/gemini-cli.md)
- [Muse Code | SpecStory Docs](https://docs.specstory.com/integrations/muse-code): Save Muse Code sessions with the SpecStory CLI. [Markdown](https://specstory.com/markdown/docs/integrations/muse-code.md)
- [Install the CLI | SpecStory Docs](https://docs.specstory.com/integrations/terminal-coding-agents): Save coding agent sessions from your terminal as local Markdown. Search, resume, and optionally sync them to Cloud. [Markdown](https://specstory.com/markdown/docs/integrations/terminal-coding-agents.md)
- [Search and resume | SpecStory Docs](https://docs.specstory.com/integrations/terminal-coding-agents/resume): Pick up a past coding-agent session where you left off — in the same agent, a different agent, a different project, or from another machine via SpecStory Cloud. [Markdown](https://specstory.com/markdown/docs/integrations/terminal-coding-agents/resume.md)
- [CLI reference | SpecStory Docs](https://docs.specstory.com/integrations/terminal-coding-agents/usage): This page is a quick reference for: SpecStory CLI commands, flags, the files created in your project, configuration and debugging. [Markdown](https://specstory.com/markdown/docs/integrations/terminal-coding-agents/usage.md)
- [VS Code + Copilot | SpecStory Docs](https://docs.specstory.com/integrations/vscode): Save your GitHub Copilot Chat conversations in your project. [Markdown](https://specstory.com/markdown/docs/integrations/vscode.md)
- [Data Privacy | SpecStory Docs](https://docs.specstory.com/privacy): Transparency into what we collect and access to deliver SpecStory [Markdown](https://specstory.com/markdown/docs/privacy.md)
- [Quickstart | SpecStory Docs](https://docs.specstory.com/quickstart): Choose the extension or CLI for your coding agent. Add Cloud when you want to search and share across projects. [Markdown](https://specstory.com/markdown/docs/quickstart.md)
- [How RunStory works | SpecStory Docs](https://docs.specstory.com/runstory/how-it-works): From the change you asked for to a failure your coding agent can reproduce and fix. [Markdown](https://specstory.com/markdown/docs/runstory/how-it-works.md)
- [RunStory overview | SpecStory Docs](https://docs.specstory.com/runstory): RunStory checks what your coding agent changes actually do. It is in private alpha. [Markdown](https://specstory.com/markdown/docs/runstory.md)
- [Assessing | SpecStory Docs](https://docs.specstory.com/skills/assessing): The kinds of skills SpecStory mines, and the confidence signals that help you decide which to keep. [Markdown](https://specstory.com/markdown/docs/skills/assessing.md)
- [Skills overview | SpecStory Docs](https://docs.specstory.com/skills): SpecStory mines your synced coding-agent sessions into reusable, installable Agent Skills — review them in the cloud, install them with the CLI. [Markdown](https://specstory.com/markdown/docs/skills.md)
- [Installation | SpecStory Docs](https://docs.specstory.com/skills/installation): Install SpecStory-mined skills into your coding agents with the CLI — what happens on disk, which agents are supported, and how to uninstall. [Markdown](https://specstory.com/markdown/docs/skills/installation.md)
- [Review & Run | SpecStory Docs](https://docs.specstory.com/skills/review): Browse, review, and trigger skill mining runs from the Skills page on SpecStory Cloud. [Markdown](https://specstory.com/markdown/docs/skills/review.md)
- [Save and reuse conversations | SpecStory Docs](https://docs.specstory.com/specstory/features): Keep your coding agent sessions as readable files alongside your project. [Markdown](https://specstory.com/markdown/docs/specstory/features.md)
- [Install the extensions | SpecStory Docs](https://docs.specstory.com/specstory/introduction): Automatically save coding agent conversations in Cursor or VS Code with GitHub Copilot. [Markdown](https://specstory.com/markdown/docs/specstory/introduction.md)
- [Your first saved session | SpecStory Docs](https://docs.specstory.com/specstory/quickstart): Install SpecStory, have a coding conversation, and check the saved file. [Markdown](https://specstory.com/markdown/docs/specstory/quickstart.md)
- [Extension settings | SpecStory Docs](https://docs.specstory.com/specstory/settings): Change how SpecStory works. [Markdown](https://specstory.com/markdown/docs/specstory/settings.md)
- [How the products fit together | SpecStory Docs](https://docs.specstory.com/started): SpecStory keeps your coding agent context. RunStory checks the software that comes from it. [Markdown](https://specstory.com/markdown/docs/started.md)