CLI‑retry failed

--retry-failed

Re-sync only assets currently marked failed in the state database.

Usage

kei sync --retry-failed

Details

• Type: boolean flag
• Default: off
• Available on sync and service run

When set, kei skips the normal CloudKit enumeration path and re-queues failed assets from the state DB. Use it after fixing a transient cause such as disk space, session expiry, or a CDN outage.

Normal syncs also retry failed assets alongside newly discovered work. --retry-failed is the explicit failed-only form.

Retry limits come from TOML:

[download.retry]
per_transfer = 3
per_asset = 10

Related

• Retry & Resilience
• kei status --failed
• State Tracking