Skip to content

First Run

The safest first run is deliberately narrow: discover IDs, choose one target, and preview the result in --dry-run.

Terminal window
delete-me-discord --list-guilds
delete-me-discord --list-channels

This gives you the IDs you need for --include-ids and helps avoid deleting from the wrong place.

Terminal window
delete-me-discord --include-ids <channel_id> --delete-reactions --preserve-n 0 --preserve-last 0 --dry-run

This example targets one channel, includes reaction cleanup, and preserves nothing. It is useful as a preview for a full wipe of that single channel.

3. Execute only after the plan looks right

Section titled “3. Execute only after the plan looks right”

Drop --dry-run once you are satisfied with the output.

Dry-run now reports per-channel planning details such as:

  • messages and reactions that would be deleted
  • scan time
  • est. execute time
  • est. total time
  1. Start with one --include-ids target.
  2. Use --dry-run.
  3. Adjust --preserve-last, --preserve-n, and --fetch-max-age.
  4. Only then expand scope or remove --dry-run.

If you want a one-off cleanup of a single target, continue with Full Channel Cleanup.

If you want repeated cleanup over time, continue with Rolling Retention.