Skip to content

trysurface/bugsniffer

Repository files navigation

🐛 bugsniffer

AI-powered Slack bot that sniffs out bug reports from a feedback channel and auto-creates Notion tickets — so your team can stop playing ticket secretary.

How it works

  1. Watches #surface_product_feedback in Slack (via Socket Mode — always on, no webhooks)
  2. Sends each new message to Claude to classify: is it a bug? is there enough detail?
  3. If yes → creates a ticket in the Notion Bug Tracker with title, status, and a link back to the Slack thread
  4. Posts a :bug: confirmation reply in-thread

Feature requests, design feedback, and vague "stuff is broken" messages get ignored.

Setup

Prerequisites

  • A Slack App with Socket Mode enabled (setup guide)
    • Bot scopes: channels:history, channels:read, chat:write
    • Event subscription: message.channels
    • App-level token scope: connections:write
  • A Notion integration with access to your bug tracker database (create one)
  • An Anthropic API key (get one)

Environment variables

SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
NOTION_API_KEY=ntn_...
ANTHROPIC_API_KEY=sk-ant-...

Run locally

cp .env.example .env  # fill in your tokens
npm install
npm run dev

Deploy to Railway

  1. Push to GitHub
  2. Create a Railway project → Deploy from GitHub
  3. Add env vars in the Railway dashboard
  4. Done — it auto-deploys on push

Tech

TypeScript · Node.js · Slack Bolt · Notion SDK · Anthropic SDK · Railway

License

MIT

About

Background service that monitors Slack for bug reports and creates Notion tickets

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors