Reset

reset

Delete state data to start fresh.

Replaces the deprecated reset-state command and --reset-sync-token flag.

Usage

# Delete the state database (prompts for confirmation)
kei reset state -u my@email.address

# Delete without prompting
kei reset state -u my@email.address --yes

# Clear sync tokens only (keeps download history)
kei reset sync-token -u my@email.address

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.

For a one-time full scan without clearing stored tokens, use --no-incremental on sync instead.

Flags

Global flags (--username, --config, --data-dir, --domain, --log-level) apply to this command.

Related

• State Tracking