node package manager

slag-cli

slack terminal client

use slack in your terminal with an ncurses-style text-based gui. markdown-preview

what this client supports right now

  • chatting (public channels, private channels, DMs, etc)
  • slash-commands from slack's hidden api!!
  • @- and #-mentions
  • emoji ūüôĆūüŹĹ

what this client doesn't support/has trouble supporting (as of right now)

  • images/gifs (for obvious reasons)
  • files and links (they get printed out, but if they're too long they can go off the screen)

how to run:

if you want to be able to run it from anywhere, make sure you have npm installed and run

npm install -g slag-cli

you'll need tokens for each team you'd like to use in slag. You can generate tokens for your team here

to register a token with slag, type

slag --add-token <your-token> --team <team-name>

if you'd like to add multiple teams at once, you can simply make your own json file and type

slag --set-tokens <path-to-your-tokens-json>

if you choose to set your json manually, it should be structured like this:

[
        {
                "team": "ATEAM",
                "token": "xoxp-***"
        },
        {
                "team": "ANOTHER_TEAM",
                "token": "xoxp-***"
        }
]

once you've registered at least one token, you should be able to run slag from anywhere (assuming you've installed it globally) in your command line by typing:

slag

how to use

Key Action
Tab Switch between channel selection, message box, and team selection
Ctrl+T Cycle through teams
Ctrl+C Quit
Esc Quit

how to contribute

clone this repo, then from inside the project directory run

npm install

and have at it. do the tokens thing too though.

notes:

this project uses a json file generated by jollygoodcode's emoji-keywords to translate slack's :emoji-code: into unicode under the MIT license

license

idk i guess we use the MIT license