Spooling
CLI Reference
Back to spooling.ai

spooling watch

Continuously sync new local sessions as their files change.

spooling watch

Runs spooling sync whenever a file under any connected provider's data path changes. Useful for keeping the local DB fresh without remembering to run sync after every coding session.

How it works

Uses watchdog to subscribe to filesystem events under each provider's directory. On a debounced trigger, it calls the same code path as spooling sync.

Runs in the foreground. Stop with Ctrl+C.

Pair with cloud watch

spooling watch only updates the local DB. To keep Spooling Cloud in sync too, run the cloud watcher in a separate terminal (or under your process supervisor):

# terminal 1: provider files → local DB
spooling watch

# terminal 2: local DB → Spooling Cloud
spooling cloud watch

spooling cloud watch reference →

Running as a daemon

For a hands-off setup, wire both watchers into launchd (macOS) or systemd --user (Linux) so they restart on crash and survive reboots. A minimal launchd plist lives at examples/launchd/ in the OSS repo.

On this page