https://github.com/ramongebben/mergify

A very small cli for looking at Gitlab merge requests
https://github.com/ramongebben/mergify

cli gitlab gitlab-cli merge-request

Last synced: 12 months ago
JSON representation

A very small cli for looking at Gitlab merge requests

• Host: GitHub
• URL: https://github.com/ramongebben/mergify
• Owner: RamonGebben
• License: mit
• Created: 2018-03-29T11:37:01.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-03-07T08:26:20.000Z (about 3 years ago)
• Last Synced: 2025-04-10T00:46:39.113Z (12 months ago)
• Topics: cli, gitlab, gitlab-cli, merge-request
• Language: JavaScript
• Homepage: http://ra-ge.net/mergify/
• Size: 1.24 MB
• Stars: 4
• Watchers: 3
• Forks: 1
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Mergify

A very simple cli to check merge requests on Gitlab.

![npm](http://img.shields.io/npm/v/@pindakaasman/mergify.svg)

[![Build Status](https://travis-ci.org/RamonGebben/mergify.svg?branch=master)](https://travis-ci.org/RamonGebben/mergify)

[![Coverage Status](https://coveralls.io/repos/github/RamonGebben/mergify/badge.svg?branch=master)](https://coveralls.io/github/RamonGebben/mergify?branch=master)

[![Known Vulnerabilities](https://snyk.io/test/npm/@pindakaasman/mergify/badge.svg)](https://snyk.io/test/npm/@pindakaasman/mergify)

## Install

```

yarn global add @pindakaasman/mergify

```

## Usage

Just grab up the help menu by using `mergify --help` and you will be presented with the help dialog.

```

  Usage: mergify [options]

  Options:

    -V, --version   output the version number

    -a --assigned   Get all open merge request assigned to you

    -s --submitted  Get all open merge request submitted to you

    -c --configure  Setup or update required config

    -v --verify     Verify your config is correct

    -h, --help      output usage information

```

## Configure

To complete setup you will need to run the `configure` command to provide access to the Gitlab API.

```

mergify --configure

```

### Finding your userid

You Gitlab `userid` is **not** your `username`!

You can find your `userid` by going to [the profile page](https://gitlab.com/profile).

It will be located on the right.

![Example of userid](https://user-images.githubusercontent.com/921666/38989234-6d7ff064-43d6-11e8-8758-f90bddf7dbe5.png)

### Getting a Gitlab access token

Complete documentation on how to get a private token can be [found at Gitlab](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html).

You will need to go to you [access tokens page](https://gitlab.com/profile/personal_access_tokens) and provide at least **api** access.

See Screenshot for an example of access token creation  :