skit-ai / ccb

Slack bot for virtual coffee pairing

ccb

Coffee Catchup Bot (ccb) is a slack bot for virtual coffee pairing.

Quickstart

Set up env var: SLACK_BOT_USER_TOKEN with following bot token scopes:

• chat:write
• users:read
• reactions:write
• channels:read
• mpim:write for sending group DMs
• usergroups:read for pairing based on user group handles

Workflow

# Make matches using a seed (or using default)
poetry run ccb group --output-json=matches.json

# Make pairs while prioritizing cross time-zone matches. Useful for
# decentralized teams.
poetry run ccb pair-tz --output-json=matches.json

# Post on channel
poetry run ccb post --matches-json=matches.json --channel-name=test

# Send group DM for scheduling catchup
poetry run ccb dm-group --matches-json=matches.json --template-file=./assets/template.j2

You can also skip users by adding comma separated slack user ids in the environment variable CCB_SKIP_LIST.