sk

Thin Slack API proxy CLI. Authenticates with browser session tokens (xoxc + xoxd) — no Slack App installation required.

Install

go install github.com/metrovoc/sk@latest

Usage

Auth

sk auth login    # store xoxc token + xoxd cookie
sk auth status   # verify credentials
sk auth logout   # delete stored credentials

API

Transparent passthrough to any Slack Web API method:

sk api conversations.list --types public_channel,private_channel
sk api conversations.history --channel C0123ABCD
sk api conversations.replies --channel C0123ABCD --ts 1234567890.123456
sk api search.messages --query "from:@alice important"
sk api users.info --user U0123ABCD

Flags:

Flag	Description
--limit N	Cap total items returned across all pages
--no-paginate	Return single page only
--jq <expr>	Filter output with jq expression
--raw	Disable pretty printing

Download

Download Slack-hosted files with auth:

sk download "https://files.slack.com/files-pri/T0123/file.pdf"
sk download "https://files.slack.com/files-pri/T0123/file.pdf" -o ~/papers/

How auth works

sk uses your existing Slack browser session — no app installation, no admin approval, invisible to other workspace members.

1. Open Slack in browser → DevTools (F12)
2. Network tab → find any API request → copy token value (xoxc-...)
3. Application tab → Cookies → copy d value (xoxd-...)

Credentials are stored in ~/.sk/credentials.json (mode 0600).