@fionoble/slack-cli

A JSON-first CLI for the Slack API. Comes with a Claude Code skill for seamless AI-assisted Slack interaction.

Install

pnpm install -g @fionoble/slack-cli

Prerequisites

• Bun runtime
• A Slack API token (xoxb-, xoxp-, or xoxc-)

Setup

slack-cli auth setup xoxb-your-token-here

For browser/cookie tokens (xoxc-):

slack-cli auth setup xoxc-your-token --cookie "d=xoxd-your-cookie"

Token is stored at ~/.config/slack-cli/config.json with 0600 permissions. You can also use environment variables:

export SLACK_TOKEN="xoxb-..."
export SLACK_COOKIE="d=..."  # only needed for xoxc- tokens

CLI Usage

All commands output JSON to stdout.

# Auth
slack-cli auth test
slack-cli auth whoami

# Channels
slack-cli channels list
slack-cli channels info --channel general
slack-cli channels history --channel general --limit 10
slack-cli channels join --channel general

# Messages
slack-cli messages send --channel general --text "Hello!"
slack-cli messages reply --channel general --thread-ts 1709000000.000000 --text "Reply!"
slack-cli messages thread --channel general --thread-ts 1709000000.000000
slack-cli messages search --query "deployment" --limit 5
slack-cli messages update --channel general --ts 1709000000.000000 --text "Updated"
slack-cli messages delete --channel general --ts 1709000000.000000

# Users
slack-cli users list
slack-cli users info --user @jane.doe
slack-cli users lookup --email [email protected]

# Direct Messages
slack-cli dm open --user @jane.doe
slack-cli dm send --user @jane.doe --text "Hey!"
slack-cli dm history --user @jane.doe

# Reactions
slack-cli reactions add --channel general --ts 1709000000.000000 --name thumbsup
slack-cli reactions remove --channel general --ts 1709000000.000000 --name thumbsup
slack-cli reactions get --channel general --ts 1709000000.000000

# Files
slack-cli files list --channel general
slack-cli files upload --file ./report.pdf --channels general --title "Q1 Report"
slack-cli files info --file F01ABC123
slack-cli files delete --file F01ABC123

Global Flags

| Flag | Description | |------|-------------| | --token <token> | Override configured token | | --cookie <cookie> | Browser 'd' cookie for xoxc- tokens | | --pretty | Pretty-print JSON output | | --raw | Output raw API data (no {ok, data} wrapper) | | --quiet | Suppress non-essential output |

Name Resolution

• Channels: C01ABC123, general, or #general
• Users: U01ABC123, @jane.doe, or [email protected]

Pagination

Commands return metadata.next_cursor when more results exist:

slack-cli channels list --limit 10
# → metadata: { next_cursor: "dXNlcjpV...", has_more: true }

slack-cli channels list --limit 10 --cursor "dXNlcjpV..."

Claude Code Skill

Once installed, the /slack skill is available in Claude Code. You can:

• Invoke directly: /slack search for recent messages about deployments
• Or ask naturally: "check what's happening in #general"

Output Format

Success:

{"ok": true, "data": [...], "metadata": {"count": 5, "has_more": false}}

Error:

{"ok": false, "error": "channel_not_found", "message": "...", "exit_code": 4}

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 2 | No token configured | | 3 | Bad argument | | 4 | Slack API error | | 5 | Network error | | 6 | File I/O error |

License

ISC