Community Agent Template

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.

Features

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_batch tools 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

Quick start

Try the admin panel without setting up Slack:

Import the repo on vercel.com/new
Add a COMMUNITY_NAME env var (e.g. DevHub)
Deploy—the dashboard works immediately with mock data

For the full Slack bot setup, see docs/setup.md.

Customization

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

Knowledge base

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.

Docs

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

Built with

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

License

MIT

community-agent-template