timabell / tfsslackbot

A slack bot for TFS.

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.

Installation

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

• <client token="" />
  • Put your slack bot integration token into the token attribute.
• <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

• People new to GitHub should consider using GitHub for Windows.
• If you decide not to use GHFW you will need to set up Git and connect to GitHub.
• Fork the TFS Slack Bot repository.
• Finally you should look into git - the simple guide.

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.