Pull Request review reminders for MSFT Teams & GitHub

Set the minimum number of reviews needed and ignore head branches by prefix/label.

Sign up for the beta to get access to the Mariachi Docker container.

Beta

How It Works

1

Step 1 - Create an Incoming Webhook Connector in your MSFT Teams channel.

Follow these instructions (pasted below) from MSFT for adding a connector to your channel. You'll need the URL you create in the next step.

  • ∙ Navigate to the channel where you want to add the webhook and select (•••) More Options from the top navigation bar.
  • ∙ Choose Connectors from the drop-down menu and search for Incoming Webhook.
  • ∙ Select the Configure button, provide a name (Mariachi), and, optionally, upload an image avatar for your webhook.
  • ∙ The dialog window will present a unique URL that will map to the channel. Make sure that you copy and save the URL—you will need to add it to your mariachi.yml file in the next step.
    • ∙ Eg: https://outlook.office.com/webhook/{string}/IncomingWebhook/{string}
  • ∙ Select the Done button. The webhook will be available in the team channel.

2

Step 2 - Add a mariachi.yml file to your repo's workflows

  name: Mariachi
  on:
  schedule:
    - cron: "0 13 * * *" # run every morning (time in GMT)
  jobs:
    remind:
      runs-on: ubuntu-latest
      steps:
      - name: Mariachi
      uses: **********  # request access to get Mariachi Docker
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          teams_url: ${{ secrets.TEAMS_TOKEN }} # your Teams URL from step 1
          exclude_heads: release,test # optional
          exclude_labels: do-not-review,skip-mariachi # optional
          min_reviews: 3 # optional, defaults to 2

3

Step 3 - Get reminders

Mariachi is in Beta

Send an email to beta@mariachi.app if you'd like to try it.