​
Services we use to collect data

We use PostHog to collect product analytics. When you install the SpecStory Extension tracking is turned on by default. You may turn it off in settings via: specstory.helpUsImprove.

  • We log events including: when the extension is activated, when an auto-save occurs, when a manual save occurs, when a share occurs, when a custom rule is derived and when errors occur.

  • We use this telemetry to calculate total installs, active user counts and to understand other patterns like user retention.

We also use PostHog to collect web analytics, both on Specstory.com and share.specstory.com.

  • We use log events to understand time on site, improve usability in our share experience and monitor our own traffic and traffic to shares.

  • If you turn off specstory.helpUsImprove in the Extension settings it will not apply to the web analytics we collect.

In SpecStory v0.7.0 and later for the optional and Derived Rules feature, we use:

​
What data is accessed and collected by feature

​
Auto-saves and manual saves

Usage of these features never transmits your prompts or code in assistant responses to SpecStory.

Each of these features read from your local chat history stored in a sqlite3 state.vscdb or chat.jsons in different folders depending on your OS on your machine.

  • Windows: %APPDATA%\Cursor\User\globalStorage\state.vscdb

  • MacOS: ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb

  • Linux: ~/.config/Cursor/User/globalStorage/state.vscdb

These saves are then stored in your project’s .specstory folder.

​
Shares

Usage of this features transmits prompts and code in assistant responses to SpecStory.

This feature allows you to publish your local chat history to share.specstory.com. We store shares in Cloudflare R2 Object Storage.

  • Shared content is anonymous in the sense that we do not require authentication to share. But it is public.

  • We generate a non-guessable UUID for every share at the time of creation.

  • When you share your history, the request includes a device_id hash from your machine. This allows us to allow you to uniquely edit it without being authenticated.

  • As an editor, you can delete sensitive information in the share. You may also request full deletion of the object by e-mailing support the URL of the share.

​
Derived Rules

Usage of this features transmits prompts, code in assistant responses, markdown header information you supply and your project’s metadata to SpecStory.

This feature allows you to save time and improve code generation quality.

  • When you authenticate into the Extension and turn on the feature, as you prompt we send your prompt history, prior derived rules, file headers and project directory metadata to an LLM.

  • We log these requests via Helicone by user to track cost, response quality, error rates and prevent abuse.

  • We conduct aggregate analysis on the requests made by users of this feature to improve it.