Skip to content

Overview

Delete Me Discord is a command-line tool for deleting your own Discord messages and reactions with explicit filters and retention controls.

It is designed around a cautious workflow:

discover targets first
scope runs explicitly
preview behavior with --dry-run
only then execute

What it can do

delete your own messages in DMs and guild text channels
remove your own reactions alongside message cleanup
target specific channels, guilds, or parent/category IDs
keep recent history via time- and count-based retention
support repeated cleanup runs with preserve-cache
provide dry-run planning and timing summaries before you commit to a run

Start here

Use Installation to pick pipx, pip, or a binary.
Use Authentication to configure your token.
Use First Run for the safest dry-run workflow.

Common workflows

Full Channel Cleanup for one-off manual cleanup of a DM or channel
Rolling Retention for repeated cleanup while keeping a recent window
Delete Reactions when reaction cleanup matters too
Buffered Mode when you want stronger per-channel timing visibility

Core ideas

--dry-run scans and plans without deleting.
--preserve-last keeps messages newer than a given time delta.
--preserve-n keeps the last N messages per channel.
--fetch-max-age limits the fetched slice of history.
--buffer-channel-messages fetches one channel up front before evaluation, which enables better per-channel timing summaries for manual runs.

Reference

CLI Options for the full flag surface
Time Deltas for accepted duration formats
Log Output for interpreting run summaries
Preserve Cache for repeated-run behavior