https://github.com/dannyben/slacktail

Command line utility for following your Slack chat from the terminal
https://github.com/dannyben/slacktail

cli command-line gem ruby slack slack-client

Last synced: 8 months ago
JSON representation

Command line utility for following your Slack chat from the terminal

• Host: GitHub
• URL: https://github.com/dannyben/slacktail
• Owner: DannyBen
• License: mit
• Created: 2018-12-06T12:39:44.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-03-29T07:46:02.000Z (over 2 years ago)
• Last Synced: 2025-04-14T09:18:39.267Z (8 months ago)
• Topics: cli, command-line, gem, ruby, slack, slack-client
• Language: Ruby
• Size: 93.8 KB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
Slacktail

==================================================

[![Gem Version](https://badge.fury.io/rb/slacktail.svg)](https://badge.fury.io/rb/slacktail)

[![Build Status](https://github.com/DannyBen/slacktail/workflows/Test/badge.svg)](https://github.com/DannyBen/slacktail/actions?query=workflow%3ATest)

[![Maintainability](https://api.codeclimate.com/v1/badges/c81fe947a0e4b5bd1bdc/maintainability)](https://codeclimate.com/github/DannyBen/slacktail/maintainability)

Slacktail is a single-purpose command line utility for following messages 

sent to your Slack organization chat.

Demo

--------------------------------------------------

![Demo](https://raw.githubusercontent.com/DannyBen/slacktail/master/demo.gif)

Installation

--------------------------------------------------

    $ gem install slacktail

Authorization

--------------------------------------------------

1. Obtain an API key from Slack.

   In your Slack settings, go to [Custom Integrations] and create a new 

   Bot Application. Then, find the API Token in the bot's configuration page.  

2. Set the `SLACK_API_TOKEN` environemnt variable to the API Token. This 

   should probably be set in your `~/.bashrc`, with 

   `export SLACK_API_TOKEN=`

3. Invite your bot to any channel you want to monitor. Type 

   `/invite @` in any channel.

Usage

--------------------------------------------------

Follow all channels:

    $ slacktail

Follow specific channels:

    

    $ slacktail general development lobby

Full Usage Help:

    $ slacktail --help

    Show and follow slack messages in real time

    Usage:

      slacktail [CHANNELS...]

      slacktail (-h|--help|--version)

    Options:

      -h --help

        Show this help

      --version

        Show version number

    Parameters:

      CHANNELS

        Channels to follow

    Examples:

      slacktail

      slacktail general debug

---

[Custom Integrations]: https://my.slack.com/apps/manage/custom-integrations