#Watching

Automatically upload screenshots when they are added to a directory.

#flowingto watch

Watch a directory for new image files:

flowingto watch ./screenshots -c <collection-id>

#Options

• -c, --collection <id> — Collection ID (required unless set in .flowingtorc.json)
• --delete — Delete the local file after it has been successfully uploaded

#How it works

The watcher uses chokidar to monitor the target directory. When a new image file is detected and becomes stable, the CLI uploads it automatically.

• Duplicate uploads are prevented by tracking file metadata.
• Failed uploads are retried up to 3 times with exponential backoff.
• The internal upload cache is limited to 10,000 entries.

#Use cases

• iOS Simulator screenshot folders
• Android emulator shared directories
• CI artifact output directories
• Design tool export folders

#Example with auto-delete

flowingto watch ./simulator-screenshots -c <collection-id> --delete

This keeps the local directory clean by removing files after they are uploaded to Flowingto.