Set up Cloud

Open SpecStory Cloud and sign in. Before syncing, check that the extension or CLI is saving your sessions.

1. Open your project in Cursor or VS Code.
2. Run SpecStory: Open Cloud Sync Configuration from the Command Palette.
3. Sign in and enable sync for this project. You can also choose the setting for future projects.
4. Open Cloud and check that the project and sessions appear.

Once enabled, the extension syncs sessions as you work.

Run these commands from your project folder:

specstory login
specstory sync

Login opens a browser to authenticate your device. sync exports available agent sessions for the project and uploads them when you are authenticated. Future run, watch, and sync commands can also sync automatically.

To disable uploads while continuing to save local Markdown, use --no-cloud-sync or set [cloud_sync] enabled = false in your CLI configuration.

Open Cloud, search for words from a prompt, and select a result. Use project and time filters to narrow the results.

If your session is missing, check the project you ran the CLI from, your login, and the sync output. See sync troubleshooting.