Reference

store

GitHub Edit page

store

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

wacli store manages the 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.

#Examples

wacli store stats
wacli store cleanup --days 365 --dry-run
wacli chats cleanup --jid 1234567890@s.whatsapp.net --dry-run
wacli groups prune --dry-run
wacli groups prune --days 180 --dry-run
wacli groups prune --include-active --days 365 --dry-run