Save and reuse conversations
Keep your coding agent sessions as readable files alongside your project.
Autosave
The extension saves conversations in .specstory/history/, including prompts, responses, and code blocks. Autosave runs in the background and is enabled by default.
You can turn it off with specstory.autoSave in extension settings.
Save a conversation manually
Open the Command Palette and run SpecStory: Save AI Chat History. Select the conversations you want to save. You can export them separately or combine them into a Markdown file.
Reuse the context
Open a saved file to revisit a prompt or decision. Reference the file in your next coding agent session to carry the context forward. You can also commit history files alongside the code they explain.
The extension saves files without rewriting your editor's original conversation database.
Sync and share
Enable Cloud sync to search your sessions across projects. Run SpecStory: Share AI Chat History to share a session. Sharing can perform a one-time upload without enabling ongoing sync.
See session sharing for public links, visibility controls, and revoking access.
Derive project rules
Enable specstory.derivedRules to derive instructions from your conversations. This requires autosave and sign-in. The extension writes rules to .cursor/rules/derived-rules.mdc or .github/copilot-instructions.md, depending on your editor.
Previous rule files are backed up in .specstory/ai_rules_backups. Review generated rules before relying on them. Settings let you customize their headers.