Skip to content
SlackCLI

User guide

Quick start

Section titled “Quick start”
Terminal window
# 1. Install (macOS / Linux)
brew tap shaharia-lab/tap && brew install slackcli


# 2. Sign in — a browser opens, you sign in once
slackcli auth login-auto


# 3. Use it
slackcli conversations list
slackcli messages send --recipient-id=C1234567890 --message="Hello from the terminal"

slackcli --help, and slackcli <group> --help, print the authoritative option list for the version you have installed.

Command groups

Section titled “Command groups”
Group What it does
auth Sign in, list/select/remove workspaces, extract tokens
conversations List channels and DMs, read history and threads, unreads
messages Send, reply, edit, react, draft, attach files, Block Kit
search Search messages, channels, and people
team Read the workspace’s own name, domain, and ID
usergroups List, read, and manage user groups (“subteams”)
saved Read your “saved for later” list
canvas List canvases and read them as Markdown
files Inspect, read, and download Slack-hosted files
emoji List a workspace’s custom emoji and inspect one
update Check for and install new versions

Pages

Section titled “Pages”
  1. Installation
  2. Authentication
  3. Workspaces and profiles
  4. Slack links and timestamps
  5. Conversations
  6. Messages
  7. Search
  8. Team
  9. User groups
  10. Saved items
  11. Canvas
  12. Files
  13. Emoji
  14. Scripting and JSON output
  15. Claude Code plugin
  16. Troubleshooting

Two things that apply everywhere

Section titled “Two things that apply everywhere”

--workspace <id|name> — every command that talks to Slack accepts it, and falls back to your default workspace when you omit it. See workspaces and profiles.

Paste Slack URLs instead of IDs — anywhere a channel, user, message, canvas, or file ID is expected. See Slack links and timestamps.

Cookies