configure

/slack-bridge:configure — Slack Channel Setup

Writes the bot and app tokens to ~/.claude/channels/slack/.env and orients the user on access policy. The server reads this file at boot.

Arguments passed: $ARGUMENTS

---

Dispatch on arguments

No args — status and guidance

Read both state files and give the user a complete picture:

1. Tokens — check ~/.claude/channels/slack/.env for SLACK_BOT_TOKEN and SLACK_APP_TOKEN. Show set/not-set; if set, show first 10 chars masked.

2. Access — read ~/.claude/channels/slack/access.json (missing = defaults). Show: dmPolicy, allowed senders count and list, pending pairings.

3. What next — concrete next step:

   • No tokens → show the Slack App setup guide below
   • Tokens set, nobody allowed → "DM your bot on Slack. Approve with /slack-bridge:access pair <code>."
   • Tokens set, someone allowed → "Ready. DM your bot to reach the assistant."

Push toward lockdown. Once the allowlist is set, offer to flip to allowlist policy.

---

<bot-token> <app-token> — save tokens

1. Split $ARGUMENTS — first is SLACK_BOT_TOKEN, second is SLACK_APP_TOKEN.
2. Warn if prefixes don't match xoxb- / xapp-.
3. mkdir -p ~/.claude/channels/slack
4. Read existing .env, update/add both lines, preserve other keys. Write back.
5. chmod 600 ~/.claude/channels/slack/.env
6. Show no-args status after saving.
7. Note: restart required for token changes (/reload-plugins).

clear — remove tokens

Delete both token lines (or the file if that's all it contains).

---

Slack App Setup Guide

Show this when tokens are not set:

To create a Slack bot:

1. Go to https://api.slack.com/apps → "Create New App" → "From scratch"

2. Left sidebar → "Socket Mode" → Enable Socket Mode
   Generate an App-Level Token with scope: connections:write
   Copy it — this is your SLACK_APP_TOKEN (starts with xapp-)

3. Left sidebar → "OAuth & Permissions" → "Bot Token Scopes" → Add:
     chat:write, reactions:write, im:history, im:write,
     channels:history, groups:history, files:read, files:write, users:read

4. Left sidebar → "Event Subscriptions" → Enable Events → Subscribe to:
     message.im, message.channels, message.groups, app_mention

5. Left sidebar → "Install App" → "Install to Workspace" → Allow
   Copy the Bot User OAuth Token — this is your SLACK_BOT_TOKEN (starts with xoxb-)

6. Run: /slack-bridge:configure xoxb-... xapp-...