708u-slack-cli

slack-cli

Go CLI tool for interacting with the Slack API.

Install

go install github.com/708u/slack-cli/cmd/slack-cli@latest

Or build from source:

git clone https://github.com/708u/slack-cli.git
cd slack-cli
make build    # out/slack-cli
make install  # $GOPATH/bin/slack-cli

Setup

Create a Slack App at api.slack.com/apps and issue a token. A Bot Token (xoxb-) covers most operations. A User Token (xoxp-) is required for the full feature set.

Required Scopes

Bot Token (xoxb-) scopes:

scope	commands
channels:read	channels, channel info, members
channels:history	history, unread
channels:join	join
channels:manage	channel set-topic/purpose, invite, leave
groups:read	private channel channels etc.
groups:history	private channel history
im:read	DM channels, unread
im:history	DM history
mpim:read	group DM listing
mpim:history	group DM history
chat:write	send, send-ephemeral, edit, delete, scheduled
chat:write.public	send to channels the bot hasn't joined
files:read	canvas list
files:write	upload
pins:read	pin list
pins:write	pin add/remove
reactions:write	reaction add/remove
users:read	users list/info/presence/search
users:read.email	users lookup
usergroups:read	usergroups list

User Token (xoxp-) only scopes:

These scopes are not available with Bot Tokens.

scope	commands
search:read	search
stars:read	bookmark list
stars:write	bookmark add/remove
reminders:read	reminder list
reminders:write	reminder add/delete/complete

# Interactive input (recommended)
slack-cli config set

# From stdin (CI/scripts)
echo "$SLACK_TOKEN" | slack-cli config set --token-stdin

# Multiple workspaces
slack-cli config set --profile work
slack-cli config use work

Tokens are AES-256-GCM encrypted and stored in ~/.slack-cli/config.json. The master key is auto-generated at ~/.slack-cli-secrets/master.key.

Timezone

Set a timezone to display and parse timestamps in local time instead of UTC.

# Save timezone to profile
slack-cli config set --timezone Asia/Tokyo

# Per-command override
slack-cli --tz America/New_York history -c general

# Environment variable
export SLACK_CLI_TZ=Europe/London

Resolution order: --tz flag > profile config > system default.

Usage

# Send a message
slack-cli send -c general -m "hello"

# Send a DM
slack-cli send --user alice -m "hey"

# Schedule a message
slack-cli send -c general -m "reminder" --after 30

# List channels
slack-cli channels --type all --format json

# Message history
slack-cli history -c general -n 20

# Search
slack-cli search -q "deploy error"

# Unread messages
slack-cli unread --mark-read

# Upload a file
slack-cli upload -c general -f report.pdf

# Reactions
slack-cli reaction add -c general -t 1234567890.123456 -e thumbsup

# Pins
slack-cli pin add -c general -t 1234567890.123456

# Reminders
slack-cli reminder add --text "standup" --after 15

# User info
slack-cli users info --id U0123456789

# Search users by name
slack-cli users search "Alice"

# User groups
slack-cli usergroups list

Run slack-cli --help for full command list, or slack-cli <command> --help for options.

Output Formats

Most list commands support --format table|simple|json:

• table (default) -- human-readable table
• simple -- tab-separated, suitable for piping
• json -- structured JSON

Claude Code Plugin

This repository is also a Claude Code plugin. It provides a slack-cli-guide skill that gives Claude full knowledge of all commands and options.

# Add this repo as a marketplace source
/plugin marketplace add 708u/slack-cli

# Install the plugin
/plugin install slack-cli

After installation, Claude Code can reference slack-cli commands when you mention Slack operations in conversation.

License

MIT