CLI tools to help facilitate semantic versioning based on GitHub PR labels

Usage no npm install needed!

<script type="module">
  import autoReleaseCli from '';



Generate releases based on semantic version labels on pull requests

CircleCI Codecov npm All Contributors npm Auto Release code style: prettier

CI/CD helpers for github releases. Generate releases based on semantic version labels on pull requests.

Release Features:

  • Release every merge to master based on a PR labels
  • Skip a release with the skip-release label
  • Generate a changelog with fancy headers, authors, and monorepo package association
  • Generate a GitHub release

Pull Request Interaction Features:

  • Get the labels for a PR
  • Set the status of a PR
  • Check that a pull request has a SemVer label
  • Comment on a PR with markdown

Visit the docs for more information.

Start Developing

To get set up, fork and clone the project and run the following command:

brew install automake


yarn lint


yarn test


yarn build

Run the docs

To deploy the docs you will need to add the documentation label to your pull request.

yarn docs:watch


Feel free to make and issue or open a pull request!

Make sure to read our code of conduct.

:rocket: Projects Using auto-release :rocket:

:star: webpack-inject-plugin - A webpack plugin to dynamically inject code into the bundle.

:star: storybook-addon-notes-github-markdown-css - Make your notes addon look like github markdown.

:star: html-webpack-insert-text-plugin - Insert text into the head or body of your HTML

:star: react-glider - A react wrapper for glider.js

:star: Ignite - Modern markdown documentation generator

:star: reaction - Artsy’s React Components

:nail_care: auto-release Badge :nail_care:

Do you project use auto-release? Then use our custom badge!

Auto Release

Auto Release

Auto Release

Auto Release

:art: Prior Art :art:

auto-release is inspired by some excellent tech that came before it.


Thanks goes to these wonderful people (emoji key):

Adam Dierkens
Adam Dierkens

πŸ’» πŸ“– πŸ€” ⚠️
Andrew Lisowski
Andrew Lisowski

πŸ’» πŸ“– πŸ€” πŸš‡ ⚠️


Justin Bennett
Justin Bennett

πŸ› πŸ’»
Alec Larson
Alec Larson


This project follows the all-contributors specification. Contributions of any kind welcome!

Adding a Contributor

To add a contributor run yarn contributors:add, choose "Add new contributor or edit contribution type" and follow the prompts.