Skip to content

Autosync

Automatic session syncing so you never lose work. The daemon pushes sessions to the cloud automatically, with configurable modes.

ModeBehavior
off (default)Manual sync only. Run sfs push explicitly.
allEvery new or updated session auto-pushes to cloud.
selectiveOnly sessions in the watchlist auto-push.
Terminal window
sfs sync auto --mode all
Terminal window
sfs sync auto --mode selective
sfs sync watch ses_abc ses_def # Add to watchlist
sfs sync unwatch ses_abc # Remove from watchlist
sfs sync watchlist # Show watched sessions
Terminal window
sfs sync status

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.

  1. Daemon detects session changes via filesystem events
  2. Changes are debounced (30 seconds default) to avoid hammering the API
  3. Session is packed and pushed with ETag conflict detection
  4. If offline, changes are queued and retried with exponential backoff

In ~/.sessionfs/config.toml:

[sync]
auto = "all"
debounce = 30

Or via the dashboard Settings page (propagates to daemon within 60 seconds).