···88# Admin users (comma-separated Slack user IDs)
99ADMINS=U1234567890
10101111+# Hack Club CDN Token (for file uploads)
1212+CDN_TOKEN=your-cdn-token-here
1313+1114# Server Configuration (optional)
1215PORT=3000
1316
+20-1
README.md
···3737# Admin users (comma-separated Slack user IDs)
3838ADMINS=U1234567890
39394040+# Hack Club CDN Token (for file uploads)
4141+CDN_TOKEN=your-cdn-token-here
4242+4043# Server Configuration (optional)
4144PORT=3000
4245```
43464447See `.env.example` for a template.
4848+4949+### Slash Commands
5050+5151+The bridge provides interactive slash commands for managing mappings:
5252+5353+- `/irc-bridge-channel` - Bridge current Slack channel to an IRC channel
5454+- `/irc-unbridge-channel` - Remove bridge from current channel
5555+- `/irc-bridge-user` - Link your Slack account to an IRC nickname
5656+- `/irc-unbridge-user` - Remove your IRC nickname link
5757+- `/irc-bridge-list` - List all channel and user bridges
45584659### Managing Channel and User Mappings
4760···6881The bridge connects to `irc.hackclub.com:6667` (no TLS) and forwards messages bidirectionally based on channel mappings:
69827083- **IRC → Slack**: Messages from mapped IRC channels appear in their corresponding Slack channels
8484+ - Image URLs are automatically displayed as inline attachments
8585+ - IRC mentions (`@nick` or `nick:`) are converted to Slack mentions for mapped users
8686+ - IRC formatting codes are converted to Slack markdown
7187- **Slack → IRC**: Messages from mapped Slack channels are sent to their corresponding IRC channels
7272-- User mappings allow custom IRC nicknames for specific Slack users
8888+ - Slack mentions are converted to `@displayName` format using Cachet
8989+ - Slack markdown is converted to IRC formatting codes
9090+ - File attachments are uploaded to Hack Club CDN and URLs are shared
9191+- **User mappings** allow custom IRC nicknames for specific Slack users and enable proper mentions both ways
73927493The bridge ignores its own messages and bot messages to prevent loops.
7594