delete-me-discord 2.2.1

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.

Typical workflow:

• discover targets first
• preview with dmd clean --include-ids <id> --dry-run
• execute once the plan matches your intent

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

Discover targets:

dmd list guilds
dmd list channels

Preview the selected scope:

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

Then rerun without --dry-run when the plan looks right. --include-ids accepts one or more guild, category, guild text channel, DM, or Group DM IDs. Omit --include-ids to use the default scope: all eligible channels the tool can see.

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.