prometheus

KO | EN

gitlite — search

#javascript #ai #typescript #golang #machine-learning #rust #deep-learning #macos #windows #awesome #kubernetes #vue #pytorch #mcp

(★ 11)

Prometheus is a Slack bot that lets community members take responsibility for keeping high traffic channels tidy and welcoming

prometheus Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  <img alt="icon" width="250" src="https://github.com/user-attachments/assets/196e153b-1ef2-4a83-89a3-1bde9a0afe28" />
  <br>Prometheus
</h1>

_Prometheus is known for stealing fire from the gods and giving it to humanity._

Prometheus is a Slack bot that lets community members take responsibility for keeping high traffic channels tidy and welcoming. More details about why this exists in the Slacker News article: [Prometheus Brings Users More Powers to Improve Slack](https://news.hackclub.com/news/prometheus-distributed-care/).

## Features

**Message shortcuts** (right-click → Message shortcuts):

- **Delete Message**: instantly removes a message
- **Destroy Thread**: nukes an entire thread; hides it via Slack's moderation API if possible
- **Clear Embeds**: strips link previews from a message

**Slash commands** (invoked via `/pro <subcommand>`):

| Command                                              | Who           | What it does                           |
| ---------------------------------------------------- | ------------- | -------------------------------------- |
| `ping`                                               | Everyone      | Check if the bot is alive              |
| `info [@user]`                                       | Everyone      | Look up info about a Slack user        |
| `coin`                                               | Everyone      | Flip a coin                            |
| `help`                                               | Everyone      | Show available commands                |
| `here <message>`                                     | Moderators    | Ping all online members in the channel |
| `channel <message>`                                  | Moderators    | Ping everyone in the channel           |
| `timeout @user [duration] reason`                    | Moderators    | Time out a user from the channel       |
| `untimeout @user`                                    | Moderators    | Remove a timeout                       |
| `welcome [set\|remove\|view]`                        | Managers      | Manage the channel welcome message     |
| `channelmanager add\|remove\|list [@user] [manager]` | Admins        | Appoint/remove moderators and managers |
| `admin add\|remove\|list [@user]`                    | Global admins | Manage global admins                   |

**Permission roles:**

- **Global admin**: seeded from `SUPERADMINS`.
- **Workspace admin**: inherited from Slack
- **Channel manager**: appointed per-channel; can delete, destroy, set welcome messages
- **Channel moderator**: appointed per-channel; can timeout, @here, @channel

## Setup

> **⚠️ Workspace admin perms required.** Only cloning the repo and installing the Slack app is **not** enough. Almost every moderation feature (delete message, destroy thread, timeout/kick, move members, ban enforcement, clear embeds, and similar) runs through `SLACK_USER_TOKEN` and **will not work** unless that token is a User OAuth token (`xoxp`) from a **workspace admin**. Without it, only trivial commands like `ping`, `coin`, and `help` work.

1. Clone the repo.
2. Create a Slack app from [`slack.manifest.yaml`](./slack.manifest.yaml).
3. Install/reinstall the app to your workspace so all scopes are granted.
4. Create an app-level token with `connections:write` (for Socket Mode!).
5. Fill out your `.env`, check the `.env.example` for reference. Here's a bit more detailed rundown of what to expect

| Variable               | Required | Purpose                                                                                           |
| ---------------------- | -------- | ------------------------------------------------------------------------------------------------- |
| `SLACK_BOT_TOKEN`      | Yes      | Bot User OAuth Token (xoxb) for posting messages                                                  |
| `SLACK_USER_TOKEN`     | Yes      | User OAuth Token (`xoxp`) from a **workspace admin** — required for all moderation actions        |
| `SLACK_APP_TOKEN`      | Yes      | App-Level Token (xapp) with `connections:write` for Socket Mode                                   |
| `SLACK_SIGNING_SECRET` | Yes      | Signing secret from app settings                                                                  |
| `SUPERADMINS`          | Yes      | Comma-separated Slack user IDs seeded as global admins (e.g. `U12345678,U87654321`)               |
| `DATABASE_URL`         | Yes      | PostgreSQL connection URL                                                                         |
| `DATABASE_POOL_SIZE`   | No       | Maximum PostgreSQL connections per bot instance (defaults to 4)                                   |
| `LOG_CHANNEL`          | No       | Channel ID for **private** audit logs which includes full message content and CDN transcripts     |
| `PUBLIC_LOG_CHANNEL`   | No       | Channel ID for **public** audit logs which are redacted, shows only who did what in which channel |
| `HACKCLUB_CDN_KEY`     | No       | CDN API key for archiving deleted thread archives to the HC CDN                                   |
| `SLACK_BROWSER_TOKEN`  | No       | Browser token (xoxc) for Slack's undocumented moderation APIs (eg thread hiding)                  |
| `SLACK_COOKIE`         | No       | Session cookie (`d=` value) paired with `SLACK_BROWSER_TOKEN`                                     |

6. Apply database migrations and run it:

```bash
bun install
bun run db:migrate
bun start
```

When changing `lib/db/schema.ts`, generate and commit a migration with
`bun run db:generate`. Apply committed migrations with `bun run db:migrate`
before starting a new application version.

You should see two new message shortcuts in Slack:

Deleting a message has no confirmation. Destroying a thread shows a confirmation modal to prevent misinputs:

## License

See [LICENSE](LICENSE) for the legal mumbo jumbo.

prometheus

prometheus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

prometheus

prometheus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README