TOC SlackBot

About

TOC SlackBot is a lightweight, extensible Slack bot built with Bun, TypeScript, and the Bolt framework. It runs via Socket Mode (no public HTTP endpoint needed) and responds to slash commands in real time — from simple ping/pong checks to external API-powered fun.

Bun TypeScript Bolt (Slack SDK) Socket Mode ESLint Prettier Husky Axios

Commands

All 28 slash commands, organized by category.

Live Demo

Try the commands right here. Responses are simulated for the showcase.

slackbot — socket mode

$ bun run index.ts

$ ⚡️ Bolt app is running!

$ Connected via Socket Mode

✓ Ready for commands. Type one below!

/

Quick Start

Get the bot running in your own Slack workspace in under 5 minutes.

# Clone & install
git clone https://github.com/TADSTech/SlackBot.git
cd SlackBot
bun install

# Configure
cp .env.example .env
# Edit .env with your Slack tokens

# Run
bun run index.ts

Technical Details

⚡

Runtime

Runs on Bun — a fast all-in-one JavaScript runtime. No Node.js required for development.

🔌

Slack Integration

Uses Socket Mode so no public endpoint is needed. Perfect for local or ephemeral deployments.

🛡️

Type Safety

Written in strict TypeScript with full type checking via tsc --noEmit.

🧹

Code Quality

ESLint + Prettier enforce consistent style. Husky pre-push hooks prevent bad commits.

🌐

External APIs

Integrates with 7+ free APIs — jokes, facts, quotes, weather, crypto, dogs, cats, and more.

🎯

25 Slash Commands

Five categories: Utility, Fun, Knowledge, Media, and Personality. Dynamic responses keep every interaction fresh.

Powered By

Official Joke API Jokes Useless Facts Facts Advice Slip Advice ZenQuotes Quotes Cat Facts Cats Dog CEO Dogs CoinGecko Crypto wttr.in Weather Open Trivia DB Trivia Kanye Rest Quotes