Skip to content

store.md

Latest commit

 

History

History
43 lines (33 loc) · 2 KB

store.md

File metadata and controls

43 lines (33 loc) · 2 KB

store

Read when: inspecting local SQLite size/counts or pruning old local chat/group rows.

wacli store manages the selected account's local wacli.db mirror. Cleanup commands only delete local wacli cache/history rows; they do not delete WhatsApp chats, leave groups, or remove messages from WhatsApp servers.

Commands

wacli store stats
wacli store cleanup [--days N] [--dry-run] [--confirm]

Related cleanup commands:

wacli chats cleanup [--days N] [--jid JID] [--dry-run] [--confirm]
wacli groups prune [--days N] [--left-only=false|--include-active] [--dry-run] [--confirm]

Notes

  • store stats reads local counts for chats, groups, left groups, and messages.
  • store cleanup removes chats whose known local activity is older than --days and deletes their messages through the SQLite chat/message cascade.
  • chats cleanup --jid JID removes one local chat row and its local messages.
  • groups prune removes local group metadata plus the matching local chat/messages for pruned group JIDs.
  • groups prune defaults to groups you have left. --days N limits that to groups left more than N days ago.
  • groups prune --include-active --days N also prunes active groups whose last known local message is older than N days. Groups with no known local activity timestamp are skipped.
  • Destructive cleanup commands require confirmation unless --confirm is passed.
  • Use --dry-run first; it lists what would be deleted without changing the local store.
  • Use --read-only or WACLI_READONLY=1 to make cleanup commands fail before opening the store for writes.
  • Use --account NAME to target a named account store. Use --store DIR for manual stores or migration debugging; it cannot be combined with --account.

Examples

wacli store stats
wacli store cleanup --days 365 --dry-run
wacli chats cleanup --jid [email protected] --dry-run
wacli groups prune --dry-run
wacli groups prune --days 180 --dry-run
wacli groups prune --include-active --days 365 --dry-run