🤖 A framework for building GitHub Apps to automate and improve your workflow
TypeScript JavaScript HTML Shell
Clone or download
tcbyrd Add environment variable option to provide a base64 encoded key (#624)
* check for base64 in the PRIVATE_KEY variable

* Update private_key config documentation

* Link to deployment docs for private key usage
Latest commit 59f924e Aug 10, 2018
Permalink
Failed to load latest commit information.
.github Create CODEOWNERS (#628) Jul 17, 2018
bin Remove all remnants of localtunnel (#644) Aug 3, 2018
docs Add environment variable option to provide a base64 encoded key (#624) Aug 10, 2018
script chore: Replace jsdoc with typedoc (#583) Jun 26, 2018
src Add environment variable option to provide a base64 encoded key (#624) Aug 10, 2018
static chore: Add icon to title of probot (#483) Apr 5, 2018
test Add environment variable option to provide a base64 encoded key (#624) Aug 10, 2018
views chore: Add icon to title of probot (#483) Apr 5, 2018
.editorconfig Add editorconfig Sep 16, 2016
.gitignore chore: Rewrite core in Typescript (#372) May 25, 2018
.travis.yml chore: Rewrite core in Typescript (#372) May 25, 2018
.typedoc.json chore: Replace jsdoc with typedoc (#583) Jun 26, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Apr 6, 2017
CONTRIBUTING.md Add some documentation about TS to README and CONTRIBUTING (#590) Jun 28, 2018
LICENSE docs: suggested changes from audit #522 (#523) May 13, 2018
README.md Add some documentation about TS to README and CONTRIBUTING (#590) Jun 28, 2018
app.json pro the bot Aug 30, 2017
appveyor.yml chore: Setup Appveyor (#334) Nov 20, 2017
codecov.yml chore: Disable codecov comments (#543) May 23, 2018
package.json Add environment variable option to provide a base64 encoded key (#624) Aug 10, 2018
tsconfig.json chore: Turn on esModuleInterop for TypeScript (#564) Jun 11, 2018
tslint.json chore(test): Convert github tests to TypeScript (#625) Jul 18, 2018

README.md

Probot

npm version

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

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!