CLI‑dry run

--dry-run

Preview one sync without writing files, state, or sync tokens.

Usage

kei sync --dry-run
kei sync --config /path/to/config.toml --dry-run

Put durable settings such as username, download directory, albums, and media filters in TOML. --dry-run is only the one-run safety switch.

Details

• Default: false
• Type: boolean flag
• Available on sync, service run, import-existing, reconcile, and install

For sync, kei still authenticates and enumerates assets. It reports the files it would download, but it doesn't create media files, write state rows, advance sync tokens, or update reports.

Useful for:

• Estimating how many files a config will select.
• Checking [filters] and recency settings.
• Checking folder templates before committing to a layout.

kei install --dry-run is different: it renders the service artifact and reports what would happen without writing unit, plist, or SCM entries.

Related

• Configuration
• Folder Structure
• Content Filtering