Troubleshooting

In your editor, open a project folder and confirm SpecStory is enabled and specstory.autoSave is on. Start a short conversation, then check .specstory/history/. You can also try SpecStory: Save AI Chat History from the Command Palette.

For terminal agents, run specstory check and specstory list from your project folder. Use specstory sync to export existing sessions or specstory run <agent> to capture a new one. The folder must be writable.

Check your account and project sync setting. The CLI syncs when logged in unless --no-cloud-sync or your configuration disables it. See sync and storage.

Check that the agent is installed and available in your PATH. Run specstory check to inspect the CLI's configuration and detected agents. Use the current release of SpecStory and see the agent guides.

Reference its Markdown file in your next prompt. The extension does not write the conversation back into your editor's original chat database. The CLI supports resuming sessions, including supported cross-agent workflows.

The extensions and CLI are free. The CLI is open source under Apache 2.0. Cloud has a free plan, with additional features depending on your plan. RunStory is a separate product in private alpha.

Open a GitHub issue or email support@specstory.com. Include your editor or agent, SpecStory version, and the steps that failed. See data access and privacy for details about captured data.