1.4.1 • Public • Published

Delete merged branch

Build Status Want to see more badges? Click here!

Want to run this app with GitHub Actions? Click here

A GitHub app built with Probot that automatically deletes a branch after it's merged. That's it, enjoy!

🔔 Wait, do you really need this? 🔔

You may not need this app as GitHub recently added this feature natively to their platform. It allows you to automatically delete the head branch after a merge. If you need more advanced controls and configuration settings, this app is still well suited for the job.

Running it locally

  1. First, follow these instructions for making your own GitHub app.

    1. Give your app the following permissions:
      • Repository contents: Read & Write.
      • Pull requests: Read
    2. And Subscribe to the following events
      • Pull Request
  2. Then, clone the repo:

git clone
  1. Copy .env.example to .env and set the right environment variables as here

  2. Now, install app dependencies and run it:

# Install dependencies 
npm install
# Run the bot 
npm start

Running with Docker

  1. Make sure you have docker installed.

  2. Follow the same steps as running locally to set up the GitHub app and environment files.

  3. Build the docker image:

    docker build -t delete-merged-branch .
  4. Run the docker image:

    docker run -i -t --rm \
        -v "$(pwd)/.env:/app/.env" \
        -p 3000:3000 \

Alternate Example: Running test in the docker image

docker run -i -t --rm \
    -v "$(pwd)/.env:/app/.env" \
    -v "$(pwd)/sample-data:/sample-data" \
    delete-merged-branch \
        receive /app/index.js -p /sample-data/event.json

How it works

This GitHub app listens to the pull_request.closed webhook. If a pull request is closed and the connected branch is merged, it will delete the branch.


The optional app configuration YAML file should be saved as .github/delete-merged-branch-config.yml. At the moment it supports the following options:

  • exclude (array) - list of branches that should not be automatically deleted after a merge. Wildcards supported.
  • delete_closed_pr (bool) whether or not a branch should be deleted if PR is closed without merging

Example .github/delete-merged-branch-config.yml:

  - development
  - qa
  - feature-*
delete_closed_pr: true

Release process

CI (Travis) is in charge of releasing new versions of the GitHub Application to Now. On every new commit to master we run semantic-release to determine whether the major/minor/patch version should be incremented. If so, we update the version running in production.

Running in GitHub actions

This app is compatible with GitHub Actions. You need to create a workflow that is triggered on the pull_request event for this. Then, you use this repo for the action. (SvanBoxel/delete-merged-branch@master). Don't forget to check the GITHUB_TOKEN secret. That's it.

Delete merged branch action


If you have suggestions for how this GitHub app could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the Contributing Guide.


ISC © 2018 Sebass van Boxel


Build Status codecov Uptime Robot ratio (30 days) Greenkeeper badge Project maintainability npm version

Package Sidebar


npm i delete-merged-branch

Weekly Downloads






Unpacked Size

52.8 kB

Total Files


Last publish


  • svanboxel