CLI‑recent

--recent

Limit a sync to recent assets.

Usage

# Limit by count
kei sync --recent 100

# Keep the old per-filter count shape
kei sync --recent 100 --recent-scope per-filter

# Limit to assets from the last 30 days
kei sync --recent 30d

Details

• Default: none
• Type: integer count, or a days window such as 30d for sync
• TOML key: [filters].recent for permanent count-limited mirrors
• Scope key: [filters].recent_scope, with global or per-filter

Count-form recent defaults to global scope. kei takes the library-wide recent N, then album, smart-folder, unfiled, media, filename, and date filters narrow that fixed set. This is not an exact final file count. Filters and Live Photo components can change the final number of files.

Use --recent-scope per-filter or recent_scope = "per-filter" to take up to N from each selected album, smart folder, or unfiled pass.

The days form maps to skip_created_before. recent_scope only applies to count-form recent values. import-existing --recent accepts numeric counts only and errors on the days form.

Recent-limited full syncs don't advance full-enumeration sync tokens, because the library was intentionally only partly enumerated.

Related

• --recent-scope
• --skip-created-before
• --skip-created-after
• Content Filtering