# kfei/slack-cleaner

:speech_balloon: Bulk delete messages and files on Slack

Repository: https://github.com/kfei/slack-cleaner
Canonical: https://ross.abutalabs.com/products/slack-cleaner
Language: Python
License: MIT
License Family: permissive
Last push: 2019-05-08T19:41:12+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4002, "days_push": 2674, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1241, forks 137 (observed 2026-08-28T04:04:06.387323+00:00)

## What it is
A Python command-line tool for bulk deleting messages and files from Slack channels, groups, DMs, and multiparty DMs. It supports filtering by user, bot, date, and file type, with optional logging and rate limiting.

## Use cases
- bulk delete all messages in a slack channel
- delete old slack messages before a certain date
- remove bot spam messages from a slack channel
- delete files uploaded by a specific slack user
- clean up slack workspace on the free plan
- wipe direct message history with a coworker

## When to choose
- you need to bulk-clean a Slack workspace from the command line
- you want to filter deletions by user, bot, date, or file type
- you prefer a simple pip-installable or Docker-based one-off tool

## When to avoid
- you need a GUI or scheduled automatic cleanup
- you need support for newer Slack API features or granular admin controls
- the project appears unmaintained and may break with current Slack API changes

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools, workflow-automation
- domain: messaging-platforms, developer-tools
- platform: cli, python, cross-platform
- tags: slack, bulk-delete, message-cleanup, workspace-administration, command-line, docker

## Member repositories
- kfei/slack-cleaner (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:06.387323+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:08:29.193289+00:00, confidence not recorded.
  - readme: https://github.com/kfei/slack-cleaner (fetched 2026-08-28T04:04:06.387323+00:00, sha fdfbe6d9124d)
- Data as of 2026-08-30T08:39:29.467469+00:00.