deslackify - GitLite

KO | EN

gitlite — search

#editor #mcp #dotnet #shell #linux #json #anthropic #javascript #self-hosted #c

deslackify

(★ 21)

A program to delete old slack messages.

File Explorer

ZIP Download

- - ci.yml
  - publish.yml
- __init__.py
- cli.py
- test_deslackify.py
.gitignore
.pre-commit-config.yaml
CHANGES.md
LICENSE.txt
pyproject.toml
README.md
uv.lock

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`uv tool`

View Details ▼

Install and run commands provided by Python packages.

uv tool run {{command}}

Run a command from a package, without installing it:

uv tool install {{package}}

Install a Python package system-wide:

uv tool upgrade {{package}}

Upgrade an installed Python package:

🔍

`uvx`

View Details ▼

This command is an alias of `uv tool run`.

tldr uv tool

View documentation for the original command:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A tool to remove your own slack messages.

`deslackify` can only delete messages that *you* sent. The token you provide
authenticates as your own account, so it cannot remove messages authored by
other users.

`deslackify` supports Python 3.10 through 3.14.

## Installation

Install the `deslackify` command with [uv](https://docs.astral.sh/uv/):

```sh
uv tool install deslackify
```

## Obtaining credentials

`deslackify` is meant to be run without the overhead of creating a Slack app. It
authenticates as your own browser session, using two values copied from your
logged-in Slack web client (`https://app.slack.com`):

1. Open your workspace in a browser and open the developer tools.
2. **Token** — in the __Console__, run:
   ```js
   (d=>d.teams[Object.keys(d.teams)[0]].token)(JSON.parse(localStorage.localConfig_v2))
   ```
   It begins with `xoxc-`. This is the `TOKEN` below.
3. **Cookie** — in __Application → Cookies → `https://app.slack.com`__, copy the
   value of the `d` cookie. It begins with `xoxd-`. This is the `COOKIE` below.
   (`deslackify` re-encodes it as needed, so it does not matter whether the value
   is shown URL-encoded or not.)

The token and cookie must come from the same logged-in session.

### Alternative: a Slack app token

If you are able to create a Slack app, you can authenticate with a user OAuth
token instead of a browser session. It is more stable — it does not expire when
you sign out — and needs no `--cookie`:

1. Create a new app at https://api.slack.com/apps ("From scratch").
2. Under __OAuth & Permissions__, add the __User Token Scopes__ `search:read` and
   `chat:write`.
3. Click __Install to Workspace__ and authorize the app.
4. Copy the __User OAuth Token__ (it begins with `xoxp-`); use it as `TOKEN` and
   omit `--cookie`.

## Running

```sh
deslackify --token TOKEN --cookie COOKIE USERNAME
```

Both values can also be supplied via the `SLACK_TOKEN` and `SLACK_COOKIE`
environment variables (preferred, so the secrets do not appear in your shell
history or process list):

```sh
SLACK_TOKEN=… SLACK_COOKIE=… deslackify USERNAME
```

Or run it once without installing:

```sh
uvx deslackify --token TOKEN --cookie COOKIE USERNAME
```

Use `--dry-run` first to preview what would be deleted without deleting
anything.

By default `deslackify` will remove USERNAME's messages that are more than a
year old. You may also manually specify a `before` date via:

```sh
deslackify --token TOKEN --cookie COOKIE --before YYYY-MM-DD USERNAME
```

__Note__: If no results are found, you may need to replace `USERNAME` with
`USERID`. You can find the `USERID` by going to `Profile & Account`, and then
clicking the three dots, and at the bottom, "Copy member ID".