Headless CLI (snapflow-sync)

Scripting-friendly commands.

The packaged app installs a CLI shim alongside the GUI. Available subcommands:

snapflow-sync version
snapflow-sync login --server https://snap-flow.org --email you@example.com --password ...
snapflow-sync logout
snapflow-sync albums list [--json]
snapflow-sync verify --album <id|name> [--json]

Credentials are shared with the GUI via the macOS Keychain — sign in once from either surface and both work.

The sync command exists as a stub today. Headless sync needs a longer-lived process (the engine extracted from the GUI's runtime); use the GUI's Sync now button for now.