3 releases
0.1.2 | Nov 15, 2024 |
---|---|
0.1.1 | Nov 11, 2024 |
0.1.0 | Nov 10, 2024 |
#269 in Command line utilities
352 downloads per month
19KB
174 lines
Slack Summarizer
Slack Summarizer is a handy CLI tool for summarizing recent messages in Slack. It allows you to easily catch up on what's happening without leaving your command line.
Setup
To set up Slack Summarizer, start by creating a Slack app with the channels:history
, channels:join
, and channels:read
scopes. Install the app to your workspace and make a note of the bot token. You'll need it when you first use Slack Summarizer. Now you'll need to get an OpenAI token from your preferred provider. If you choose to use a provider other than OpenAI itself, you'll have to change the default request URL and model name when using Slack Summarizer for the first time. You must ensure that the provider's API is OpenAI-compatible, or Slack Summarizer will be unable to use it.
First-time Use
When using this tool for the first time, you'll need to set a Slack bot token and OpenAI token. You can do this as below, replacing SLACK_TOKEN
and OPENAI_TOKEN
with the appropriate values:
slack-summarizer -s SLACK_TOKEN -o OPENAI_TOKEN summarize general
You can also specify a different OpenAI API URL if you are using a different provider (e.g. Azure OpenAI, GitHub Models):
slack-summarizer -r API_URL summarize general
Note: The first run may take a long time, depending on your workspace size, as Slack Summarizer has to retrieve a list of all Slack channels and map channel names to IDs
Usage
slack-summarizer [ARGS] summarize CHANNEL
Any arguments passed will be written to the configuration file. Existing values will be overwritten. Below is an explanation of all possible flags:
Long Flag | Short Flag | Description |
---|---|---|
--slack-token |
-s |
Set the Slack bot token |
--openai-token |
-o |
Set the OpenAI token |
--request-url |
-r |
Set the OpenAI request URL |
--model |
-m |
Set the OpenAI model |
--tokens |
-t |
Set the maximum number of output tokens |
--num-messages |
-n |
Set the number of messages to summarize |
--channels-refill |
-c |
Refill the channel list (may take a long time) |
Dependencies
~12–26MB
~392K SLoC