slack terminal client
use slack in your terminal with an ncurses-style text-based gui.
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