delete-me-discord 2.2.0

Tool to mass delete your Discord messages and reactions with filters and retention controls.

Delete Me Discord

Delete Me Discord is a CLI for deleting your own Discord messages and reactions with explicit filters and retention rules. The installed command is available as delete-me-discord and the shorter alias dmd.

⚠️ Using automated tools on Discord may violate Discord’s Terms of Service. Use at your own risk.

It is built around a cautious workflow:

• discover targets first
• preview one explicit target with dmd clean --include-ids <channel_id> --dry-run
• only then execute

Installation

Python installs require Python 3.10 or newer.

pipx install delete-me-discord

Other install paths:

• pip install delete-me-discord
• prebuilt binaries from the latest release
• nix run github:janthmueller/delete-me-discord -- --help

More install details: Installation docs

Quick Start

Authenticate once:

dmd login

The token is stored in your system keyring, not in config.json.

Discover targets:

dmd list guilds
dmd list channels

Preview one channel safely:

dmd clean --include-ids <channel_id> --dry-run

Then rerun without --dry-run when the plan looks right.

Alternative auth for one shell:

export DISCORD_TOKEN=<your_token>

If you need token extraction steps, use this guide.

Documentation

See the documentation for installation, first-run guidance, rolling retention, and the full CLI reference.

Contributing

Contributions are welcome. Open an issue or pull request with improvements or bug fixes.

License

Licensed under the MIT License.