UXC

One CLI for tools across protocols.

Slack Web API Skill - Usage Patterns

Link Setup

command -v slack-openapi-cli
uxc link slack-openapi-cli https://slack.com/api \
  --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/slack-openapi-skill/references/slack-web.openapi.json
slack-openapi-cli -h

Auth Setup (Bot Token Default)

Use the Slack Bot User OAuth Token (xoxb-...) here.

uxc auth credential set slack-bot \
  --auth-type bearer \
  --secret-env SLACK_BOT_TOKEN

uxc auth binding add \
  --id slack-bot \
  --host slack.com \
  --path-prefix /api \
  --scheme https \
  --credential slack-bot \
  --priority 100

Auth Setup (User Token Override)

Use the Slack User OAuth Token (xoxp-...) here. Do not use xapp-... app-level tokens with this skill.

uxc auth credential set slack-user \
  --auth-type bearer \
  --secret-env SLACK_USER_TOKEN

Use --auth slack-user for reads that need user-token semantics:

slack-openapi-cli --auth slack-user get:/conversations.replies channel=C1234567890 ts=1717171717.000100
slack-openapi-cli --auth slack-user get:/conversations.history channel=C1234567890 limit=50

Use --auth slack-user on write methods only when you intentionally want the message to be attributed to the user-token identity rather than the default bot path.

Auth Setup (Socket Mode App Token)

Use an app-level xapp-... token for Socket Mode subscriptions:

uxc auth credential set slack-app \
  --auth-type bearer \
  --secret-env SLACK_APP_TOKEN

Invoke it explicitly with --auth slack-app when using --transport slack-socket-mode.

Read Examples

# Confirm token identity and workspace
slack-openapi-cli get:/auth.test

# List candidate channels
slack-openapi-cli get:/conversations.list limit=20 types=public_channel,private_channel

# Inspect one conversation
slack-openapi-cli get:/conversations.info channel=C1234567890

# Read recent history
slack-openapi-cli get:/conversations.history channel=C1234567890 limit=20

# Read thread replies
slack-openapi-cli --auth slack-user get:/conversations.replies channel=C1234567890 ts=1717171717.000100

Write Examples (Confirm Intent First)

# Post a channel message
slack-openapi-cli post:/chat.postMessage '{"channel":"C1234567890","text":"Hello from UXC"}'

# Post a thread reply
slack-openapi-cli post:/chat.postMessage '{"channel":"C1234567890","text":"Reply from UXC","thread_ts":"1717171717.000100"}'

# Add a reaction to a message
slack-openapi-cli post:/reactions.add '{"channel":"C1234567890","timestamp":"1717171717.000100","name":"thumbsup"}'

Socket Mode Subscribe

# Start Slack Socket Mode using an app-level xapp token.
# The runtime will call apps.connections.open automatically.
uxc subscribe start https://slack.com/api \
  --transport slack-socket-mode \
  --auth slack-app \
  --sink file:$HOME/.uxc/subscriptions/slack-socket-mode.ndjson

# Inspect job state
uxc subscribe list
uxc subscribe status sub_123

# Stop the background job
uxc subscribe stop sub_123

Current validation level:

Fallback Equivalence