A bridge service that lets you remotely control Claude Code sessions through Slack threads.

Send a DM or mention the bot, and Claude Code runs on your local machine with results streamed back to the Slack thread. Built on the Anthropic Agent SDK.

• Thread = Session — Each Slack thread maps 1:1 to a Claude Code session. Run multiple independent sessions across threads simultaneously
• Session Management — Start new sessions, switch between sessions, sync local CLI work to Slack
• Working Directory — Global and per-thread working directory settings with auto-detection on session switch
• Live Progress — Elapsed time, context usage (ctx: 45k/200k), and recent tool activity with emoji indicators
• Thread Pause — Freeze threads with !pause/!resume. Missed messages are automatically collected on resume
• Cron Automation — Schedule recurring tasks (e.g. daily morning scrum)
• Question Relay — Claude's AskUserQuestion presented as numbered choices in Slack, with answers forwarded back
• Voice Input — Auto STT transcription on audio/video file upload (OpenAI with Google fallback)
• Security — Slack request signature verification + user whitelist

• Node.js >= 18
• Claude Code CLI installed and authenticated
• Slack Bot Token (Bot User OAuth Token)
• Tunneling for external access (ngrok, etc.)

git clone https://github.com/lucidash/claude-slack-bridge.git
cd claude-slack-bridge
npm install
cp .env.example .env
# Edit .env with your tokens and settings

# Production
npm start

# Development (auto-restart on file changes)
npm run dev

Tunnel with ngrok:

ngrok http 3005

1. Create an app at Slack API
2. OAuth & Permissions — Add Bot Token Scopes:
   • chat:write, im:history, im:read, im:write
   • app_mentions:read, channels:history (for channel mentions)
   • files:read (for voice input)
3. Event Subscriptions — Enable and configure:
   • Request URL: https://<your-url>/slack/events
   • Bot events: message.im, app_mention
4. App Home — Enable Messages Tab + "Allow users to send Slash commands and messages"
5. Install the app to your workspace

src/
├── index.js       # Express server, event handler, Claude execution orchestration
├── claude.js      # Agent SDK query() wrapper, stream parsing, tool callbacks
├── commands.js    # Command handlers (!new, !session, !wd, !cron, etc.)
├── cron.js        # Cron job management and scheduled execution
├── slack.js       # Slack WebClient wrapper, thread history fetching
├── security.js    # Request signature verification, user whitelist
├── store.js       # JSON file-based persistence + session file decoding
└── stt.js         # Speech-to-text (OpenAI / Google fallback)

Session and state data are stored as JSON files in ~/.claude/slack-bridge/:

MIT