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

Octotask 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. Octotask uses its internal event emitter to perform actions based on those events. A simple Octotask App might look like this:

export default (app) => {
  app.on("issues.opened", async (context) => {
    const issueComment = context.issue({
      body: "Thanks for opening this issue!",
    });
    return context.octokit.issues.createComment(issueComment);
  });

  app.onAny(async (context) => {
    context.log.info({ event: context.name, action: context.payload.action });
  });

  app.onError(async (error) => {
    app.log.error(error);
  });
};

Building a Octotask App

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

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

Contributing

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

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

Want to discuss with Octotask users and contributors? Discuss on GitHub!

Ideas

Have an idea for a cool new GitHub App (built with Octotask)? 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 octotask/ideas repository!