Autosync
Automatic session syncing so you never lose work. The daemon pushes sessions to the cloud automatically, with configurable modes.
| Mode | Behavior |
|---|---|
| off (default) | Manual sync only. Run sfs push explicitly. |
| all | Every new or updated session auto-pushes to cloud. |
| selective | Only sessions in the watchlist auto-push. |
Enable autosync
Section titled “Enable autosync”sfs sync auto --mode allSelective mode
Section titled “Selective mode”sfs sync auto --mode selectivesfs sync watch ses_abc ses_def # Add to watchlistsfs sync unwatch ses_abc # Remove from watchlistsfs sync watchlist # Show watched sessionsCheck status
Section titled “Check status”sfs sync statusSync-aware deletes
Section titled “Sync-aware deletes”Sessions you delete stay deleted — autosync respects your intent. When you run sfs delete, the session is added to a local exclusion list and autosync skips it in both push and pull directions. See Delete Lifecycle for the full model.
How it works
Section titled “How it works”- Daemon detects session changes via filesystem events
- Changes are debounced (30 seconds default) to avoid hammering the API
- Session is packed and pushed with ETag conflict detection
- If offline, changes are queued and retried with exponential backoff
Configuration
Section titled “Configuration”In ~/.sessionfs/config.toml:
[sync]auto = "all"debounce = 30Or via the dashboard Settings page (propagates to daemon within 60 seconds).