wacli-messages-list
List messages from a WhatsApp chat
TLDR
SYNOPSIS
wacli messages list [--chat jid] [--sender jid] [--from-me|--from-them] [--asc] [--limit n] [--after date] [--before date] [--forwarded] [--starred] [--json] [--store dir]
DESCRIPTION
wacli messages list retrieves messages from the local SQLite store, optionally filtered to a single chat (JID), sender, direction, flags, and/or a time window. Output is human-readable by default; use `--json` for machine consumption.WhatsApp status broadcasts are stored separately and are not returned by `messages list`.The local store is populated by `wacli sync` (or `sync --follow`). Default store path is `~/.local/state/wacli` on Linux and `~/.wacli` elsewhere (existing `~/.wacli` on Linux continues to work).
PARAMETERS
--chat jid
Restrict to messages in this chat JID (e.g. `491234567890@s.whatsapp.net` or a group JID).--sender jid
Restrict to messages from this sender JID.--from-me, --from-them
Only messages sent by you, or only messages from others.--asc
Sort ascending (oldest first). Default order is newest first.--after date
Only messages on or after this time (RFC3339 or `YYYY-MM-DD`).--before date
Only messages before this time (RFC3339 or `YYYY-MM-DD`).--limit n
Maximum number of messages to return.--forwarded
Only forwarded messages.--starred
Only starred messages.--json
Emit JSON instead of a human-readable table.--store dir
Override the store directory (cannot be combined with `--account`).
SEE ALSO
wacli(1), wacli-messages-search(1), wacli-messages-show(1), wacli-messages-context(1)
