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 best for two kinds of work:

  • cleanup of selected guilds, categories, guild text channels, DMs, or Group DMs
  • recurring cleanup where you want to keep a recent slice and remove older history

Typical workflow:

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

If you are new to the tool, follow this order:

  1. Installation
  2. Authentication
  3. First Run
  • --dry-run scans and plans without deleting.
  • --include-ids scopes the run; omit it to use all eligible channels the tool can see.
  • --keep-within keeps messages newer than a given time delta.
  • --keep-last keeps the last N messages per channel.
  • --fetch-within limits the fetched slice of history.
  • --buffer-per-channel fetches one channel up front before evaluation, which enables better per-channel timing summaries for manual runs.
  • --preserve-cache helps repeated runs stay stable when fetch windows are limited.
  • --profile lets you save reusable cleanup presets in config.json.