mochiko

0.4.6 • Public • Published

mochiko

An automated GitHub issues generator for new projects.

This tool helps teams bootstrap new GitHub repositories by generating a standard set of issues to track a project's progress.

The current set of issues is heavily influenced by the Humaan Website Checklist.

Installation

  1. Add mochiko to your project's development dependencies.

    yarn add mochiko --dev
  2. Add a script to your project's package.json.

    // package.json
    // ...
    
    "scripts": {
      // ...
      "mochiko": "mochiko",
      // ...
    },
    
    // ...

Usage

All calls to mochiko require a GitHub username and personal access token.

yarn mochiko -- -u <username> -t <personal_access_token>

Note: The following examples exclude the -u and -t parameters for conciseness, but they are required for all calls.

List all options

Use the --help flag to see all available options.

yarn mochiko -- --help

Dry runs

You may perform a "dry-run" to see what issues would be created without sending any create issue requests.

yarn mochiko -- --dry-run

Examples

  • Create all issues

    yarn mochiko
  • Create specific issues

    Provide a list of templates using -f:

    yarn mochiko -- -f 01-content 03-social

Creating new issues

Note: There is currently not a way to load custom issues. You can, however, explicitly define which issues are loaded (see above for an example).

Issues are created using Markdown files with relevant frontmatter.

Frontmatter options

Key Description
title Title of the issue.
labels Array of labels to add to the issue.
assignees Array of assignee usernames.
milestone Milestone number to associate with the issue.

A standard mochiko label is created during script execution. It is not added to an issue by default, but including it is recommended.

Readme

Keywords

Package Sidebar

Install

npm i mochiko

Weekly Downloads

1

Version

0.4.6

License

MIT

Last publish

Collaborators

  • angeloashmore