๐Ÿช„ Your work saves itself, no cloud required!

When you install SpecStory it begins its work in the background, automatically saving ๐Ÿ—„๏ธ your composer and chat history for your active project in ./specstory/history.

You can toggle this on and off in our settings.

๐ŸŽฏ Cherry pick your save worthy moments

If you want to combine selected conversations into a single file, you can do that too. Just open the command palette (Cmd/Ctrl+Shift+P) and run SpecStory: Save Composer and Chat History.

  • ๐Ÿ“ Presto! Run this command and watch your AI conversations transform into a beautiful markdown file right before your eyes!

  • ๐Ÿ‘€ No waiting around - it pops open instantly in your editor. (We love instant gratification!)

  • ๐Ÿ’พ Like what you see? Hit that Save button and your AI wisdom is safely tucked into your project files.

  • ๐ŸŒณ Feeling git-ty? Commit it to your repo just like any other file - because your AI conversations deserve version control too!

๐ŸŒŸ Share your history with a story!

Share your composer and chat history with others by opening the command pallette and running SpecStory: Share Composer and Chat History.

  • ๐ŸŒŽ Ready to share your AI coding adventures with the world? One command sends your composer and chat history sailing into the cloud, returning a magical URL just for you!

  • ๐ŸŽญ No signup required - your shares are anonymous. (But hey, keep those secret API keys and passwords to yourself, okay?)

  • ๐Ÿ”— Pro tip: Bookmark that special URL like itโ€™s your favorite cat gif - youโ€™ll want it later!

  • โœ๏ธ As the creator, you can add a description to your share, paste images, and curate which chats to include.

  • ๐Ÿ—‘๏ธ Having second thoughts? Need to make something disappear? Drop us a line at support@specstory.com with a link to the share and weโ€™ll take care of it faster than you can say โ€œdelete my search history.โ€

๐Ÿงช Auto-magically derive Cursor Project Rules

This an experimental feature that launched in SpecStory v0.7.0. Unlike all of the above features, itโ€™s use requires you to:

  • Have Auto-save enabled.

  • Create an account and sign-in to the SpecStory extension.

โ“ Unfamiliar with what Cursor Project Rules are? Consult the official docs or Cursor101.com.

There isnโ€™t a palette command this one. When you chat with composer, SpecStory is like a mystical scribe in the corner, quill poised, noting patterns in:

  • ๐Ÿง  Your thinking style: Do you prefer step-by-step explanations or quick solutions?

  • ๐Ÿ–‹๏ธ Your rule file headers: Those special incantations you set the structure of your derived file with.

  • ๐Ÿ”„ Your iteration cycles: How you refine code and conversation together with AI.

  • ๐Ÿ—๏ธ Your project structure: The architecture of your digital temple.

Thenโ€”abracadabra!โ€”SpecStory transmutes these observations into Cursor Project Rules, stored in the .cursor/rules directory as derived-cursor-rules.mdc.

๐ŸŒˆ Prompt Headers: The Secret Ingredient

SpecStory needs your rule file headers to brew the perfect rules. To start you off, weโ€™ve crafted a default based on distilled knowledge from the community hive mind of what tends to work best.

๐ŸŒŸ The Benefits of this Sorcery

  • ๐Ÿง™โ€โ™€๏ธ Less repetitive incantations: Reduced need to constantly explain your preferences every time.

  • โšก Faster spell-casting: AI responses align with your project from the start.

  • ๐Ÿ”„ Self-improving magic: As you work, the rules evolve to match your growing expertise.