ContextThread uses Slack's Real-Time Search API to mine your entire workspace history at the exact moment of an incident, synthesizing past solutions to resolve current downtime faster.
Slack Agent Builder Challenge
When production goes down, the on-call engineer drops everything to investigate. Often, the exact same issue occurred 4 months ago, solved by a different team member in a completely different channel. Because that knowledge is lost in the noise of Slack, the engineer spends 2 hours debugging an issue that should have taken 5 minutes.
ContextThread surfaces institutional knowledge exactly when it's needed.
- Trigger: An engineer reacts with 📌 (
pushpin) on an incident alert. - Search: The agent uses the Slack Real-Time Search (RTS) API to hunt for similar error codes and service names across all historical channels.
- Synthesis: Claude 3.5 Sonnet synthesizes the current thread and the historical matches into a unified Incident Manifest.
- Resolution: ContextThread uses Slack Web API methods to generate a fully formatted Slack Canvas (for root cause analysis and patterns) and a Slack List (for action items), then posts the links directly in the thread.
- Historical Mining: Leverages Slack RTS via
assistant.search.contextto find identical past incidents, with a legacysearch.messagesfallback for older sandboxes. - Canvas & Lists automation: Automatically provisions rich Canvas documents and actionable Lists through Slack's Web API, eliminating manual documentation during a crisis.
- Recurring Pattern Alerts: Automatically escalates the issue to an
#incidents-patternschannel if the same error class has occurred 3+ times. - Dynamic Fallbacks: If API rate limits are hit or the workspace does not support Canvas/Lists APIs, the agent seamlessly degrades to posting a formatted Block Kit message.
| Layer | Technology |
|---|---|
| Framework | @slack/bolt v4 |
| Language | TypeScript |
| Runtime | Node.js |
| AI | Claude 3.5 Sonnet (@anthropic-ai/sdk) |
| Search | Slack Real-Time Search API (assistant.search.context) |
| Slack Primitives | Canvas (canvases:write), Lists (lists:write) |
- Node.js 20+
- A Slack workspace
- AI provider key (Gemini, Anthropic, OpenAI, or OpenRouter)
- Slack user token with RTS search scopes for full workspace search
# Clone the repository
cd contextthread
npm install
# Configure environment
cp .env.example .env
# Edit .env with your SLACK_BOT_TOKEN, SLACK_APP_TOKEN, and ANTHROPIC_API_KEY
# Start the agent in Socket Mode
npm run dev- Post a fake database timeout error in a channel.
- React to it with 📌.
- Watch ContextThread fetch context, synthesize the RCA, and post your Canvas and Action List.
ContextThread operates entirely on-demand via the reaction_added event. It only reads the specific thread it is invoked upon and searches workspace history safely via Slack's native Search APIs, ensuring data never leaks outside the boundaries of your organizational permissions.
ContextThread supports Vercel Hobby without an always-running server. See docs/VERCEL_FREE_DEPLOYMENT.md for environment variables and Slack URL changes.
Built for the Slack Agent Builder Challenge