Skip to content

timabell/tfsslackbot

Repository files navigation

Tim's fork

This fork provides support for Visual Studio Team Services (VSTS, formerly VSO / Visual Studio Online)

Download binaries from the releases page

TFS Slack Bot

A quick and dirty TFS Slack bot. Its quite rushed as it was done between work. It does, however, get the job done.

Screenshot

Installation

Open up SlackBotService.exe.config and make the following edits:

  • <client token="" />
  • <add name="tfs" projectCollection="" project="" accessToekn=""/>
    • Put your project collection into the projectCollection attribute: (e.g. http://mytfs:8080/tfs/MyCollection)
    • Fill in the project attribute.
    • Get a Personal Access Token and fill that in. (This is currently the only auth method that this bot supports)

Open up an elevated command prompt and cd to the directory, then run:

installutil /i slackbotservice.exe
net start slackbotservice

Make sure you use an account with access to TFS for the service account. Keep an eye on the Windows event log the first time you run it: it will report status and errors there. Invite your bot to a room and type in a TFS item (e.g. tfs123456).

Note that when installutil prompts for the username you need to put .\username (more info)

This stuff is beyond alpha so you may need to restart it from time to time.

Contributing

Getting started with Git and GitHub

Rules for Our Git Repository

  • We're here to have fun.
    • Seriously, have fun.
    • Check out the Code of Conduct.
    • No matter how small a contribution is, or how much work it needs, we are grateful.
  • The coding standards aren't strict at all, but when in Rome be a Roman: take a look at how the code is written and try to stick to that.
    • Just one thing: 4 spaces, not tabs.

License

TFS Slack Bot is licensed under the MIT license, which can be found in LICENSE.

Additional Restrictions

  • We only accept code that is compatible with the MIT license.
  • Copying copy-left (e.g. GPL) code is strictly forbidden.