Home

SmokeDetector is a headless chatbot that detects spam and posts it to chatrooms.
It uses ChatExchange and takes questions from the Stack Exchange realtime tab. For more information on how it works, see our website at charcoal-se.org.

---

User information

• You can find a list of SmokeDetector's commands on the commands page.

• Find a list of chatrooms that SmokeDetector interacts with on the chat rooms page.

• If you're thinking about asking for privileges, take a look at the privileges page.

• To find out what's expected of members of Charcoal, check out our code of conduct

• If you're looking for guidance on feeding back to SmokeDetector, read the feedback guidance.

• If you want to know when it is appropriate to blacklist or watch something, check out the guidance for blacklisting and watching.

Developer information

• For information on how to write a new check for spam, see the documentation for creating new spam checks.

• For information on how to write a new Smokey command, see the documentation for creating new commands.

• If you wish to integrate with Smokey and Metasmoke via our API, see the API docs.

• For information on our build process, see Build Infrastructure.

---

Glossary:

• User Blacklist - list of users (identified by site + ID) whose every question or answer will be posted to the appropriate chatrooms. This should be used only for spammers or for users whose posts merit abusive/offensive flags. This list is stored locally on every SmokeDetector instance, and is not carried between failovers.

• User Whitelist - list of users which are free from username checks on their posts. Title and body will still be checked. This list is stored locally on every SmokeDetector instance, and is not carried between failovers.

• Username Blacklist - list of username regexes which will be checked against the user's username, and trigger a report if matching. The list can be found here, and is shared between all Smokey instances.