+TITLE: ccb

[[https://img.shields.io/github/v/tag/Vernacular-ai/ccb.svg?style=flat-square]]

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

+begin_src shell

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

+end_src

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