`dms`

Lists local wiretap DM conversations or reads one DM thread. Convenience layer over the synthetic @me guild id.

#Usage

discrawl dms
discrawl dms --with Molty --last 20
discrawl dms --with 1456464433768300635 --all
discrawl dms --search "launch checklist"
discrawl dms --with Molty --search "invoice"

#Default output

discrawl dms (no flags) shows one row per local DM channel with:

message count
author count
first/last cached message times

#Flags

--with <name|id> - switches to message output for that DM conversation (unless --list is also set)
--list - keep the channel-summary listing even when --with is set
--search <query> - search only local DM messages
--last <n> / --all / --limit <n> - same slicing as messages

#Notes

only sees data imported by wiretap - Discord Desktop cache, not live DM history
skips Git snapshot auto-update because DMs are never imported from the shared mirror
DMs are local-only and never published

#Empty results

dms reads the same tables as messages and search and prints the same stderr notes when a run returns nothing: the window notes for a --hours/--days/--since/--before listing, and the multi-term note for --search. They go to stderr, --json suppresses them, and stdout and the exit code are unchanged.

When a window note recommends removing all date filters, it counts only messages in catalogued conversations that the default dms listing can show. Uncatalogued DMs remain available through message queries, including dms with a matching date window. If the recommendation leaves another date filter in place, the note continues to count those messages.

A run that sets --with gets no note. --with names a person and the query matches it against channel id and channel name alike, which the counts behind a note cannot reproduce, so a --with run stays silent rather than reporting numbers taken from every conversation.

dms