Open source AI-powered Slack community management bot with a built-in Next.js admin panel. Uses Chat SDK, AI SDK, and Vercel Workflow.
Template. Fork it, customize it, and deploy your own AI community manager with Vercel.
- Community manager AI—routes questions, welcomes members, surfaces unanswered threads, and flags issues to a lead. Powered by AI SDK
- Channel-aware routing—configurable channel map so the bot knows your workspace layout and where to send people
- Durable workflows—every LLM call and tool execution is a checkpoint with automatic retries via Vercel Workflow
- Web search—Anthropic's native web search tool, scoped to your community's domains via
SEARCH_DOMAINS. Runs through AI Gateway - Sandbox execution—optional
bash/bash_batchtools for running commands in a sandboxed environment via the Knowledge Agent Template API - Native Slack UI—typing indicators, threaded replies, and DMs. Powered by Chat SDK
- Admin panel—live dashboard with real-time streaming indicators, ViewTransition animations, activity feed, type filters, text search, inline conversation previews, activity trends, and settings page with channel overview
- Auth—Slack OAuth via Better Auth restricts the admin panel to workspace members
Try the admin panel without setting up Slack:
- Import the repo on vercel.com/new
- Add a
COMMUNITY_NAMEenv var (e.g.DevHub) - Deploy—the dashboard works immediately with mock data
For the full Slack bot setup, see docs/setup.md.
| What to change | File | Details |
|---|---|---|
| Bot personality | lib/agent.ts |
System prompt and instructions |
| Channel map | lib/channels.ts |
Must match your Slack workspace |
| Welcome message | lib/welcome.ts |
Sent when new members join |
| Agent tools | workflows/agent-workflow/tools.ts |
Add, remove, or modify tools |
| Auth config | lib/auth.ts |
Slack OAuth for the admin panel |
| Action type UI | config/type-config.ts |
Icons, labels, and colors per action type |
This template is designed to work alongside the Knowledge Agent Template. Set SAVOIR_API_URL to connect to a deployed Savoir backend, giving the bot bash and bash_batch tools to search and read your community docs remotely. Without it, the bot still works using web search, channel routing, and the system prompt.
- Full setup guide—Slack app, env vars, storage, OAuth, channels, deploy
- Architecture—how the bot works, key files, workflow constraints
- Admin panel—dashboard pages, live streaming, filters, Next.js patterns
- Testing—test without Slack, simulate actions, mock data
- Next.js 16—App Router with cacheComponents
- Chat SDK—Slack adapter and bot framework
- AI SDK 6—AI model integration with AI Gateway support
- Vercel Workflow—durable workflow execution
- Better Auth—Slack OAuth for the admin panel
- shadcn/ui—component library
- Upstash Redis—bot action logging, stats, and conversation storage
MIT