Restore & Preview
Everything about previewing and restoring snapshots.
StateSense never modifies your workspace without your confirmation. The restore flow always goes through a preview step.
Restore flow
1
Open the snapshot
Click any snapshot in the StateSense sidebar. Right-click → Preview & Restore.
2
Review the Restore Preview panel
A panel opens showing all files grouped into Modified, Created, and Deleted. This is what will change if you confirm.
3
Inspect individual files
Click any file in the preview panel to open VS Code's diff viewer — current state on the right, snapshot state on the left.
4
Confirm or cancel
Click Confirm to apply the restore. Click Cancel to close the preview with no changes made.
How restoration works
StateSense uses incremental snapshots — each snapshot stores only the files that changed. To restore snapshot N, it replays all snapshots in sequence to reconstruct the exact workspace state at that point.
Files that were created after the target snapshot (and are unrelated to the snapshot) are preserved where possible, or reverted to their git HEAD state if they conflict.
Reminder: StateSense restores are local-only. Restored files are not automatically committed to git — review the diff and commit when you're ready.