Go to file
Gregor Martynus 7768a970f9 build(package): lock file 2019-11-04 22:00:03 -08:00
.github chore: Create issue_label_bot.yaml (#913) 2019-04-13 11:17:38 -04:00
bin feat: standalone run command (#751) 2019-03-08 11:17:52 -08:00
docs docs: remove GitHub Actions deployment documentation (#1038) 2019-10-12 14:59:59 -07:00
script chore: Replace jsdoc with typedoc (#583) 2018-06-26 18:02:59 -05:00
src fix: Correctly retry requests after hitting rate or abuse limits 2019-10-30 15:26:24 -07:00
static chore: Add icon to title of probot (#483) 2018-04-05 13:59:44 -05:00
test fix: Use return value of `this` instead of a class (#1060) 2019-11-01 19:27:26 -07:00
views fix: Spelling (#800) 2019-01-03 12:15:02 -05:00
.editorconfig Add editorconfig 2016-09-16 11:45:59 -07:00
.gitignore build: package lock file (#791) 2018-12-18 10:02:30 -08:00
.travis.yml ci(travis): semantic-release setup 2019-01-18 17:18:39 -08:00
.typedoc.json chore: Replace jsdoc with typedoc (#583) 2018-06-26 18:02:59 -05:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2017-04-06 18:49:20 -05:00
CONTRIBUTING.md docs(CONTRIBUTING): 🏗 Probot v8 beta 2019-03-08 10:00:43 -08:00
LICENSE Update year to 2019 (#812) 2019-01-05 22:10:56 -05:00
README.md docs(README): remove npm `@next` badge 2019-03-08 11:33:34 -08:00
README.pt-br.md Create README.pt-br.md (#711) 2018-10-10 01:08:01 -04:00
app.json pro the bot 2017-08-29 23:38:51 -05:00
appveyor.yml chore: Setup Appveyor (#334) 2017-11-19 23:57:37 -05:00
codecov.yml chore: Disable codecov comments (#543) 2018-05-22 22:41:44 -07:00
package-lock.json build(package): lock file 2019-11-04 22:00:03 -08:00
package.json build(package): downgrade semantic-relaese to stable version 2019-11-04 22:00:03 -08:00
tsconfig.json build(package): update typescript to 2.9 (#886) 2019-03-12 15:15:54 -07:00
tslint.json chore(test): Convert github tests to TypeScript (#625) 2018-07-17 23:02:07 -05:00

README.md

Probot's logo, a cartoon robot

Probot

A framework for building GitHub Apps to automate and improve your workflow

npm Build Status Codecov @ProbotTheRobot on Twitter Pull Reminders


If you've ever thought, "wouldn't it be cool if GitHub could…"; I'm going to 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.

How it works

Probot is a framework for building GitHub Apps in Node.js, written in TypeScript. GitHub Apps can listen to webhook events sent by a repository or organization. Probot uses its internal event emitter to perform actions based on those events. A simple Probot App might look like this:

module.exports = (app) => {
  app.on('issues.opened', async context => {
    const issueComment = context.issue({ body: 'Thanks for opening this issue!' })
    return context.github.issues.createComment(issueComment)
  })
}

Building a Probot App

If you've landed in this GitHub repository and are looking to start building your own Probot App, look no further than probot.github.io! The Probot website contains our extensive getting started documentation and will guide you through the set up process.

This repository hosts the code for the npm Probot package which is what all Probot Apps run on. Most folks who land in this repository are likely looking to get started building their own app.

Contributing

Probot is built by people just like you! Most of the interesting things are built with Probot, so consider starting by writing a new app or improving one of the existing ones.

If you're interested in contributing to Probot itself, check out our contributing docs to get started.

Want to chat with Probot users and contributors? Join us in Slack!

Ideas

Have an idea for a cool new GitHub App (built with Probot)? That's great! If you want feedback, help, or just to share it with the world you can do so by creating an issue in the probot/ideas repository!