Skip to content


Subversion checkout URL

You can clone with
Download ZIP
JavaScript Shell
Branch: master


latest commit 307bd07162
@rlemon rlemon authored

For usage info, on how to use the bot, see here.

Running the bot

The bot is currently a big dangle-on script running in your browser. Run bookmarklet.js in your browser to get it up an' running. For some tips on handling the bot, see Bot Handling.

If you wish, you can also run it headlessly on top of phantomjs and node:

  • Install phantomjs 2 (yes, it has to be 2 and above). Differs from platform to platform.
  • Install nightmare: npm install nightmare
  • Edit your credentials into run-headless.js
  • Hit the road: env DEBUG=nightmare node run-headless.js


#one must first get the repo
$ git clone
$ cd SO-ChatBot

The provided automagically does building, adds all changed items to commit and publishes for you:

$ ./ commit-message

To build manually:

$ node build.js
#to skip minification
$ node build.js no-min

The result will be in master.js and master.min.js

Minifying will run closure-compiler.jar if java is installed, and then try to run uglify-js2.

The Bot API

(, a very short explanation of a limited subset of)

For a real cover, check the source code or this wiki page or console.log(bot). Should be straightforward.

//add a bot command
    name : 'command_name',
    fun : commandFunction,

    //permissions object (can be ommitted for all-can-use, all-can-del)
    permissions : {
        use : 'NONE' /*or*/ 'ALL' /*or*/ [array of usrids],
        del : 'NONE' /*or*/ 'ALL' /*or*/ [array of usrids]

    //whether the command is asynchronous or not (default false)
    async : true /*or*/ false

//add a listening regex and a corresponding callback
    //regular expression or array of regular expressions

Something went wrong with that request. Please try again.