You are browsing a read-only backup copy of Wikitech. The live site can be found at


From Wikitech-static
Jump to navigation Jump to search
Toolforge tools
Crystal Clear app package utilities.png asanack-bot
Description A Foundation's internal tool for Asana & Slack Integration
Keywords asana, slack, python
Author(s) Samuel (WMF)
Maintainer(s) NahidSultan (WMF) and JSutherland (WMF) (View all)
Source code Gitlab
License MIT License



To manage the tool, you'll need:

  1. a Wikimedia Developer Account. Please create one by following the instructions on Help:Create a Wikimedia developer account.
  2. to be a maintainer of the asanack-bot. Please reach out to the Trust & Safety team to request maintainer privilege.


$ ssh <USERNAME>
$ become asanack-bot

Update or stop the bot

# Update bot to latest version
$ ./ update

# Stop the bot
$ ./ stop

# Restart the bot
$ ./ restart

Change bot parameters

Parameters such as the Slack channel ID or Asana project ID are defined in an environment file .env only accessible to maintainers.

After logging into the server, one can apply the desired change through the command line editor

# Edit .env file
$ vi www/python/src/.env

After making the appropriate changes, it is important to restart the bot for changes to take effect.

# Restart the bot
$ ./ restart