Sync and storage

The extensions and CLI capture coding agent sessions locally. When Cloud sync is enabled and you are authenticated, they upload session data so you can search and share it in Cloud.

The CLI's run and watch commands can sync as you work. sync exports existing sessions and uploads them when logged in. Logging in alone does not upload your history.

Run SpecStory: Open Cloud Sync Configuration from the Command Palette. Sign in and choose the project sync setting. Once enabled, sync runs automatically.

To share one conversation without ongoing sync, use SpecStory: Share AI Chat History. See session sharing.

# Authenticate this device
specstory login

# Export and sync sessions in the current project
specstory sync

# Export and sync one Claude Code session
specstory sync claude -s <session-id>

# Save locally without uploading
specstory sync --no-cloud-sync

You can also disable uploads in your user or project configuration:

[cloud_sync]
enabled = false

See the CLI reference for configuration paths and precedence.

1. Check the CLI output or extension output for errors.
2. Open Cloud and find your project.
3. Open a session and check its content.

If nothing appears, confirm you are in the right project, signed into the intended account, and have sync enabled. Run specstory list to check which local sessions the CLI can find.