Reset

reset

Delete state data to start fresh.

Usage

# Delete the state database (prompts for confirmation)
kei reset state

# Delete without prompting
kei reset state --yes

# Clear sync tokens only (keeps download history; prompts for confirmation on a TTY)
kei reset sync-token

# Skip the confirmation prompt (required under non-interactive use)
kei reset sync-token --yes

Subcommands

state

Deletes the SQLite state database entirely. The next sync treats every asset as new and re-downloads everything. Use this if the database is corrupted or you want a clean start.

Flag	Description
-y, --yes	Skip the confirmation prompt

sync-token

Clears stored CloudKit sync tokens from the database without deleting download history. The next sync does a full library enumeration instead of an incremental check, then stores fresh tokens.

Use this if incremental sync gets stuck - for example, the server keeps rejecting the token even after automatic fallback.

Flag	Description
-y, --yes	Skip the confirmation prompt (required under non-interactive use)

Without --yes, the command prompts on a TTY, warning that the next sync re-enumerates every asset, and errors under non-interactive use.

Flags

Common runtime flags such as --config, --log-level, --friendly, and --no-friendly apply to this command.

Related

• State Tracking