Go to file

Jamie Jones 828deba2e8 remove deprecated integration id Integration id was set to be removed in 0.7. We're past that version, so cleaning up the deprecated option.		2017-08-05 13:45:05 -04:00
.github	Create config.yml	2017-07-31 15:13:41 -07:00
bin	remove deprecated integration id	2017-08-05 13:45:05 -04:00
docs	Update docs	2017-08-01 22:42:23 -05:00
lib	Update API docs for `context.config`	2017-08-04 11:32:01 -05:00
script	Fix script for publishing docs	2017-07-27 11:32:21 -05:00
test	Merge pull request #183 from probot/express	2017-08-03 20:06:39 -05:00
.editorconfig	Add editorconfig	2016-09-16 11:45:59 -07:00
.env.example	Update name from "GitHub Integrations" to "GitHub Apps"	2017-06-05 21:11:08 -05:00
.gitignore	Merge remote-tracking branch 'origin/master' into jsdoc	2017-04-29 09:29:01 -05:00
.jsdoc.json	Use plugin docs as readme	2017-04-29 10:26:47 -05:00
.travis.yml	Remove env variables	2017-03-27 22:22:59 -05:00
CHANGELOG.md	Publish docs after publishing package	2017-07-27 11:16:36 -05:00
CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md	2017-04-06 18:49:20 -05:00
LICENSE	Update LICENSE	2017-07-16 16:41:12 -07:00
README.md	Update name from "GitHub Integrations" to "GitHub Apps"	2017-06-05 21:11:08 -05:00
app.json	Update name from "GitHub Integrations" to "GitHub Apps"	2017-06-05 21:11:08 -05:00
index.js	Fixes loading pluigns on the express branch	2017-08-03 19:15:54 -05:00
package-lock.json	Use express for http server	2017-08-01 14:12:09 -05:00
package.json	Use express for http server	2017-08-01 14:12:09 -05:00

README.md

Probot

Probot is a bot framework for GitHub. It's like Hubot, but for GitHub instead of chat.

If you've ever thought, "wouldn't it be cool if GitHub could…"; imma stop you right there. Most features can actually be added via GitHub Apps, which extend GitHub and can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. Apps are first class actors within GitHub.

There are some great services that offer apps in the GitHub Marketplace, and you can build a bunch of really cool things yourself. Probot aims to make that easy.

Plugins

Bots are implemented as plugins, which are easy to write, deploy, and share. Here are just a few examples of things probot can do:

stale - closes abandoned issues after a period of inactivity.
owners - @mentions people in Pull Requests based on contents of the OWNERS file
configurer - syncs repository settings defined in .github/config.yml to GitHub, enabling Pull Requests for repository settings.

Check out all probot plugins.

Contributing

Most of the interesting things are built with plugins, so consider starting by writing a new plugin or improving one of the existing ones.