BLT-Lettuce Slack Bot

A Slack bot built for open-source organizations with a GitHub presence. Connect your repositories, welcome new members automatically, and help them discover where to contribute.

Welcome Bot Repo Discovery Community Builder

Connected Workspaces

Slack workspaces currently running BLT-Lettuce

Loading workspaces...

Live Community Stats

Loading live statistics...

What BLT-Lettuce Does

👋

Smart Welcome System

Automatically welcomes new Slack members with personalized messages, repository recommendations, and onboarding resources tailored to your open-source community.

🔍

Repository Discovery

Helps new members find the right repositories to contribute to, matched by their skills and interests, across your open-source GitHub organization.

🐙

GitHub Integration

Connect your open-source GitHub org and the bot imports live repository metadata to keep recommendations always up to date.

How It Works

1

Connect the Workspace

Click Connect Workspace, authorize BLT-Lettuce in Slack, and your workspace is live.

2

Link Your GitHub Org

Run /lettuce-org-add in Slack with your GitHub org URL. The bot imports your open-source repositories automatically.

3

Automatic Welcomes

When someone new joins, the bot greets them, asks what they're interested in, and matches them to the right repositories and channels.

4

Instant Recommendations

Members receive a curated list of repositories matching their skills and interests, complete with stars, language, and direct GitHub links.

Bot Interactions

Event: team_join

Automatic Welcome

Detects when a new user joins the workspace and sends a personalized welcome DM with resources.

✔ User joins workspace
Bot: "Welcome! Let us help you find where to contribute."
(Followed by repo & channel suggestions)
Event: message (IM)

Direct Message Handler

Responds to direct messages and logs interactions for community managers.

User (DM): "Hello bot"
Bot: "Hello @User, you said: Hello bot"
Slash Command

Connect a GitHub Org

Use /lettuce-org-add to connect a GitHub organisation and import all its repositories into the bot.

/lettuce-org-add https://github.com/your-org
Other Commands

Workspace Admin Tools

Compact command set for onboarding, app links, invite links, and safe disconnects.

/lettuce-welcome
/lettuce-app-link
/lettuce-set-invite https://join.slack.com/...
/lettuce-disconnect

Project Health

--

GitHub Stars

--

Forks

--

Open Issues

--

Contributors

Commit Activity Last Commit Top Language Repo Size

Database Records

- workspaces - join messages - channels - repos - events

Built With

Python Cloudflare Workers Slack API GitHub API D1 Database