probot/README.md

PRobot

NOTE: this REAME is aspirational, and the project name is guaranteed to change.

PRobot is a trainable robot that responds to activity on GitHub. It's like Hubot, but for GitHub events instead of chat messages.

Automatically welcome first-time contributors, @mention previous authors, or close stale pull requests with pre-built behaviors. Write your own behaviors to implement whatever workflow your project needs.

Why?

Almost any workflow or process you can imagine can be added to GitHub with webhooks, the API, and now Integrations. But adding that workflow usually involves writing a lot of code to integrate with GitHub, and a tiny bit of code to implement the behavior you want. This project aims to be a generic bot for building integrations with GitHub.

The functionality of all of these awesome bots could be ported to behaviors:

• highfive - GitHub hooks to provide an encouraging atmosphere for new contributors
• Homu - A bot that integrates with GitHub and your favorite continuous integration service
• mention-bot - Automatically mention potential reviewers on pull requests.
• PullAprove
• LGTM
• Know of other examples? Add them here…

Here are some behaviors that we plan to implement:

• Auto-responder for new issues and pull requests
• Welcome new contributors
• Auto close stale PRs
• @mention OWNERS based on modified files
• "Based on recent activity, expect a response in X days"

Creating a behavior

robot.on('pull', function(event) {
  robot.comment("Thanks for the pull request! We'll review it within 72 hours!");
});